Bagikan melalui


Kontrol tampilan verifikasi

Penting

Berlaku mulai 1 Mei 2025, Azure AD B2C tidak akan lagi tersedia untuk dibeli untuk pelanggan baru. Pelajari lebih lanjut di FAQ kami.

Gunakan kontrol tampilan verifikasi untuk memverifikasi klaim, misalnya alamat email atau nomor telepon, dengan kode verifikasi yang dikirim ke pengguna.

Tindakan VerificationControl

Kontrol tampilan verifikasi terdiri dari dua langkah (tindakan):

  1. Minta tujuan dari pengguna, seperti alamat email atau nomor telepon, tempat kode verifikasi harus dikirim. Saat pengguna memilih tombol Kirim Kode , Tindakan SendCode kontrol tampilan verifikasi dijalankan. Tindakan SendCode menghasilkan kode, membuat konten yang akan dikirim, dan mengirimkannya kepada pengguna. Nilai alamat dapat diisi sebelumnya dan berfungsi sebagai autentikasi faktor kedua.

    Halaman contoh untuk tindakan kirim kode

  2. Setelah kode dikirim, pengguna membaca pesan, memasukkan kode verifikasi ke dalam kontrol yang disediakan oleh kontrol tampilan, dan memilih Verifikasi Kode. Dengan memilih Verifikasi Kode, Tindakan VerifyCode dijalankan untuk memverifikasi kode yang terkait dengan alamat. Jika pengguna memilih Kirim Kode Baru, tindakan pertama dijalankan lagi.

    Halaman contoh untuk memverifikasi tindakan kode

Elemen yang diperlukan VerificationControl

VerificationControl harus berisi elemen berikut:

  • Jenisnya DisplayControl adalah VerificationControl.
  • DisplayClaims
    • Kirim ke - Satu atau beberapa klaim yang menentukan tempat mengirim kode verifikasi. Misalnya, email atau kode negara dan nomor telepon.
    • Kode verifikasi - Klaim kode verifikasi yang disediakan pengguna setelah kode dikirim. Klaim ini harus ditetapkan sebagaimana diperlukan, dan ControlClaimType harus diatur ke VerificationCode.
  • Klaim output (opsional) untuk dikembalikan ke halaman yang ditegaskan sendiri setelah pengguna menyelesaikan proses verifikasi. Misalnya, email atau kode negara dan nomor telepon. Profil teknis yang ditegaskan sendiri menggunakan klaim untuk mempertahankan data atau menggelembungkan klaim output ke langkah orkestrasi berikutnya.
  • Dua Actiondengan nama berikut:
    • SendCode - Mengirim kode kepada pengguna. Tindakan ini biasanya berisi dua profil teknis validasi, untuk menghasilkan kode dan mengirimkannya.
    • VerifyCode - Memverifikasi kode. Tindakan ini biasanya berisi satu profil teknis validasi.

Dalam contoh di bawah ini, kotak teks email ditampilkan di halaman. Saat pengguna memasukkan alamat email mereka dan memilih SendCode, tindakan SendCode dipicu di back end Azure AD B2C.

Kemudian, pengguna memasukkan verificationCode dan memilih VerifyCode untuk memicu tindakan VerifyCode di ujung belakang. Jika semua validasi lolos, VerificationControl dianggap selesai dan pengguna dapat melanjutkan ke langkah berikutnya.

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