Transformationen von Datumsansprüchen

Dieser Artikel enthält Beispiele für die Verwendung von Transformationen von Datumsansprüchen des Identity Experience Framework-Schemas in Azure Active Directory B2C (Azure AD B2C). Weitere Informationen finden Sie unter Anspruchstransformationen.

AssertDateTimeIsGreaterThan

Bestätigt, dass ein Datum nach einem zweiten Datum liegt. Bestimmt, ob rightOperand größer als leftOperand ist. Wenn Ja, wird eine Ausnahme ausgelöst. Sehen Sie sich die Livedemo dieser Anspruchstransformation an.

Die Anspruchstransformation AssertDateTimeIsGreaterThan wird immer über ein technisches Validierungsprofil ausgeführt, das von einem selbstbestätigten technischen Profil aufgerufen wird. Die Metadaten des selbstbestätigten technischen Profils DateTimeGreaterThan steuern die Fehlermeldung, die das technische Profil dem Benutzer anzeigt. Die Fehlermeldungen können lokalisiert werden.

Ein Beispiel für AssertDateTimeIsGreaterThan

Im folgenden Beispiel wird der currentDateTime-Anspruch mit dem approvedDateTime-Anspruch verglichen. Ein Fehler wird ausgelöst, wenn currentDateTime nach approvedDateTime liegt. Die Transformation behandelt Werte als gleich, wenn sie innerhalb eines Abstands von 5 Minuten (30.000 Millisekunden) liegen. Es wird kein Fehler ausgelöst, wenn die Werte gleich sind, da AssertIfEqualTo auf false festgelegt ist.

<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>

• Eingabeansprüche:
  • leftOperand: 2022-01-01T15:00:00
  • rightOperand: 2022-01-22T15:00:00
• Eingabeparameter:
  • AssertIfEqualTo: falsch
  • AssertIfRightOperandIsNotPresent: wahr
  • TreatAsEqualIfWithinMillseconds: 300000 (30 Sekunden)
• Ergebnis: Fehler wird ausgelöst.

Hinzufügen der Anspruchstransformation

Das folgende Example-AssertDates technische Validierungsprofil ruft die AssertApprovedDateTimeLaterThanCurrentDateTime Anspruchstransformation auf.

<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>

Das selbstbestätigte technische Profil ruft das Example-AssertDates technische Validierungsprofil auf.

<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>

ConvertDateTimeToDateClaim

Konvertiert einen DateTime Anspruchstyp in einen Date Anspruchstyp. Die Anspruchstransformation entfernt das Uhrzeitformat aus dem Datum. Sehen Sie sich die Livedemo dieser Anspruchstransformation an.

Ein Beispiel für ConvertDateTimeToDateClaim

Das folgende Beispiel veranschaulicht die Konvertierung des Anspruchs systemDateTime (Datentyp „dateTime“) in einen anderen Anspruch systemDate (Datentyp „date“).

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

• Eingabeansprüche:
  • inputClaim: 2022-01-03T11:34:22.0000000Z
• Ausgabeansprüche:
  • outputClaim: 2022-01-03

ConvertDateToDateTimeClaim

Konvertiert einen Date Anspruchstyp in einen DateTime Anspruchstyp. Die Anspruchstransformation konvertiert das Uhrzeitformat und fügt dem Datum 12:00:00 AM hinzu. Sehen Sie sich die Livedemo dieser Anspruchstransformation an.

Ein Beispiel für ConvertDateToDateTimeClaim

Das folgende Beispiel veranschaulicht die Konvertierung des Anspruchs dateOfBirth (Datentyp „date“) in einen anderen Anspruch dateOfBirthWithTime (Datentyp „dateTime“).

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

• Eingabeansprüche:
  • inputClaim: 2022-01-03
• Ausgabeansprüche:
  • outputClaim: 2022-01-03T00:00:00.0000000Z

DateTimeComparison

Vergleicht zwei Datumsangaben und bestimmt, ob das erste Datum später, früher oder gleich einem anderen Datum ist. Das Ergebnis ist ein neuer boolescher Anspruch mit dem Wert von true oder false. Sehen Sie sich die Livedemo dieser Anspruchstransformation an.

Ein Beispiel für DateTimeComparison

Verwenden Sie diese Anspruchstransformation, um zu bestimmen, ob das erste Datum plus der timeSpanInSeconds Parameter später, früher oder gleich einem anderen ist. Das folgende Beispiel zeigt, dass das erste Datum (2022-01-01T00:00:00) plus 90 Tage nach dem zweiten Datum (2022-03-16T00:00:00) liegt.

<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>

• Eingabeansprüche:
  • firstDateTime: 2022-01-01T00:00:00.100000Z
  • secondDateTime: 2022-03-16T00:00:00.100000Z
• Eingabeparameter:
  • operator: später als
  • timeSpanInSeconds: 7776000 (90 days)
• Ausgabeansprüche:
  • result: true

IsTermsOfUseConsentRequired

Bestimmen Sie, ob ein dateTime Anspruchstyp älter oder größer als ein bestimmtes Datum ist. Das Ergebnis ist ein neuer boolescher Anspruch mit dem Wert von true oder false. Sehen Sie sich die Livedemo dieser Anspruchstransformation an.

Verwenden Sie diese Anspruchstransformation, um zu bestimmen, ob ein dateTime Anspruchstyp älter oder größer als ein bestimmtes Datum ist. Überprüfen Sie beispielsweise, ob ein Benutzer der neuesten Version Ihrer Nutzungsbedingungen (Terms of Use, TOU) oder der Vertragsbedingungen zugestimmt hat. Um den Zeitpunkt der letzten Zustimmung eines Benutzers zu überprüfen, speichern Sie den Zeitpunkt, zu dem der Benutzer die Nutzungsbedingungen zuletzt akzeptiert hat, in einem Erweiterungsattribut. Wenn sich ihre Nutzungsbedingungsformulierung ändert, aktualisieren Sie den termsOfUseTextUpdateDateTime Eingabeparameter mit dem Zeitpunkt der Änderung. Rufen Sie dann diese Anspruchstransformation auf, um die Datumsangaben zu vergleichen. Wenn die Anspruchstransformation true zurückgibt, liegt der termsOfUseConsentDateTime Wert vor dem termsOfUseTextUpdateDateTime Wert, und Sie können den Benutzer bitten, die aktualisierten Nutzungsbedingungen zu akzeptieren.

<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>

Ein Beispiel für IsTermsOfUseConsentRequired-Beispiel

• Eingabeansprüche:
  • termsOfUseConsentDateTime: 2020-03-09T09:15:00
• Eingabeparameter:
  • termsOfUseTextUpdateDateTime: 2021-11-15
• Ausgabeansprüche:
  • result: true

GetCurrentDateTime

Ruft den aktuellen UTC-Datum/Uhrzeit-Wert ab und fügt den Wert zu einem Anspruchstyp hinzu. Sehen Sie sich die Livedemo dieser Anspruchstransformation an.

Ein Beispiel für GetCurrentDateTime

Das folgende Beispiel zeigt, wie sie die aktuellen Daten und die aktuelle Uhrzeit abrufen:

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

• Ausgabeansprüche:
  • currentDateTime: 2022-01-14T11:40:35.0000000Z

Nächste Schritte

• Weitere Beispiele für die Anspruchstransformation finden Sie im GitHub-Repository der Azure-AD-B2C-Community