Bagikan melalui

Menentukan profil teknis Microsoft Entra ID SSPR dalam kebijakan kustom Azure AD B2C

Nota

Di Azure Active Directory B2C, kebijakan kustom didesain khusus untuk menangani skenario kompleks. Untuk skenario umum, sebaiknya gunakan alur pengguna bawaan. Jika Anda belum melakukannya, pelajari tentang paket starter kebijakan kustom di Mulai dengan kebijakan kustom di Azure Active Directory B2C.

Penting

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

Azure Active Directory B2C (Azure AD B2C) menyediakan dukungan untuk memverifikasi alamat email untuk pengaturan ulang kata sandi mandiri (SSPR). Gunakan profil teknis Microsoft Entra ID SSPR untuk membuat dan mengirim kode ke alamat email, lalu verifikasi kode. Profil teknis Microsoft Entra ID SSPR juga dapat mengembalikan pesan kesalahan. Profil teknis validasi memvalidasi data yang disediakan pengguna sebelum perjalanan pengguna berlanjut. Dengan profil teknis validasi, pesan kesalahan ditampilkan di halaman yang dinyatakan sendiri.

Profil teknis ini:

  • Tidak menyediakan antarmuka untuk berinteraksi dengan pengguna. Sebagai gantinya, antarmuka pengguna dipanggil dari profil teknis yang dinyatakan sendiri , atau kontrol tampilan sebagai profil teknis validasi.
  • Menggunakan layanan Microsoft Entra SSPR untuk menghasilkan dan mengirim kode ke alamat email, lalu memverifikasi kode.
  • Memvalidasi alamat email melalui kode verifikasi.

Protokol

Atribut Nama dari elemen Protokol perlu diatur ke Proprietary. Atribut handler harus berisi nama yang sepenuhnya memenuhi syarat dari rakitan handler protokol yang digunakan oleh Azure AD B2C:

Web.TPEngine.Providers.AadSsprProtocolProvider, Web.TPEngine, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null

Contoh berikut menunjukkan profil teknis Microsoft Entra ID SSPR:

<TechnicalProfile Id="AadSspr-SendCode">
  <DisplayName>Send Code</DisplayName>
  <Protocol Name="Proprietary" Handler="Web.TPEngine.Providers.AadSsprProtocolProvider, Web.TPEngine, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" />
    ...

Kirim email

Mode pertama dari profil teknis ini adalah menghasilkan kode dan mengirimkannya. Opsi berikut dapat dikonfigurasi untuk mode ini.

Klaim input

Elemen InputClaims berisi daftar klaim untuk dikirim ke Microsoft Entra SSPR. Anda juga dapat memetakan nama klaim Anda ke nama yang ditentukan dalam profil teknis SSPR.

ClaimReferenceId Diperlukan Deskripsi
alamat email Ya Pengidentifikasi untuk pengguna yang memiliki alamat email. Properti PartnerClaimType klaim input harus diatur ke emailAddress.

Elemen InputClaimsTransformations mungkin berisi kumpulan elemen InputClaimsTransformation yang digunakan untuk memodifikasi klaim input atau menghasilkan yang baru sebelum mengirim ke layanan Microsoft Entra SSPR.

Klaim output

Penyedia protokol Microsoft Entra SSPR tidak mengembalikan OutputClaims apa pun, sehingga tidak perlu menentukan klaim output. Namun, Anda dapat menyertakan klaim yang tidak dikembalikan oleh penyedia protokol Microsoft Entra SSPR selama Anda mengatur DefaultValue atribut.

Elemen OutputClaimsTransformations mungkin berisi kumpulan elemen OutputClaimsTransformation yang digunakan untuk memodifikasi klaim output atau menghasilkan yang baru.

Metainformasi

Karakteristik Diperlukan Deskripsi
Operasi Ya Harus SendCode.

Elemen antarmuka pengguna

Metadata berikut dapat digunakan untuk mengonfigurasi pesan kesalahan yang ditampilkan saat mengirim kegagalan SMS. Metadata harus dikonfigurasi dalam profil teknis yang ditegaskan sendiri . Pesan kesalahan dapat dilokalisasi.

Karakteristik Diperlukan Deskripsi
UserMessageIfInternalError Tidak. Pesan kesalahan pengguna jika server mengalami kesalahan internal.
UserMessageIfThrottled Tidak. Pesan kesalahan pengguna jika permintaan telah dibatasi.

