Trasformazioni delle attestazioni di data

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

AssertDateTimeIsGreaterThan

Afferma che una data è successiva a una seconda data. Determina se l'oggetto rightOperandleftOperandè maggiore di . In caso affermativo, genera un'eccezione. Vedere la demo live di questa trasformazione delle attestazioni.

La trasformazione dell'asserzione AssertDateTimeIsGreaterThan viene sempre eseguita da un profilo tecnico di convalida che viene chiamato da un profilo tecnico autocertificato. I metadati del profilo tecnico autocertificato DateTimeGreaterThan controllano il messaggio di errore che il profilo tecnico presenta all'utente. I messaggi di errore possono essere localizzati.

Esempio di AssertDateTimeIsGreaterThan

Nell'esempio seguente viene confrontata l'attestazione currentDateTime con l'attestazione approvedDateTime. Se currentDateTime è successivo ad approvedDateTime, viene generato un errore. La trasformazione considera uguali i valori se rientrano in una differenza di 5 minuti (30000 millisecondi). Non genererà un errore se i valori sono uguali perché AssertIfEqualTo è impostato su false.

<ClaimsTransformation Id="AssertApprovedDateTimeLaterThanCurrentDateTime" TransformationMethod="AssertDateTimeIsGreaterThan">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="approvedDateTime" TransformationClaimType="leftOperand" />
    <InputClaim ClaimTypeReferenceId="currentDateTime" TransformationClaimType="rightOperand" />
  </InputClaims>
  <InputParameters>
    <InputParameter Id="AssertIfEqualTo" DataType="boolean" Value="false" />
    <InputParameter Id="AssertIfRightOperandIsNotPresent" DataType="boolean" Value="true" />
    <InputParameter Id="TreatAsEqualIfWithinMillseconds" DataType="int" Value="300000" />
  </InputParameters>
</ClaimsTransformation>

• Attestazioni di input:
  • leftOperand: 2022-01-01T15:00:00
  • rightOperand: 2022-01-22T15:00:00
• Parametri di input:
  • AssertIfEqualTo: false
  • AssertIfRightOperandIsNotPresent: true
  • TreatAsEqualIfWithinMillseconds: 300000 (30 secondi)
• Risultato: errore generato

Chiamare la trasformazione attestazioni

Il profilo tecnico di convalida seguente Example-AssertDates chiama la AssertApprovedDateTimeLaterThanCurrentDateTime trasformazione attestazioni.

<TechnicalProfile Id="Example-AssertDates">
  <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="AssertDates" />
  </OutputClaimsTransformations>
  <UseTechnicalProfileForSessionManagement ReferenceId="SM-Noop" />
</TechnicalProfile>

Il profilo tecnico self-asserted chiama il profilo tecnico di convalida Example-AssertDates .

<TechnicalProfile Id="SelfAsserted-AssertDateTimeIsGreaterThan">
  <DisplayName>User ID signup</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="DateTimeGreaterThan">Custom error message if the provided right operand is greater than the right operand.</Item>
  </Metadata>
  ...
  <ValidationTechnicalProfiles>
    <ValidationTechnicalProfile ReferenceId="ClaimsTransformation-AssertDateTimeIsGreaterThan" />
  </ValidationTechnicalProfiles>
</TechnicalProfile>

ConvertDateToDateClaim

Converte un DateTime tipo di attestazione in un Date tipo di attestazione. La trasformazione attestazioni rimuove il formato dell'ora dalla data. Vedere la demo live di questa trasformazione delle attestazioni.

Esempio di ConvertDateTimeToDateClaim

Nell'esempio seguente viene illustrata la conversione dell'attestazione systemDateTime (tipo di dati dateTime) in un'altra attestazione systemDate (tipo di dati date).

<ClaimsTransformation Id="ConvertToDate" TransformationMethod="ConvertDateTimeToDateClaim">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="systemDateTime" TransformationClaimType="inputClaim" />
  </InputClaims>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="systemDate" TransformationClaimType="outputClaim" />
  </OutputClaims>
</ClaimsTransformation>

• Attestazioni di input:
  • inputClaim: 2022-01-03T11:34:22.0000000Z
• Attestazioni di output:
  • outputClaim: 2022-01-03

ConvertDateToDateTimeClaim

Converte un Date tipo di attestazione in un DateTime tipo di attestazione. La trasformazione delle attestazioni converte il formato dell'ora e aggiunge 12:00:00 AM alla data. Vedere la demo live di questa trasformazione delle attestazioni.

Esempio di ConvertDateToDateTimeClaim

