Sdílet prostřednictvím

Deklarace identityTransformations

Důležité

Od 1. května 2025 už nebude Azure AD B2C k dispozici k nákupu pro nové zákazníky. Další informace najdete v našich nejčastějších dotazech.

Poznámka:

V Azure Active Directory B2C jsou vlastní zásady navržené především pro řešení složitých scénářů. Ve většině scénářů doporučujeme používat integrované toky uživatelů. Pokud jste to neudělali, přečtěte si informace o úvodním balíčku vlastních zásad v tématu Začínáme s vlastními zásadami ve službě Active Directory B2C.

Element ClaimsTransformations obsahuje seznam transformačních funkcí deklarací, které lze použít v cestách uživatele jako součást vlastní zásady. Transformace deklarací identity převede danou deklaraci identity na jinou. V transformaci deklarací identity zadáte metodu transformace, například přidání položky do kolekce řetězců nebo změna velikosti písmen řetězce.

Chcete-li zahrnout seznam transformačních funkcí deklarací identity, které lze použít na cestě uživatele, musí být element ClaimsTransformations XML deklarován v části BuildingBlocks zásady.

<ClaimsTransformations>
  <ClaimsTransformation Id="<identifier>" TransformationMethod="<method>">
    ...
  </ClaimsTransformation>
</ClaimsTransformations>

Element ClaimsTransformation obsahuje následující atributy:

Vlastnost Povinné Popis
identifikační číslo Ano Identifikátor, který se používá k jednoznačné identifikaci transformace deklarace identity. Na identifikátor se odkazuje z jiných elementů XML v zásadě.
TransformaceMethod Ano Transformační metoda, která se má použít v transformaci deklarací. Každá transformace deklarací identity má své vlastní hodnoty. Úplný seznam dostupných hodnot najdete v referenčních informacích k transformaci deklarací identity .

Deklarace identityTransformation

Element ClaimsTransformation obsahuje následující prvky:

<ClaimsTransformation Id="<identifier>" TransformationMethod="<method>">
  <InputClaims>
    ...
  </InputClaims>
  <InputParameters>
    ...
  </InputParameters>
  <OutputClaims>
    ...
  </OutputClaims>
</ClaimsTransformation>
prvek Výskyty Popis
Vstupní deklarace identity 0:1 Seznam elementů InputClaim , které určují typy deklarací identity, které jsou převzaty jako vstup do transformace deklarací. Každý z těchto prvků obsahuje odkaz na ClaimType již definovaný v oddílu ClaimsSchema v zásadě.
Vstupní parametry 0:1 Seznam elementů InputParameter , které jsou poskytovány jako vstup pro transformaci deklarací identity.
Výstupní nároky 0:1 Seznam výstupních elementůClaim , které určují typy deklarací, které jsou vytvořeny po vyvolání ClaimsTransformation. Každý z těchto prvků obsahuje odkaz na ClaimType již definovaný v části ClaimsSchema.

Vstupní deklarace identity

Element InputClaims obsahuje následující prvek:

prvek Výskyty Popis
Vstupní deklarace 1:n Očekávaný typ vstupní deklarace identity.

Vstupní deklarace

Element InputClaim obsahuje následující atributy:

Vlastnost Povinné Popis
IdentifikátorReferenceTypuŽádosti Ano Odkaz na Typ deklarace identity již definovaný v oddílu ClaimsSchema v zásadách.
TransformaceClaimType Ano Identifikátor odkaz na typ deklarace identity transformace. Každá transformace deklarací identity má své vlastní hodnoty. Úplný seznam dostupných hodnot najdete v referenčních informacích k transformaci deklarací identity .

Vstupní parametry

Element InputParameters obsahuje následující prvek:

prvek Výskyty Popis
VstupníParametr 1:n Očekávaný vstupní parametr.

VstupníParametr

Vlastnost Povinné Popis
identifikační číslo Ano Identifikátor, který je odkazem na parametr metody transformace deklarací identity. Každá metoda transformace deklarací identity má své vlastní hodnoty. Úplný seznam dostupných hodnot najdete v tabulce transformací deklarací identity.
datový typ Ano Typ dat parametru, například String, Boolean, Int nebo DateTime podle výčtu DataType ve schématu XML vlastních zásad. Tento typ slouží k správnému provádění aritmetických operací. Každá transformace deklarací identity má své vlastní hodnoty. Úplný seznam dostupných hodnot najdete v referenčních informacích k transformaci deklarací identity .
Hodnota Ano Hodnota předaná doslovné doslovné transformace. Některé z těchto hodnot jsou libovolné, z nichž některé vyberete z metody transformace deklarací identity.

Výstupní nároky

OutputClaims element obsahuje následující prvek:

prvek Výskyty Popis
Výstupní deklarace 0:n Očekávaný výstupní typ deklarace identity.

Výstupní deklarace

Element OutputClaim obsahuje následující atributy:

Vlastnost Povinné Popis
IdentifikátorReferenceTypuŽádosti Ano Odkaz na Typ deklarace identity již definovaný v oddílu ClaimsSchema v zásadách.
TransformaceClaimType Ano Identifikátor odkaz na typ deklarace identity transformace. Každá transformace deklarací identity má své vlastní hodnoty. Úplný seznam dostupných hodnot najdete v referenčních informacích k transformaci deklarací identity .

Vstupní a výstupní deklarace identity používané v transformaci deklarací identity musí být odlišné. Stejnou vstupní deklaraci identity nelze použít jako výstupní deklarace identity.

Příklad

Můžete například uložit poslední verzi vašich podmínek služeb, které uživatel přijal. Když aktualizujete podmínky služeb, můžete uživatele požádat o přijetí nové verze. V následujícím příkladu porovnává transformace deklarací identity HasTOSVersionChanged hodnotu toSVersion deklarace identity s hodnotou LastTOSAcceptedVersion a poté vrátí logickou TOSVersionChanged deklarace identity.

<BuildingBlocks>
  <ClaimsSchema>
    <ClaimType Id="TOSVersionChanged">
      <DisplayName>Indicates if the TOS version accepted by the end user is equal to the current version</DisplayName>
      <DataType>boolean</DataType>
    </ClaimType>
    <ClaimType Id="TOSVersion">
      <DisplayName>TOS version</DisplayName>
      <DataType>string</DataType>
    </ClaimType>
    <ClaimType Id="LastTOSAcceptedVersion">
      <DisplayName>TOS version accepted by the end user</DisplayName>
      <DataType>string</DataType>
    </ClaimType>
  </ClaimsSchema>

  <ClaimsTransformations>
    <ClaimsTransformation Id="HasTOSVersionChanged" TransformationMethod="CompareClaims">
      <InputClaims>
        <InputClaim ClaimTypeReferenceId="TOSVersion" TransformationClaimType="inputClaim1" />
        <InputClaim ClaimTypeReferenceId="LastTOSAcceptedVersion" TransformationClaimType="inputClaim2" />
      </InputClaims>
      <InputParameters>
        <InputParameter Id="operator" DataType="string" Value="NOT EQUAL" />
      </InputParameters>
      <OutputClaims>
        <OutputClaim ClaimTypeReferenceId="TOSVersionChanged" TransformationClaimType="outputClaim" />
      </OutputClaims>
    </ClaimsTransformation>
  </ClaimsTransformations>
</BuildingBlocks>

Referenční informace k transformacím deklarací identity

Příklady transformací deklarací identity najdete na následujících referenčních stránkách: