Trasformazioni delle attestazioni integre

Articolo
01/11/2024

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 `true`o `false`.
OutputClaim	outputClaim	boolean	Se `ThrowError` è impostato su `false`, questa attestazione di output contiene `true`o `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

Trovare altri esempi di trasformazione attestazioni nel repository GitHub della community di Azure AD B2C

Share via