L'esempio seguente illustra la conversione dell'attestazione dateOfBirth (tipo di dati date) in un'altra attestazione dateOfBirthWithTime (tipo di dati dateTime).

  <ClaimsTransformation Id="ConvertToDateTime" TransformationMethod="ConvertDateToDateTimeClaim">
    <InputClaims>
      <InputClaim ClaimTypeReferenceId="dateOfBirth" TransformationClaimType="inputClaim" />
    </InputClaims>
    <OutputClaims>
      <OutputClaim ClaimTypeReferenceId="dateOfBirthWithTime" TransformationClaimType="outputClaim" />
    </OutputClaims>
  </ClaimsTransformation>

• Attestazioni di input:
  • inputClaim: 2022-01-03
• Attestazioni di output:
  • outputClaim: 2022-01-03T00:00:00.0000000Z

DateTimeComparison

Confronta due date e determina se la prima data è successiva, precedente o uguale a un'altra. Il risultato è una nuova attestazione booleana con un valore di true o false. Vedere la demo live di questa trasformazione delle attestazioni.

Esempio di DateTimeComparison

Utilizzare questa trasformazione attestazioni per determinare se la prima data e il timeSpanInSeconds parametro è successivo, precedente o uguale a un altro. L'esempio seguente mostra che la prima data (2022-01-01T00:00:00) più 90 giorni è successiva alla seconda data (2022-03-16T00:00:00).

<ClaimsTransformation Id="CompareLastTOSAcceptedWithCurrentDateTime" TransformationMethod="DateTimeComparison">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="extension_LastTOSAccepted" TransformationClaimType="secondDateTime" />
    <InputClaim ClaimTypeReferenceId="currentDateTime" TransformationClaimType="firstDateTime" />
  </InputClaims>
  <InputParameters>
    <InputParameter Id="operator" DataType="string" Value="later than" />
    <InputParameter Id="timeSpanInSeconds" DataType="int" Value="7776000" />
  </InputParameters>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="isLastTOSAcceptedGreaterThanNow" TransformationClaimType="result" />
  </OutputClaims>
</ClaimsTransformation>

• Attestazioni di input:
  • firstDateTime: 2022-01-01T00:00:00.10000Z
  • secondDateTime: 2022-03-16T00:00:00.10000Z
• Parametri di input:
  • operatore: later than
  • timeSpanInSeconds: 7776000 (90 giorni)
• Attestazioni di output:
  • risultato: true

IsTermsOfUseConsentRequired

Determinare se un dateTime tipo di attestazione è precedente o maggiore di una data specifica. Il risultato è una nuova attestazione booleana con un valore di true o false. Vedere la demo live di questa trasformazione delle attestazioni.

Utilizzare questa trasformazione attestazioni per determinare se un dateTime tipo di attestazione è precedente o maggiore di una data specifica. Ad esempio, verificare se un utente ha acconsentito alla versione più recente delle condizioni di utilizzo (TOU) o delle condizioni di servizio. Per controllare l'ultima volta che un utente ha accettato, archiviare l'ultima volta che l'utente ha accettato l'oggetto TOU in un attributo di estensione. Quando la parola TOU cambia, aggiornare il termsOfUseTextUpdateDateTime parametro di input con l'ora della modifica. Chiamare quindi questa trasformazione attestazioni per confrontare le date. Se la trasformazione attestazioni restituisce true, il termsOfUseConsentDateTime valore è precedente termsOfUseTextUpdateDateTime al valore e è possibile chiedere all'utente di accettare l'oggetto TOU aggiornato.

<ClaimsTransformation Id="IsTermsOfUseConsentRequired" TransformationMethod="IsTermsOfUseConsentRequired">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="extension_termsOfUseConsentDateTime" TransformationClaimType="termsOfUseConsentDateTime" />
  </InputClaims>
  <InputParameters>
    <InputParameter Id="termsOfUseTextUpdateDateTime" DataType="dateTime" Value="2021-11-15T00:00:00" />
  </InputParameters>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="termsOfUseConsentRequired" TransformationClaimType="result" />
  </OutputClaims>
</ClaimsTransformation>

Esempio isTermsOfUseConsentRequired

• Attestazioni di input:
  • termsOfUseConsentDateTime: 2020-03-09T09:15:00
• Parametri di input:
  • termsOfUseTextUpdateDateTime: 2021-11-15
• Attestazioni di output:
  • risultato: true

GetCurrentDateTime

Ottenere la data e l'ora UTC correnti e aggiungere il valore a un tipo di attestazione. Vedere la demo live di questa trasformazione delle attestazioni.

Esempio di GetCurrentDateTime

Nell'esempio seguente viene illustrato come ottenere i dati e l'ora correnti:

<ClaimsTransformation Id="GetSystemDateTime" TransformationMethod="GetCurrentDateTime">
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="systemDateTime" TransformationClaimType="currentDateTime" />
  </OutputClaims>
</ClaimsTransformation>

• Attestazioni di output:
  • currentDateTime: 2022-01-14T11:40:35.0000000Z

Passaggi successivi

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