Udostępnij przez

Przekształcenia roszczeń

Ważne

Od 1 maja 2025 r. usługa Azure AD B2C nie będzie już dostępna do zakupu dla nowych klientów. Dowiedz się więcej w naszych często zadawanych pytaniach.

Uwaga / Notatka

W usłudze Azure Active Directory B2C niestandardowe zasady są przeznaczone głównie do rozwiązywania złożonych scenariuszy. W przypadku większości scenariuszy zalecamy używanie wbudowanych przepływów użytkownika. Jeśli nie zostało to zrobione, dowiedz się więcej o niestandardowym pakiecie startowym zasad w temacie Wprowadzenie do zasad niestandardowych w usłudze Active Directory B2C.

Element ClaimsTransformations zawiera listę funkcji przekształcania oświadczeń, które mogą być używane w podróżach użytkowników w ramach zasad niestandardowych. Transformacja oświadczeń konwertuje określone oświadczenie na inne. W przekształceniu oświadczeń należy określić metodę przekształcania, na przykład dodając element do kolekcji ciągów lub zmieniając wielkość liter ciągu.

Aby uwzględnić listę funkcji przekształcania oświadczeń, które mogą być używane w podróżach użytkownika, element XML ClaimsTransformations musi być zadeklarowany w sekcji BuildingBlocks zasad.

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

Element ClaimsTransformation zawiera następujące atrybuty:

Atrybut Wymagane Opis
Id Tak Identyfikator używany do unikatowego identyfikowania przekształcenia oświadczenia. Identyfikator jest przywołyny z innych elementów XML w zasadach.
Metoda transformacji Tak Metoda przekształcania do użycia w przekształceniu oświadczeń. Każde przekształcenie oświadczenia ma własne wartości. Zobacz dokumentację przekształcania oświadczeń , aby uzyskać pełną listę dostępnych wartości.

ClaimsTransformation (Transformacja roszczeń)

Element ClaimsTransformation zawiera następujące elementy:

<ClaimsTransformation Id="<identifier>" TransformationMethod="<method>">
  <InputClaims>
    ...
  </InputClaims>
  <InputParameters>
    ...
  </InputParameters>
  <OutputClaims>
    ...
  </OutputClaims>
</ClaimsTransformation>
Składnik Wystąpień Opis
InputClaims (Oświadczenia wejściowe) 0:1 Lista elementów InputClaim , które określają typy oświadczeń, które są pobierane jako dane wejściowe do przekształcenia oświadczeń. Każdy z tych elementów zawiera odwołanie do obiektu ClaimType już zdefiniowanego w sekcji ClaimsSchema w zasadach.
Parametry wejściowe 0:1 Lista elementów InputParameter , które są dostarczane jako dane wejściowe do przekształcenia oświadczeń.
OutputClaims (Roszczenia wyjściowe) 0:1 Lista elementów OutputClaim , które określają typy oświadczeń, które są generowane po wywołaniu claimsTransformation. Każdy z tych elementów zawiera odwołanie do obiektu ClaimType już zdefiniowanego w sekcji ClaimsSchema.

InputClaims (Oświadczenia wejściowe)

Element InputClaims zawiera następujący element:

Składnik Wystąpień Opis
Oświadczenie wejściowe 1:n Oczekiwany typ oświadczenia wejściowego.

Oświadczenie wejściowe

Element InputClaim zawiera następujące atrybuty:

Atrybut Wymagane Opis
Identyfikator typu roszczenia Tak Odwołanie do typu ClaimType już zdefiniowanego w sekcji ClaimsSchema w zasadach.
TransformationClaimType Tak Identyfikator odwołujący się do typu oświadczenia przekształcenia. Każde przekształcenie oświadczenia ma własne wartości. Zobacz dokumentację przekształcania oświadczeń , aby uzyskać pełną listę dostępnych wartości.

Parametry wejściowe

Element InputParameters zawiera następujący element:

Składnik Wystąpień Opis
Parametr wejściowy 1:n Oczekiwany parametr wejściowy.

Parametr wejściowy

Atrybut Wymagane Opis
Id Tak Identyfikator, który jest odwołaniem do parametru metody przekształcania oświadczeń. Każda metoda przekształcania oświadczeń ma własne wartości. Zobacz tabelę przekształcania oświadczeń, aby uzyskać pełną listę dostępnych wartości.
Typ danych Tak Typ danych parametru, takich jak String, Boolean, Int lub DateTime zgodnie z wyliczeniem DataType w schemacie XML zasad niestandardowych. Ten typ służy do prawidłowego wykonywania operacji arytmetycznych. Każde przekształcenie oświadczenia ma własne wartości. Zobacz dokumentację przekształcania oświadczeń , aby uzyskać pełną listę dostępnych wartości.
Wartość Tak Wartość przekazywana do pełnej transformacji. Niektóre wartości są dowolne. Niektóre z nich wybierane są z metody przekształcania oświadczeń.

OutputClaims (Roszczenia wyjściowe)

Element OutputClaims zawiera następujący element:

Składnik Wystąpień Opis
OutputClaim (Roszczenie wyjściowe) 0:n Oczekiwany typ oświadczenia wyjściowego.

OutputClaim (Roszczenie wyjściowe)

Element OutputClaim zawiera następujące atrybuty:

Atrybut Wymagane Opis
Identyfikator typu roszczenia Tak Odwołanie do typu ClaimType już zdefiniowanego w sekcji ClaimsSchema w zasadach.
TransformationClaimType Tak Identyfikator odwołujący się do typu oświadczenia przekształcenia. Każde przekształcenie oświadczenia ma własne wartości. Zobacz dokumentację przekształcania oświadczeń , aby uzyskać pełną listę dostępnych wartości.

Oświadczenia wejściowe i wyjściowe używane w transformacji oświadczeń muszą być odrębne. Nie można użyć tego samego oświadczenia wejściowego jako oświadczenia wyjściowego.

Przykład

Możesz na przykład przechowywać ostatnią wersję warunków usług zaakceptowanych przez użytkownika. Po zaktualizowaniu warunków usług możesz poprosić użytkownika o zaakceptowanie nowej wersji. W poniższym przykładzie przekształcenie hasTOSVersionChanged porównuje wartość oświadczenia TOSVersion z wartością oświadczenia LastTOSAcceptedVersion , a następnie zwraca oświadczenie logiczne TOSVersionChanged .

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

Dokumentacja przekształceń oświadczeń

Przykłady przekształceń oświadczeń można znaleźć na następujących stronach referencyjnych:

  • Last updated on