Megosztás a következőn keresztül:

ClaimsTransformations

  • Cikk

Megjegyzés

Az Azure Active Directory B2C-ben az egyéni szabályzatok elsősorban összetett forgatókönyvek kezelésére szolgálnak. A legtöbb esetben javasoljuk, hogy beépített felhasználói folyamatokat használjon. Ha még nem tette meg, tekintse meg az egyéni szabályzatok kezdőcsomagját az Egyéni szabályzatok használatának első lépései az Active Directory B2C-ben című témakörben.

A ClaimsTransformations elem a jogcímátalakítási függvények listáját tartalmazza, amelyek egyéni szabályzatok részeként használhatók a felhasználói folyamatokban. A jogcím-átalakítás a megadott jogcímet egy másik jogcímmé alakítja. A jogcímátalakítás során meg kell adnia az átalakítási módszert, például egy elemet egy sztringgyűjteményhez vagy egy sztring kis- és nagybetűinek módosítását.

A felhasználói folyamatokban használható jogcímátalakítási függvények listájának hozzáadásához a házirend BuildingBlocks szakaszában egy ClaimsTransformations XML-elemet kell deklarálni.

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

A ClaimsTransformation elem a következő attribútumokat tartalmazza:

Attribútum Kötelező Leírás
Id Yes A jogcímátalakítás egyedi azonosítására szolgáló azonosító. Az azonosítóra a szabályzat más XML-elemei hivatkoznak.
TransformationMethod Yes A jogcímátalakításban használni kívánt átalakítási módszer. Minden jogcímátalakításnak saját értékei vannak. Az elérhető értékek teljes listájáért tekintse meg a jogcím-átalakítási referenciát .

ClaimsTransformation

A ClaimsTransformation elem a következő elemeket tartalmazza:

<ClaimsTransformation Id="<identifier>" TransformationMethod="<method>">
  <InputClaims>
    ...
  </InputClaims>
  <InputParameters>
    ...
  </InputParameters>
  <OutputClaims>
    ...
  </OutputClaims>
</ClaimsTransformation>
Elem Események Description
InputClaims 0:1 Az InputClaim elemek listája, amelyek olyan jogcímtípusokat adnak meg, amelyeket a jogcímátalakítás bemeneteként vesznek fel. Ezek az elemek a szabályzat JogcímekSchema szakaszában már definiált Jogcímtípusra mutató hivatkozást tartalmaznak.
InputParameters 0:1 A jogcímátalakítás bemeneteként megadott InputParameter-elemek listája.
OutputClaims 0:1 A ClaimsTransformation meghívása után létrehozott jogcímtípusokat meghatározó OutputClaim elemek listája. Ezen elemek mindegyike a ClaimsSchema szakaszban már definiált Jogcímtípusra mutató hivatkozást tartalmaz.

InputClaims

Az InputClaims elem a következő elemet tartalmazza:

Elem Események Description
InputClaim 1:n Egy várt bemeneti jogcímtípus.

InputClaim

Az InputClaim elem a következő attribútumokat tartalmazza:

Attribútum Kötelező Leírás
ClaimTypeReferenceId Yes Hivatkozás a szabályzat ClaimsSchema szakaszában már definiált ClaimType-ra.
TransformationClaimType Yes Egy átalakítási jogcímtípusra hivatkozó azonosító. Minden jogcímátalakításnak saját értékei vannak. Az elérhető értékek teljes listájáért tekintse meg a jogcím-átalakítási referenciát .

InputParameters

Az InputParameters elem a következő elemet tartalmazza:

Elem Események Description
InputParameter 1:n Egy várt bemeneti paraméter.

InputParameter

Attribútum Kötelező Leírás
Id Yes Egy azonosító, amely a jogcím-átalakítási módszer egyik paraméterére hivatkozik. Minden jogcímátalakítási módszer saját értékekkel rendelkezik. Az elérhető értékek teljes listáját a jogcímátalakítási táblázatban találja.
DataType Yes A paraméter adattípusa( például String, Boolean, Int vagy DateTime) az egyéni szabályzat XML-sémájának DataType-számbavétele szerint. Ez a típus aritmetikai műveletek helyes végrehajtására szolgál. Minden jogcímátalakításnak saját értékei vannak. Az elérhető értékek teljes listájáért tekintse meg a jogcím-átalakítási referenciát .
Érték Yes Az átalakításnak szó szerint átadott érték. Egyes értékek tetszőlegesek, némelyiket a jogcím-átalakítási módszerből választhatja ki.

OutputClaims

Az OutputClaims elem a következő elemet tartalmazza:

Elem Események Description
OutputClaim 0:n Egy várt kimeneti jogcímtípus.

OutputClaim

Az OutputClaim elem a következő attribútumokat tartalmazza:

Attribútum Kötelező Leírás
ClaimTypeReferenceId Yes Hivatkozás a szabályzat ClaimsSchema szakaszában már definiált ClaimType-ra.
TransformationClaimType Yes Egy átalakítási jogcímtípusra hivatkozó azonosító. Minden jogcímátalakításnak saját értékei vannak. Az elérhető értékek teljes listájáért tekintse meg a jogcím-átalakítási referenciát .

A jogcímek átalakításához használt bemeneti és kimeneti jogcímeket külön-külön kell megadni. Ugyanaz a bemeneti jogcím nem használható, mint a kimeneti jogcím.

Példa

Tárolhatja például a használati feltételek utolsó verzióját, amelyet a felhasználó elfogadott. Amikor frissíti a szolgáltatási feltételeket, megkérheti a felhasználót, hogy fogadja el az új verziót. A következő példában a HasTOSVersionChanged jogcímátalakítás összehasonlítja a TOSVersion jogcím értékét a LastTOSAcceptedVersion jogcím értékével, majd visszaadja a logikai TOSVersionChanged jogcímet .

<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>

Jogcímátalakítások referenciája

A jogcímátalakítások példáiért tekintse meg a következő referenciaoldalakat: