Compartilhar via

ClaimsTransformations

Importante

A partir de 1º de maio de 2025, o Azure AD B2C não estará mais disponível para compra para novos clientes. Saiba mais em nossas perguntas frequentes.

Observação

No Azure Active Directory B2C, as políticas personalizadas são projetadas principalmente para tratar de cenários complexos. Para a maioria dos cenários, recomendamos que você use fluxos de usuários predefinidos. Se você ainda não fez isso, saiba mais sobre o pacote de início de política personalizado em Introdução às políticas personalizadas no Active Directory B2C.

O elemento ClaimsTransformations contém uma lista de funções de transformação de declarações que podem ser usadas em percursos do usuário como parte de uma política personalizada. Uma transformação de declarações converte uma determinada declaração em outra. Na transformação declarações, especifique o método de transformação, por exemplo, adicionando um item a uma coleção de cadeias de caracteres ou alterando o caso de uma cadeia de caracteres.

Para incluir a lista de funções de transformação de declarações que podem ser usadas nos percursos do usuário, um elemento XML ClaimsTransformations deve ser declarado na seção BuildingBlocks da política.

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

O elemento ClaimsTransformation contém os seguintes atributos:

Atributo Obrigatório Descrição
ID Sim Um identificador usado para identificar exclusivamente a transformação de declaração. O identificador é referenciado de outros elementos XML na política.
Método de transformação Sim O método de transformação a ser usado na transformação de declarações. Cada transformação de declaração tem seus próprios valores. Consulte a referência de transformação de declarações para obter uma lista completa dos valores disponíveis.

Transformação de Declarações

O elemento ClaimsTransformation contém os seguintes elementos:

<ClaimsTransformation Id="<identifier>" TransformationMethod="<method>">
  <InputClaims>
    ...
  </InputClaims>
  <InputParameters>
    ...
  </InputParameters>
  <OutputClaims>
    ...
  </OutputClaims>
</ClaimsTransformation>
Elemento Ocorrências Descrição
Declarações de entrada 0:1 Uma lista de elementos InputClaim que especificam tipos de declaração que são usados como entrada para a transformação de declarações. Cada um desses elementos contém uma referência a um ClaimType já definido na seção ClaimsSchema na política.
Parâmetros de entrada 0:1 Uma lista de elementos InputParameter fornecidos como entrada para a transformação de declarações.
Declarações de saída 0:1 Uma lista de elementos OutputClaim que especificam tipos de declaração que são produzidos após a invocação de ClaimsTransformation. Cada um desses elementos contém referência a um ClaimType já definido na seção ClaimsSchema.

Declarações de entrada

O elemento InputClaims contém o seguinte elemento:

Elemento Ocorrências Descrição
Reivindicação de entrada 1:n Um tipo de declaração de entrada esperado.

Reivindicação de entrada

O elemento InputClaim contém os seguintes atributos:

Atributo Obrigatório Descrição
ClaimTypeReferenceId Sim Uma referência a um ClaimType já definido na seção ClaimsSchema na política.
TransformationClaimType Sim Um identificador para fazer referência a um tipo de declaração de transformação. Cada transformação de declaração tem seus próprios valores. Consulte a referência de transformação de declarações para obter uma lista completa dos valores disponíveis.

Parâmetros de entrada

O elemento InputParameters contém o seguinte elemento:

Elemento Ocorrências Descrição
Parâmetro de entrada 1:n Um parâmetro de entrada esperado.

Parâmetro de entrada

Atributo Obrigatório Descrição
ID Sim Um identificador que é uma referência a um parâmetro do método de transformação de declarações. Cada método de transformação de declarações tem seus próprios valores. Consulte a tabela de transformação de declarações para obter uma lista completa dos valores disponíveis.
Tipo de dados Sim O tipo de dados do parâmetro, como String, Boolean, Int ou DateTime de acordo com a enumeração DataType no esquema XML de política personalizada. Esse tipo é usado para executar operações aritméticas corretamente. Cada transformação de declaração tem seus próprios valores. Consulte a referência de transformação de declarações para obter uma lista completa dos valores disponíveis.
Valor Sim Um valor que é passado verbatim para a transformação. Alguns dos valores são arbitrários, alguns deles selecionados no método de transformação de declarações.

Declarações de saída

O elemento OutputClaims contém o seguinte elemento:

Elemento Ocorrências Descrição
Declaração de saída 0:n Um tipo de declaração de saída esperado.

Declaração de saída

O elemento OutputClaim contém os seguintes atributos:

Atributo Obrigatório Descrição
ClaimTypeReferenceId Sim Uma referência a um ClaimType já definido na seção ClaimsSchema na política.
TransformationClaimType Sim Um identificador para fazer referência a um tipo de declaração de transformação. Cada transformação de declaração tem seus próprios valores. Consulte a referência de transformação de declarações para obter uma lista completa dos valores disponíveis.

As declarações de entrada e saída usadas na transformação de declarações precisam ser distintas. A mesma declaração de entrada não pode ser usada como a declaração de saída.

Exemplo

Por exemplo, você pode armazenar a última versão dos seus termos de serviços que o usuário aceitou. Ao atualizar os termos de serviços, você pode pedir ao usuário para aceitar a nova versão. No exemplo a seguir, a transformação de declarações HasTOSVersionChanged compara o valor da declaração TOSVersion com o valor da declaração LastTOSAcceptedVersion e retorna a declaração BOOLEAN 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>

Referência de transformações de declarações

Para obter exemplos de transformações de declarações, consulte as seguintes páginas de referência: