Udostępnij za pośrednictwem


Kontrolka wyświetlania weryfikacji

Ważne

Od 1 maja 2025 r. usługa Azure AD B2C nie będzie już dostępna do zakupu dla nowych klientów. Dowiedz się więcej w naszych często zadawanych pytaniach.

Użyj kontrolki wyświetlania weryfikacji, aby zweryfikować oświadczenie, na przykład adres e-mail lub numer telefonu, z kodem weryfikacyjnym wysłanym do użytkownika.

Akcje WeryfikacjiControl

Kontrolka wyświetlania weryfikacji składa się z dwóch kroków (akcji):

  1. Zażądaj miejsca docelowego od użytkownika, takiego jak adres e-mail lub numer telefonu, do którego powinien zostać wysłany kod weryfikacyjny. Gdy użytkownik wybierze przycisk Wyślij kod , zostanie wykonana akcja SendCode kontrolki wyświetlania weryfikacji. Akcja SendCode generuje kod, konstruuje zawartość do wysłania i wysyła ją do użytkownika. Wartość adresu może być wstępnie wypełniona i służyć jako uwierzytelnianie dwuskładnikowe.

    Przykładowa strona akcji wysyłania kodu

  2. Po wysłaniu kodu użytkownik odczytuje komunikat, wprowadza kod weryfikacyjny do kontrolki dostarczonej przez kontrolkę wyświetlania i wybiera pozycję Weryfikuj kod. Wybierając pozycję Weryfikuj kod, akcja VerifyCode jest wykonywana w celu zweryfikowania kodu skojarzonego z adresem. Jeśli użytkownik wybierze pozycję Wyślij nowy kod, pierwsza akcja zostanie wykonana ponownie.

    Przykładowa strona weryfikacji akcji kodu

Wymagane elementy WeryfikacjiControl

Element VerificationControl musi zawierać następujące elementy:

  • Typ obiektu DisplayControl to VerificationControl.
  • DisplayClaims
    • Wyślij do — co najmniej jedno oświadczenie określające miejsce wysłania kodu weryfikacyjnego do. Na przykład adres e-mail lub kod kraju i numer telefonu.
    • Kod weryfikacyjny — oświadczenie kodu weryfikacyjnego, które użytkownik podaje po wysłaniu kodu. To oświadczenie musi być ustawione zgodnie z wymaganiami i ControlClaimType musi być ustawione na VerificationCode.
  • Oświadczenie wyjściowe (opcjonalnie) zwracane do strony samozwańczej po zakończeniu procesu weryfikacji przez użytkownika. Na przykład adres e-mail lub kod kraju i numer telefonu. Własny profil techniczny używa oświadczeń, aby utrwały dane lub bąbelki w górę oświadczeń wyjściowych do następnego kroku aranżacji.
  • Dwa Actions z następującymi nazwami:
    • SendCode — wysyła kod do użytkownika. Ta akcja zwykle zawiera dwa profile techniczne weryfikacji, aby wygenerować kod i wysłać go.
    • VerifyCode — weryfikuje kod. Ta akcja zwykle zawiera pojedynczy profil techniczny weryfikacji.

W poniższym przykładzie na stronie zostanie wyświetlone pole tekstowe wiadomości e-mail . Gdy użytkownik wprowadzi swój adres e-mail i wybierze pozycję SendCode, akcja SendCode zostanie wyzwolona w zapleczu usługi Azure AD B2C.

Następnie użytkownik wprowadza kod weryfikacji i wybiera pozycję VerifyCode , aby wyzwolić akcję VerifyCode w zapleczu. Jeśli wszystkie weryfikacje zakończą się, kontrola weryfikacji zostanie uznana za ukończoną, a użytkownik będzie mógł przejść do następnego kroku.

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