Jogcímtranszformációk

Fontos

2025. május 1-jére az Azure AD B2C már nem lesz elérhető az új ügyfelek számára. További információ a GYIK-ben.

Megjegyzés:

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

A Jogcímtranszformációk elem a jogcímátalakítási függvények listáját tartalmazza, amelyek egyéni szabályzat 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ímek átalakításánál meg kell adnia az átalakítás módját, például elemet adhat hozzá egy sztringgyűjteményhez, vagy módosíthatja egy sztring esetét.

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

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

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

Jellemző Kötelező Leírás
Azonosító Igen 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.
Transzformációs módszer Igen A jogcímátalakításban használandó átalakítási módszer. Minden jogcímátalakítás saját értékekkel rendelkezik. A rendelkezésre álló értékek teljes listájáért tekintse meg a jogcím-átalakítási referenciát .

Jogcímtranszformáció

A ClaimsTransformation elem a következő elemeket tartalmazza:

<ClaimsTransformation Id="<identifier>" TransformationMethod="<method>">
  <InputClaims>
    ...
  </InputClaims>
  <InputParameters>
    ...
  </InputParameters>
  <OutputClaims>
    ...
  </OutputClaims>
</ClaimsTransformation>
Elem Események Leírás
Bemeneti jogcímek 0:1 A jogcímátalakítás bemeneteként használt jogcímtípusokat meghatározó InputClaim-elemek listája. Mindegyik elem tartalmaz egy, a szabályzat Jogcímekséma szakaszában már definiált Jogcímtípusra mutató hivatkozást.
Bemeneti paraméterek 0:1 A jogcímátalakítás bemeneteként megadott InputParameter-elemek listája.
OutputClaims 0:1 A Jogcímtranszformáció meghívása után létrehozott jogcímtípusokat meghatározó OutputClaim-elemek listája. Ezek az elemek a ClaimsSchema szakaszban már definiált Jogcímtípusra mutató hivatkozást tartalmaznak.

Bemeneti jogcímek

Az InputClaims elem a következő elemet tartalmazza:

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

InputClaim

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

Jellemző Kötelező Leírás
KöveteléstípusHivatkozásAzonosító Igen Hivatkozás a szabályzat ClaimsSchema szakaszában már definiált ClaimType-ra.
TransformationClaimType Igen Átalakítási jogcímtípusra hivatkozó azonosító. Minden jogcímátalakítás saját értékekkel rendelkezik. A rendelkezésre álló értékek teljes listájáért tekintse meg a jogcím-átalakítási referenciát .

Bemeneti paraméterek

Az InputParameters elem a következő elemet tartalmazza:

Elem Események Leírás
BemenetiParaméter 1:n Egy várt bemeneti paraméter.

BemenetiParaméter

Jellemző Kötelező Leírás
Azonosító Igen Olyan 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. A rendelkezésre álló értékek teljes listáját a jogcímek átalakítási táblázatában találja.
Adattípus Igen A paraméter adattípusa( például Sztring, Logikai, Int vagy DateTime) az egyéni szabályzat XML-sémájában szereplő DataType enumerálás szerint. Ez a típus aritmetikai műveletek helyes végrehajtására szolgál. Minden jogcímátalakítás saját értékekkel rendelkezik. A rendelkezésre álló értékek teljes listájáért tekintse meg a jogcím-átalakítási referenciát .
Érték Igen 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 Leírás
OutputClaim 0:n Várt kimeneti jogcímtípus.

OutputClaim

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

Jellemző Kötelező Leírás
KöveteléstípusHivatkozásAzonosító Igen Hivatkozás a szabályzat ClaimsSchema szakaszában már definiált ClaimType-ra.
TransformationClaimType Igen Átalakítási jogcímtípusra hivatkozó azonosító. Minden jogcímátalakítás saját értékekkel rendelkezik. A rendelkezésre álló é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 felhasználó által elfogadott szolgáltatási feltételek utolsó verzióját. A szolgáltatási feltételek frissítésekor 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:

  • Last updated on