Contoh: mengirim email

Contoh berikut menunjukkan profil teknis Microsoft Entra ID SSPR yang digunakan untuk mengirim kode melalui email.

<TechnicalProfile Id="AadSspr-SendCode">
  <DisplayName>Send Code</DisplayName>
  <Protocol Name="Proprietary" Handler="Web.TPEngine.Providers.AadSsprProtocolProvider, Web.TPEngine, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" />
  <Metadata>
    <Item Key="Operation">SendCode</Item>
  </Metadata>
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="email" PartnerClaimType="emailAddress"/>
  </InputClaims>
</TechnicalProfile>

Verifikasi kode

Mode kedua dari profil teknis ini adalah memverifikasi kode. Opsi berikut dapat dikonfigurasi untuk mode ini.

Klaim input

Elemen InputClaims berisi daftar klaim untuk dikirim ke Microsoft Entra SSPR. Anda juga dapat memetakan nama klaim Anda ke nama yang ditentukan dalam profil teknis SSPR.

ClaimReferenceId Diperlukan Deskripsi
alamat email Ya Alamat email yang sama seperti yang digunakan sebelumnya untuk mengirim kode. Ini juga digunakan untuk menemukan sesi verifikasi email. Properti PartnerClaimType klaim input harus diatur ke emailAddress.
Kode verifikasi Ya Kode verifikasi yang disediakan oleh pengguna untuk diverifikasi. Properti PartnerClaimType klaim input harus diatur ke verificationCode.

Elemen InputClaimsTransformations mungkin berisi kumpulan elemen InputClaimsTransformation yang digunakan untuk memodifikasi klaim input atau menghasilkan yang baru sebelum memanggil layanan Microsoft Entra SSPR.

Klaim output

Penyedia protokol Microsoft Entra SSPR tidak mengembalikan OutputClaims apa pun, sehingga tidak perlu menentukan klaim output. Namun, Anda dapat menyertakan klaim yang tidak dikembalikan oleh penyedia protokol Microsoft Entra SSPR selama Anda mengatur DefaultValue atribut.

Elemen OutputClaimsTransformations mungkin berisi kumpulan elemen OutputClaimsTransformation yang digunakan untuk memodifikasi klaim output atau menghasilkan yang baru.

Metainformasi

Karakteristik Diperlukan Deskripsi
Operasi Ya Harus VerifyCode

Elemen antarmuka pengguna

Metadata berikut dapat digunakan untuk mengonfigurasi pesan kesalahan yang ditampilkan setelah kegagalan verifikasi kode. Metadata harus dikonfigurasi dalam profil teknis yang ditegaskan sendiri . Pesan kesalahan dapat dilokalisasi.

Karakteristik Diperlukan Deskripsi
UserMessageIfChallengeExpired Pesan yang akan ditampilkan kepada pengguna jika sesi verifikasi kode telah kedaluwarsa. Kode telah kedaluwarsa atau kode belum pernah dibuat untuk pengidentifikasi tertentu.
UserMessageIfInternalError Pesan kesalahan pengguna jika server mengalami kesalahan internal.
UserMessageIfThrottled Pesan kesalahan pengguna jika permintaan telah dibatasi.
UserMessageIfVerificationFailedNoRetry Pesan untuk ditampilkan kepada pengguna jika mereka telah memberikan kode yang tidak valid, dan pengguna tidak diizinkan untuk memberikan kode yang benar.
UserMessageIfVerificationFailedRetryAllowed Pesan untuk ditampilkan kepada pengguna jika mereka telah memberikan kode yang tidak valid, dan pengguna diizinkan untuk memberikan kode yang benar.

Contoh: memverifikasi kode

Contoh berikut menunjukkan profil teknis Microsoft Entra ID SSPR yang digunakan untuk memverifikasi kode.

<TechnicalProfile Id="AadSspr-VerifyCode">
  <DisplayName>Verify Code</DisplayName>
  <Protocol Name="Proprietary" Handler="Web.TPEngine.Providers.AadSsprProtocolProvider, Web.TPEngine, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" />
  <Metadata>
    <Item Key="Operation">VerifyCode</Item>
  </Metadata>
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="verificationCode" PartnerClaimType="verificationCode" />
    <InputClaim ClaimTypeReferenceId="email" PartnerClaimType="emailAddress"/>
  </InputClaims>
</TechnicalProfile>