Überprüfungsanzeige-Steuerelement

Von Bedeutung

Ab dem 1. Mai 2025 steht Azure AD B2C nicht mehr für neue Kunden zur Verfügung. Weitere Informationen finden Sie in unseren HÄUFIG gestellten Fragen.

Verwenden Sie ein Überprüfungsanzeigesteuerelement , um einen Anspruch zu überprüfen, z. B. eine E-Mail-Adresse oder Telefonnummer, mit einem Überprüfungscode, der an den Benutzer gesendet wurde.

VerificationControl-Aktionen

Das Überprüfungsanzeigesteuerelement besteht aus zwei Schritten (Aktionen):

1. Fordern Sie ein Ziel des Benutzers an, z. B. eine E-Mail-Adresse oder Telefonnummer, an die der Überprüfungscode gesendet werden soll. Wenn der Benutzer die Schaltfläche "Code senden " auswählt, wird die SendCode-Aktion des Überprüfungsanzeigesteuerelements ausgeführt. Die SendCode-Aktion generiert einen Code, erstellt den zu sendenden Inhalt und sendet ihn an den Benutzer. Der Wert der Adresse kann vorgefüllt und als zweitstufige Authentifizierung dienen.

   

2. Nachdem der Code gesendet wurde, liest der Benutzer die Nachricht, gibt den Überprüfungscode in das vom Anzeigesteuerelement bereitgestellte Steuerelement ein und wählt "Code überprüfen" aus. Wenn Sie "Code überprüfen" auswählen, wird die VerifyCode-Aktion ausgeführt, um den code zu überprüfen, der der Adresse zugeordnet ist. Wenn der Benutzer " Neuen Code senden" auswählt, wird die erste Aktion erneut ausgeführt.

   

VerificationControl erforderliche Elemente

Das VerificationControl-Objekt muss die folgenden Elemente enthalten:

• Der Typ des ist DisplayControlVerificationControl.
• DisplayClaims
  • Senden an – Mindestens ein Anspruch, der angibt, an welchen Ort der Überprüfungscode gesendet werden soll. Beispiel: E-Mail oderLändervorwahl und Telefonnummer.
  • Überprüfungscode – Der Überprüfungscodeanspruch, den der Benutzer nach dem Senden des Codes bereitstellt. Dieser Anspruch muss als erforderlich festgelegt werden und ControlClaimType muss auf VerificationCode. festgelegt werden.
• Ausgabeanspruch (optional), der nach Abschluss des Überprüfungsprozesses an die selbstausgeprüfte Seite zurückgegeben werden soll. Beispiel: E-Mail oderLändervorwahl und Telefonnummer. Das selbst behauptete technische Profil verwendet die Ansprüche, um die Daten beizubehalten oder die Ausgabeansprüche im nächsten Orchestrierungsschritt aufzublasen.
• Zwei Actions mit folgenden Namen:
  • SendCode – Sendet einen Code an den Benutzer. Diese Aktion enthält in der Regel zwei technische Überprüfungsprofile, um einen Code zu generieren und zu senden.
  • VerifyCode – Überprüft den Code. Diese Aktion enthält in der Regel ein einzelnes technisches Überprüfungsprofil.

Im folgenden Beispiel wird auf der Seite ein E-Mail-Textfeld angezeigt. Wenn der Benutzer seine E-Mail-Adresse eingibt und "SendCode" auswählt, wird die SendCode-Aktion im Azure AD B2C-Back-End ausgelöst.

Anschließend gibt der Benutzer den verificationCode ein und wählt "VerifyCode " aus, um die VerifyCode-Aktion im Back-End auszulösen. Wenn alle Überprüfungen bestehen, gilt die VerificationControl als abgeschlossen, und der Benutzer kann mit dem nächsten Schritt fortfahren.

<DisplayControl Id="emailVerificationControl" UserInterfaceControlType="VerificationControl">
  <DisplayClaims>
    <DisplayClaim ClaimTypeReferenceId="email"  Required="true" />
    <DisplayClaim ClaimTypeReferenceId="verificationCode" ControlClaimType="VerificationCode" Required="true" />
  </DisplayClaims>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="email" />
  </OutputClaims>
  <Actions>
    <Action Id="SendCode">
      <ValidationClaimsExchange>
        <ValidationClaimsExchangeTechnicalProfile TechnicalProfileReferenceId="GenerateOtp" />
        <ValidationClaimsExchangeTechnicalProfile TechnicalProfileReferenceId="SendGrid" />
      </ValidationClaimsExchange>
    </Action>
    <Action Id="VerifyCode">
      <ValidationClaimsExchange>
        <ValidationClaimsExchangeTechnicalProfile TechnicalProfileReferenceId="VerifyOtp" />
      </ValidationClaimsExchange>
    </Action>
  </Actions>
</DisplayControl>