Transformações de declarações boolianas

Este artigo fornece exemplos para usar as transformações de declarações boolianas do esquema do Identity Experience Framework no Azure AD B2C (Azure Active Directory B2C). Para obter mais informações, consulte transformações de declarações.

E Reivindicações

Calcula uma And operação de duas declarações de entrada boolianas e define a declaração de saída com o resultado da operação. Confira a Demonstração ao vivo desta transformação de declarações.

Exemplo de AndClaims

A transformação de declarações a seguir demonstra como duas And declarações boolianas: isEmailNotExiste isSocialAccount. A declaração presentEmailSelfAsserted de saída será definida como true se os valores de ambas as declarações de entrada forem true.

<ClaimsTransformation Id="CheckWhetherEmailBePresented" TransformationMethod="AndClaims">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="isEmailNotExist" TransformationClaimType="inputClaim1" />
    <InputClaim ClaimTypeReferenceId="isSocialAccount" TransformationClaimType="inputClaim2" />
  </InputClaims>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="presentEmailSelfAsserted" TransformationClaimType="outputClaim" />
  </OutputClaims>
</ClaimsTransformation>

• Declarações de entrada:
  • inputClaim1: verdadeiro
  • inputClaim2: false
• Declarações de saída:
  • outputClaim: falso

AssertBooleanClaimIsEqualToValue

Verifica se os valores boolianos de duas declarações são iguais e gera uma exceção se não forem. Confira a Demonstração ao vivo desta transformação de declarações.

A transformação de declarações AssertBooleanClaimIsEqualToValue é sempre executada a partir de um perfil técnico de validação chamado por um perfil técnico autodeclarado. Os metadados de perfil técnico autodeclarados UserMessageIfClaimsTransformationBooleanValueIsNotEqual controlam a mensagem de erro que o perfil técnico apresenta ao usuário. A mensagem de erro pode ser localizada.

Exemplo de AssertBooleanClaimIsEqualToValue

A transformação de declarações a seguir demonstra como verificar o valor de uma declaração booliana com um true valor. Se o valor da accountEnabled declaração for falso, uma mensagem de erro será gerada.

<ClaimsTransformation Id="AssertAccountEnabledIsTrue" TransformationMethod="AssertBooleanClaimIsEqualToValue">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="accountEnabled" TransformationClaimType="inputClaim" />
  </InputClaims>
  <InputParameters>
    <InputParameter Id="valueToCompareTo" DataType="boolean" Value="true" />
  </InputParameters>
</ClaimsTransformation>

• Declarações de entrada:
  • inputClaim: falso
  • valueToCompareTo: true
• Resultado: Erro gerado

Chamando a transformação de declarações AssertBooleanClaimIsEqualToValue

O perfil técnico de validação a seguir Example-AssertBoolean chama a AssertAccountEnabledIsTrue transformação de declarações.

<TechnicalProfile Id="Example-AssertBoolean">
  <DisplayName>Unit test</DisplayName>
  <Protocol Name="Proprietary" Handler="Web.TPEngine.Providers.ClaimsTransformationProtocolProvider, Web.TPEngine, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" />
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="ComparisonResult" DefaultValue="false" />
  </OutputClaims>
  <OutputClaimsTransformations>
    <OutputClaimsTransformation ReferenceId="AssertAccountEnabledIsTrue" />
  </OutputClaimsTransformations>
  <UseTechnicalProfileForSessionManagement ReferenceId="SM-Noop" />
</TechnicalProfile>

O perfil técnico autodeclarado chama o perfil técnico de validação Example-AssertBoolean .

<TechnicalProfile Id="SelfAsserted-AssertDateTimeIsGreaterThan">
  <DisplayName>Example</DisplayName>
  <Protocol Name="Proprietary" Handler="Web.TPEngine.Providers.SelfAssertedAttributeProvider, Web.TPEngine, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" />
  <Metadata>
    <Item Key="ContentDefinitionReferenceId">api.selfasserted</Item>
    <Item Key="UserMessageIfClaimsTransformationBooleanValueIsNotEqual">Custom error message if account is disabled.</Item>
  </Metadata>
  ...
  <ValidationTechnicalProfiles>
    <ValidationTechnicalProfile ReferenceId="Example-AssertBoolean" />
  </ValidationTechnicalProfiles>
</TechnicalProfile>

CompararBooleanClaimToValue

Verifica se o valor booliano de uma declaração é igual a true ou falsee retorna o resultado da compactação. Confira a Demonstração ao vivo desta transformação de declarações.

Exemplo de CompareBooleanClaimToValue

A transformação de declarações a seguir demonstra como verificar o valor de uma declaração booliana com um true valor. Se o valor da IsAgeOver21Years declaração for igual a true, a transformação de declarações retornará true, caso contrário false.

<ClaimsTransformation Id="AssertAccountEnabled" TransformationMethod="CompareBooleanClaimToValue">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="IsAgeOver21Years" TransformationClaimType="inputClaim" />
  </InputClaims>
  <InputParameters>
    <InputParameter Id="valueToCompareTo" DataType="boolean" Value="true" />
  </InputParameters>
  <OutputClaims>
    <OutputClaim  ClaimTypeReferenceId="accountEnabled" TransformationClaimType="compareResult"/>
  </OutputClaims>
</ClaimsTransformation>

• Declarações de entrada:
  • inputClaim: falso
• Parâmetros de entrada:
  • valueToCompareTo: true
• Declarações de saída:
  • compareResult: false

Não Reivindicações

Calcula uma Not operação da declaração de entrada booliana e define a declaração de saída com o resultado da operação. Confira a Demonstração ao vivo desta transformação de declarações.

Exemplo de NotClaims

A transformação de declarações a seguir demonstra como executar a negação lógica em uma declaração.

<ClaimsTransformation Id="CheckWhetherEmailBePresented" TransformationMethod="NotClaims">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="userExists" TransformationClaimType="inputClaim" />
  </InputClaims>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="userExists" TransformationClaimType="outputClaim" />
  </OutputClaims>
</ClaimsTransformation>

• Declarações de entrada:
  • inputClaim: falso
• Declarações de saída:
  • outputClaim: verdadeiro

Ou Reivindicações

Calcula uma Or das duas declarações boolianas e define a declaração de saída com o resultado da operação. Confira a Demonstração ao vivo desta transformação de declarações.

Exemplo de OrClaims

A transformação de declarações a seguir demonstra como fazer Or duas declarações boolianas.

<ClaimsTransformation Id="CheckWhetherEmailBePresented" TransformationMethod="OrClaims">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="isLastTOSAcceptedNotExists" TransformationClaimType="inputClaim1" />
    <InputClaim ClaimTypeReferenceId="isLastTOSAcceptedGreaterThanNow" TransformationClaimType="inputClaim2" />
  </InputClaims>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="presentTOSSelfAsserted" TransformationClaimType="outputClaim" />
  </OutputClaims>
</ClaimsTransformation>

• Declarações de entrada:
  • inputClaim1: verdadeiro
  • inputClaim2: false
• Declarações de saída:
  • outputClaim: verdadeiro

Próximas etapas

• Encontre mais amostras de transformação de declarações no repositório GitHub da comunidade do Azure AD B2C