Delen via

ClaimsTransformations

Belangrijk

Vanaf 1 mei 2025 is Azure AD B2C niet meer beschikbaar voor nieuwe klanten. Meer informatie vindt u in onze veelgestelde vragen.

Opmerking

In Azure Active Directory B2C is aangepast beleid voornamelijk bedoeld om met complexe scenario's om te gaan. Voor de meeste scenario's wordt aangeraden ingebouwde gebruikersstromen te gebruiken. Als u dit nog niet hebt gedaan, vindt u meer informatie over aangepast beleid in het starterspakket in Aan de slag met aangepaste beleidsregels in Active Directory B2C.

Het element ClaimsTransformations bevat een lijst met claimtransformatiefuncties die kunnen worden gebruikt in gebruikerstrajecten als onderdeel van een aangepast beleid. Een claimtransformatie zet een bepaalde claim om in een andere. In de claimtransformatie geeft u de transformatiemethode op, bijvoorbeeld het toevoegen van een item aan een tekenreeksverzameling of het wijzigen van het hoofdlettergebruik van een tekenreeks.

Als u de lijst met claimtransformatiefuncties wilt opnemen die kunnen worden gebruikt in de gebruikerstrajecten, moet een XML-element ClaimsTransformations worden gedeclareerd onder de sectie BuildingBlocks van het beleid.

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

Het element ClaimsTransformation bevat de volgende kenmerken:

Eigenschap Verplicht Beschrijving
Identiteitsbewijs Ja Een id die wordt gebruikt om de claimtransformatie uniek te identificeren. Er wordt naar de id verwezen vanuit andere XML-elementen in het beleid.
Transformatie Methode Ja De transformatiemethode die moet worden gebruikt in de claimtransformatie. Elke claimtransformatie heeft zijn eigen waarden. Zie de referentie voor claimtransformatie voor een volledige lijst met de beschikbare waarden.

Claims Transformatie

Het element ClaimsTransformation bevat de volgende elementen:

<ClaimsTransformation Id="<identifier>" TransformationMethod="<method>">
  <InputClaims>
    ...
  </InputClaims>
  <InputParameters>
    ...
  </InputParameters>
  <OutputClaims>
    ...
  </OutputClaims>
</ClaimsTransformation>
Onderdeel Instanties Beschrijving
Invoer Claims 0:1 Een lijst met InputClaim-elementen die claimtypen opgeven die worden gebruikt als invoer voor de claimtransformatie. Elk van deze elementen bevat een verwijzing naar een ClaimType dat al is gedefinieerd in de sectie ClaimsSchema in het beleid.
InvoerParameters 0:1 Een lijst met InputParameter-elementen die worden geleverd als invoer voor de claimtransformatie.
Output Claims 0:1 Een lijst met OutputClaim-elementen die claimtypen opgeven die worden geproduceerd nadat de ClaimTransformation is aangeroepen. Elk van deze elementen bevat verwijzingen naar een ClaimType dat al is gedefinieerd in de sectie ClaimsSchema.

Invoer Claims

Het element InputClaims bevat het volgende element:

Onderdeel Instanties Beschrijving
Invoer claimen 1:n Een verwacht invoerclaimtype.

Invoer claimen

Het element InputClaim bevat de volgende kenmerken:

Eigenschap Verplicht Beschrijving
Referentie-id voor claimtype Ja Een verwijzing naar een ClaimType dat al is gedefinieerd in de sectie ClaimsSchema in het beleid.
TransformatieClaimType Ja Een id die verwijst naar een transformatieclaimtype. Elke claimtransformatie heeft zijn eigen waarden. Zie de referentie voor claimtransformatie voor een volledige lijst met de beschikbare waarden.

InvoerParameters

Het element InputParameters bevat het volgende element:

Onderdeel Instanties Beschrijving
Invoerparameter 1:n Een verwachte invoerparameter.

Invoerparameter

Eigenschap Verplicht Beschrijving
Identiteitsbewijs Ja Een id die een verwijzing is naar een parameter van de claimtransformatiemethode. Elke claimtransformatiemethode heeft zijn eigen waarden. Zie de tabel claimtransformatie voor een volledige lijst met de beschikbare waarden.
Gegevenstype Ja Het type gegevens van de parameter, zoals Tekenreeks, Booleaanse waarde, Int of DateTime volgens de opsomming DataType in het XML-schema van het aangepaste beleid. Dit type wordt gebruikt om rekenkundige bewerkingen correct uit te voeren. Elke claimtransformatie heeft zijn eigen waarden. Zie de referentie voor claimtransformatie voor een volledige lijst met de beschikbare waarden.
Waarde Ja Een waarde die wordt doorgegeven aan de transformatie. Sommige waarden zijn willekeurig, waarvan u een selectie maakt in de claimtransformatiemethode.

Output Claims

Het element OutputClaims bevat het volgende element:

Onderdeel Instanties Beschrijving
Uitvoer claimen 0:n Een verwacht type uitvoerclaim.

Uitvoer claimen

Het Element OutputClaim bevat de volgende kenmerken:

Eigenschap Verplicht Beschrijving
Referentie-id voor claimtype Ja Een verwijzing naar een ClaimType dat al is gedefinieerd in de sectie ClaimsSchema in het beleid.
TransformatieClaimType Ja Een id die verwijst naar een transformatieclaimtype. Elke claimtransformatie heeft zijn eigen waarden. Zie de referentie voor claimtransformatie voor een volledige lijst met de beschikbare waarden.

Invoer- en uitvoerclaims die worden gebruikt in claimtransformatie, moeten uniek zijn. Dezelfde invoerclaim kan niet worden gebruikt als de uitvoerclaim.

Voorbeeld

U kunt bijvoorbeeld de laatste versie van uw services opslaan die de gebruiker heeft geaccepteerd. Wanneer u de servicevoorwaarden bijwerkt, kunt u de gebruiker vragen de nieuwe versie te accepteren. In het volgende voorbeeld vergelijkt de transformatie hasTOSVersionChanged claims de waarde van de TOSVersion-claim met de waarde van de lastTOSAcceptedVersion-claim en retourneert vervolgens de booleaanse TOSVersionChanged-claim .

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

Verwijzing naar claimstransformaties

Zie de volgende referentiepagina's voor voorbeelden van claimtransformaties: