Condividi tramite


Trasformazioni delle attestazioni integre

Questo articolo fornisce esempi per l'uso delle trasformazioni di attestazioni integer dello schema Identity Experience Framework in Azure Active Directory B2C (Azure AD B2C). Per altre informazioni, vedere ClaimsTransformations.

RegolaNumber

Aumenta o riduce un'attestazione numerica e restituisce una nuova attestazione. Vedere la demo live di questa trasformazione delle attestazioni.

Elemento TransformationClaimType Tipo di dati Note
InputClaim inputClaim INT Tipo di attestazione che contiene il numero da aumentare o diminuire. Se il inputClaim valore attestazione è Null, viene usato il valore predefinito 0.
InputParameter Operatore string I valori possibili sono: INCREMENT (impostazione predefinita) o DECREMENT.
OutputClaim outputClaim INT Tipo di attestazione generato dopo che questa trasformazione attestazioni è stata richiamata.

Esempio di AdjustNumber

Usare questa trasformazione attestazione per aumentare o ridurre un valore di attestazione numerico. La trasformazione attestazione seguente aumenta un valore di attestazione numerico.

<ClaimsTransformation Id="UpdateSteps" TransformationMethod="AdjustNumber">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="steps" TransformationClaimType="inputClaim" />
  </InputClaims>
  <InputParameters>
    <InputParameter Id="Operator" DataType="string" Value="INCREMENT" />
  </InputParameters>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="steps" TransformationClaimType="outputClaim" />
  </OutputClaims>
</ClaimsTransformation>
  • Attestazioni di input:
    • inputClaim: 1
  • Parametri di input:
    • Operatore: INCREMENT
  • Attestazioni di output:
    • outputClaim: 2

Esempio di AdjustNumber con valore Null

Se l'attestazione di input è Null, l'attestazione di output sarà una.

  • Attestazioni di input:
    • inputClaim: NULL
  • Parametri di input:
    • Operator: INCREMENT
  • Attestazioni di output:
    • outputClaim: 1

AssertNumber

Determina se un'attestazione numerica è maggiore, minore, uguale o meno a un numero. Check out the Live demo of this claims transformation.

Elemento TransformationClaimType Tipo di dati Note
InputClaim inputClaim INT Prima attestazione numerica da confrontare se è maggiore, minore, uguale o meno del secondo numero. I valori Null generano un'eccezione.
InputParameter CompareToValue INT Secondo numero da confrontare se è maggiore, minore, uguale o meno del primo numero.
InputParameter Operatore string Valori possibili: LessThanGreaterThan, GreaterThanOrEqualEqualLessThanOrEqualNotEqual.
InputParameter throwError boolean Specifica se questa asserzione deve generare un errore se il risultato del confronto è true. I valori possibili sono: true (impostazione predefinita) o false.
 
Se impostato su true (modalità asserzione) e il risultato del confronto è true, verrà generata un'eccezione. Se impostato su false (modalità valutazione), il risultato è un nuovo tipo di attestazione booleano con un valore di trueo false.
OutputClaim outputClaim boolean Se ThrowError è impostato su false, questa attestazione di output contiene trueo false in base al risultato del confronto.

Modalità asserzione

Quando throwError il parametro di input è true (impostazione predefinita), la trasformazione attestazioni AssertNumber viene sempre eseguita da un profilo tecnico di convalida chiamato da un profilo tecnico auto asserto.

I metadati del profilo tecnico AssertNumberError controllano il messaggio di errore che il profilo tecnico presenta all'utente. I messaggi di errore possono essere localizzati.

<TechnicalProfile Id="SelfAsserted-LocalAccountSignin-Email">
  <Metadata>
    <Item Key="AssertNumberError">You've reached the maximum logon attempts</Item>
  </Metadata>
  ...
</TechnicalProfile>

Per altre informazioni su come chiamare la trasformazione delle attestazioni in modalità asserzione, vedere Trasformazioni attestazioni AssertStringClaimsAreEqual, AssertBooleanClaimIsEqualToValue e AssertDateTimeIsGreaterThan .

Esempio di AssertNumber

L'esempio seguente asserisce il numero di tentativi è superiore a cinque. La trasformazione attestazioni genera un errore in base al risultato del confronto.

<ClaimsTransformation Id="isOverLimit" TransformationMethod="AssertNumber">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="attempts" TransformationClaimType="inputClaim" />
  </InputClaims>
  <InputParameters>
    <InputParameter Id="Operator" DataType="string" Value="GreaterThan" />
    <InputParameter Id="CompareToValue" DataType="int" Value="5" />
    <InputParameter Id="throwError" DataType="boolean" Value="true" />
  </InputParameters>
</ClaimsTransformation>
  • Attestazioni di input:
    • inputClaim: 10
  • Parametri di input:
    • Operatore: GreaterThan
    • CompareToValue: 5
    • throwError: true
  • Risultato: errore generato

Esempio di modalità di valutazione AssertNumber

Nell'esempio seguente viene valutato se il numero di tentativi è superiore a cinque. L'attestazione di output contiene un valore booleano in base al risultato del confronto. La trasformazione attestazioni non genererà un errore.

<ClaimsTransformation Id="isOverLimit" TransformationMethod="AssertNumber">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="attempts" TransformationClaimType="inputClaim" />
  </InputClaims>
  <InputParameters>
    <InputParameter Id="Operator" DataType="string" Value="GreaterThan" />
    <InputParameter Id="CompareToValue" DataType="int" Value="5" />
    <InputParameter Id="throwError" DataType="boolean" Value="false" />
  </InputParameters>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="attemptsCountExceeded" TransformationClaimType="outputClaim" />
  </OutputClaims>
</ClaimsTransformation>
  • Attestazioni di input:
    • inputClaim: 10
  • Parametri di input:
    • Operator: GreaterThan
    • CompareToValue: 5
    • throwError: false
  • Attestazioni di output:
    • outputClaim: true

ConvertNumberToStringClaim

Converte un tipo di dati lungo in un tipo di dati stringa. Vedere la demo live di questa trasformazione delle attestazioni.

Elemento TransformationClaimType Tipo di dati Note
InputClaim inputClaim long Tipo di attestazione da convertire in una stringa.
OutputClaim outputClaim string Tipo di attestazione generato dopo che questa trasformazione attestazioni è stata richiamata.

Esempio di ConvertNumberToStringClaim

In questo esempio, l'numericUserId attestazione con un tipo valore lungo viene convertito in un'UserId attestazione con un tipo valore di stringa.

<ClaimsTransformation Id="CreateUserId" TransformationMethod="ConvertNumberToStringClaim">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="numericUserId" TransformationClaimType="inputClaim" />
  </InputClaims>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="UserId" TransformationClaimType="outputClaim" />
  </OutputClaims>
</ClaimsTransformation>
  • Attestazioni di input:
    • inputClaim: 12334 (lungo)
  • Attestazioni di output:
    • outputClaim: "12334" (stringa)

Passaggi successivi