Menyiapkan pendaftaran dan masuk dengan akun Weibo - Azure AD B2C

2025-05-01

Penting

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

Sebelum memulai, gunakan pemilih Pilih jenis kebijakan di bagian atas halaman ini untuk memilih jenis kebijakan yang Anda siapkan. Azure Active Directory B2C menawarkan dua metode untuk menentukan cara pengguna berinteraksi dengan aplikasi Anda: melalui alur pengguna yang telah ditentukan sebelumnya atau melalui kebijakan kustom yang sepenuhnya dapat dikonfigurasi. Langkah yang diperlukan dalam artikel ini berbeda untuk setiap metode.

Nota

Fitur ini dalam tahap pratinjau publik.

Prasyarat

Buat alur pengguna agar pengguna dapat mendaftar dan masuk ke aplikasi Anda.
Daftarkan aplikasi web.

Selesaikan langkah-langkah dalam Mulai menggunakan kebijakan kustom di Active Directory B2C. Tutorial ini memandu Anda cara memperbarui file kebijakan kustom untuk menggunakan konfigurasi penyewa Azure AD B2C Anda.
Daftarkan aplikasi web.

Membuat aplikasi Weibo

Untuk mengaktifkan masuk bagi pengguna dengan akun Weibo di Azure Active Directory B2C (Azure AD B2C), Anda perlu membuat aplikasi di portal pengembang Weibo. Jika Anda belum memiliki akun Weibo, Anda dapat mendaftar di https://weibo.com.

Masuk ke portal pengembang Weibo dengan kredensial akun Weibo Anda.
Setelah masuk, pilih nama tampilan Anda di sudut kanan atas.
Di menu dropdown, pilih 编辑开发者信息 (edit informasi pengembang).
Masukkan informasi yang diperlukan dan pilih 提交 (kirim).
Selesaikan proses verifikasi email.
Buka halaman verifikasi identitas.
Masukkan informasi yang diperlukan dan pilih 提交 (kirim).

Mendaftarkan aplikasi Weibo

Buka halaman pendaftaran aplikasi Weibo baru.
Masukkan informasi aplikasi yang diperlukan.
Pilih 创建 (buat).
Salin nilai Kunci Aplikasi dan Rahasia Aplikasi. Anda memerlukan kedua hal ini untuk menambahkan penyedia identitas (IdP) ke tenant Anda.
Unggah foto yang diperlukan dan masukkan informasi yang diperlukan.
Pilih 保存以上信息 (simpan).
Pilih 高级信息 (informasi lanjutan).
Pilih 编辑 (edit) di samping bidang untuk OAuth2.0 授权设置 (URL pengalihan).
Untuk OAuth2.0 授权设置 (URL pengalihan), masukkan https://your-tenant-name.b2clogin.com/your-tenant-name.onmicrosoft.com/oauth2/authresp. Jika Anda menggunakan domain kustom, masukkan https://your-domain-name/your-tenant-name.onmicrosoft.com/oauth2/authresp. Ganti your-tenant-name dengan nama penyewa Anda, dan your-domain-name dengan domain kustom Anda.
Pilih 提交 (kirim).

Mengonfigurasi Weibo sebagai penyedia identitas

Masuk ke portal Microsoft Azure dengan akun yang memiliki setidaknya hak istimewa Administrator Penyedia Identitas Eksternal .
Jika Anda memiliki akses ke beberapa penyewa, pilih ikon Pengaturan di menu atas untuk beralih ke penyewa Azure AD B2C Anda dari menu Direktori + langganan .
Pilih Semua layanan di sudut kiri atas portal Microsoft Azure, cari dan pilih Azure AD B2C.
Pilih Penyedia identitas, lalu pilih Weibo (Pratinjau).
Masukkan nama . Misalnya, Weibo.
Untuk ID Klien, masukkan Kunci Aplikasi aplikasi Weibo yang Anda buat sebelumnya.
Untuk Rahasia klien, masukkan Rahasia Aplikasi yang Anda rekam.
Pilih Simpan.

Tambahkan penyedia identitas Weibo ke alur pengguna

Pada tenant Azure AD B2C Anda, pilih Alur pengguna.
Klik alur aliran pengguna tempat Anda ingin menambahkan penyedia identitas Weibo.
Di bawah Penyedia identitas sosial, pilih Weibo.
Pilih Simpan.
Untuk menguji kebijakan Anda, pilih Jalankan alur pengguna.
Untuk Aplikasi, pilih aplikasi web bernama testapp1 yang sebelumnya Anda daftarkan. URL Balasan harus menampilkan https://jwt.ms.
Klik tombol Jalankan alur pengguna.
Dari halaman pendaftaran atau masuk, pilih Weibo untuk masuk dengan akun Weibo.

Jika proses masuk berhasil, browser Anda dialihkan ke https://jwt.ms, yang menampilkan konten token yang dikembalikan oleh Azure AD B2C.

Membuat kunci kebijakan

Anda perlu menyimpan kunci rahasia klien yang telah Anda catat sebelumnya di penyewa Azure AD B2C Anda.

Masuk ke portal Azure.
Jika Anda memiliki akses ke beberapa penyewa, pilih ikon Pengaturan di menu atas untuk beralih ke penyewa Azure AD B2C Anda dari menu Direktori + langganan .
Pilih Semua layanan di sudut kiri atas portal Microsoft Azure, lalu cari dan pilih Azure AD B2C.
Pada halaman Gambaran Umum, pilih Kerangka Kerja Pengalaman Identitas.
Pilih Kunci Kebijakan lalu pilih Tambahkan.
Untuk Opsi, pilih Manual.
Masukkan Nama untuk kunci kebijakan. Contohnya, WeiboSecret. Awalan B2C_1A_ ditambahkan secara otomatis ke nama kunci Anda.
Di Rahasia, masukkan rahasia klien yang sebelumnya Anda rekam.
Untuk Penggunaan kunci, pilih Signature.
Klik Buat.

Mengonfigurasi Weibo sebagai penyedia identitas

Untuk memungkinkan pengguna masuk menggunakan akun Weibo, Anda perlu menentukan akun sebagai penyedia klaim yang dapat berkomunikasi dengan Azure AD B2C melalui titik akhir. Titik akhir menyediakan serangkaian klaim yang digunakan oleh Azure AD B2C untuk memverifikasi bahwa pengguna tertentu telah diautentikasi.

Anda dapat menentukan akun Weibo sebagai penyedia klaim dengan menambahkannya ke elemen ClaimsProviders dalam file ekstensi kebijakan Anda.

Buka TrustFrameworkExtensions.xml.
Temukan elemen ClaimsProviders . Jika tidak ada, tambahkan di bawah elemen utama.

Tambahkan ClaimsProvider baru sebagai berikut:

<ClaimsProvider>
  <Domain>weibo.com</Domain>
  <DisplayName>Weibo (Preview)</DisplayName>
  <TechnicalProfiles>
    <TechnicalProfile Id="Weibo-OAuth2">
      <DisplayName>Weibo</DisplayName>
      <Protocol Name="OAuth2" />
      <Metadata>
        <Item Key="ProviderName">weibo</Item>
        <Item Key="authorization_endpoint">https://api.weibo.com/oauth2/authorize</Item>
        <Item Key="AccessTokenEndpoint">https://api.weibo.com/oauth2/access_token</Item>
        <Item Key="ClaimsEndpoint">https://api.weibo.com/2/account/get_uid.json</Item>
        <Item Key="scope">email</Item>
        <Item Key="HttpBinding">POST</Item>
        <Item Key="external_user_identity_claim_id">uid</Item>
        <Item Key="client_id">Your Weibo application ID</Item>
      </Metadata>
      <CryptographicKeys>
        <Key Id="client_secret" StorageReferenceId="B2C_1A_WeiboSecret" />
      </CryptographicKeys>
      <OutputClaims>
        <OutputClaim ClaimTypeReferenceId="numericUserId" PartnerClaimType="uid" />
        <OutputClaim ClaimTypeReferenceId="identityProvider" DefaultValue="weibo.com" AlwaysUseDefaultValue="true" />
        <OutputClaim ClaimTypeReferenceId="displayName" DefaultValue="Weibo User" />
        <OutputClaim ClaimTypeReferenceId="authenticationSource" DefaultValue="socialIdpAuthentication" AlwaysUseDefaultValue="true" />
        <OutputClaim ClaimTypeReferenceId="UserId" />
      </OutputClaims>
      <OutputClaimsTransformations>
        <OutputClaimsTransformation ReferenceId="CreateIssuerUserId" />
        <OutputClaimsTransformation ReferenceId="CreateRandomUPNUserName"/>
        <OutputClaimsTransformation ReferenceId="CreateUserPrincipalName"/>
        <OutputClaimsTransformation ReferenceId="CreateAlternativeSecurityId"/>
        <OutputClaimsTransformation ReferenceId="CreateSubjectClaimFromAlternativeSecurityId"/>
      </OutputClaimsTransformations>
      <UseTechnicalProfileForSessionManagement ReferenceId="SM-SocialLogin" />
    </TechnicalProfile>
  </TechnicalProfiles>
</ClaimsProvider>
<ClaimsProvider>

Atur client_id ke ID aplikasi dari pendaftaran aplikasi.
Simpan file tersebut.

Tambahkan transformasi klaim

Profil teknis GitHub mengharuskan transformasi klaim CreateIssuerUserId ditambahkan ke daftar ClaimsTransformations. Jika Anda tidak memiliki elemen ClaimsTransformations yang ditentukan dalam file Anda, tambahkan elemen XML induk seperti yang ditunjukkan di bawah ini. Transformasi klaim juga memerlukan jenis klaim baru yang ditentukan bernama numericUserId.

Cari elemen BuildingBlocks . Jika elemen tidak ada, tambahkan elemen tersebut.
Temukan elemen ClaimsSchema . Jika elemen tidak ada, tambahkan elemen tersebut.
Tambahkan klaim numericUserId ke elemen ClaimsSchema .
Temukan elemen ClaimsTransformations . Jika elemen tidak ada, tambahkan elemen tersebut.
Tambahkan transformasi klaim CreateIssuerUserId ke elemen ClaimsTransformations .

<BuildingBlocks>
  <ClaimsSchema>
    <ClaimType Id="numericUserId">
      <DisplayName>Numeric user Identifier</DisplayName>
      <DataType>long</DataType>
    </ClaimType>
  </ClaimsSchema>
  <ClaimsTransformations>
    <ClaimsTransformation Id="CreateIssuerUserId" TransformationMethod="ConvertNumberToStringClaim">
      <InputClaims>
        <InputClaim ClaimTypeReferenceId="numericUserId" TransformationClaimType="inputClaim" />
      </InputClaims>
      <OutputClaims>
        <OutputClaim ClaimTypeReferenceId="issuerUserId" TransformationClaimType="outputClaim" />
      </OutputClaims>
    </ClaimsTransformation>
  </ClaimsTransformations>
</BuildingBlocks>

Menambahkan perjalanan pengguna

Pada titik ini, penyedia identitas telah disiapkan, tetapi belum tersedia di salah satu halaman login. Jika Anda tidak memiliki perjalanan pengguna kustom Anda sendiri, buat duplikat perjalanan pengguna templat yang ada, jika tidak, lanjutkan ke langkah berikutnya.

Buka file TrustFrameworkBase.xml dari paket pemula.
Temukan dan salin seluruh konten elemen UserJourney yang menyertakan Id="SignUpOrSignIn".
Buka TrustFrameworkExtensions.xml dan temukan elemen UserJourneys . Jika elemen tidak ada, tambahkan elemen.
Tempelkan seluruh konten elemen UserJourney yang Anda salin sebagai anak dari elemen UserJourneys.
Ganti nama Id perjalanan pengguna. Contohnya, Id="CustomSignUpSignIn".

Menambahkan Penyedia Identitas ke alur pengguna

Sekarang setelah Anda memiliki alur pengguna, tambahkan penyedia identitas baru ke alur pengguna. Anda terlebih dahulu menambahkan tombol masuk, lalu menautkan tombol ke tindakan. Tindakan tersebut adalah profil teknis yang telah Anda buat sebelumnya.

Temukan elemen tahap orkestrasi yang menyertakan Type="CombinedSignInAndSignUp", atau Type="ClaimsProviderSelection" dalam perjalanan pengguna. Biasanya ini adalah langkah orkestrasi pertama. Elemen ClaimsProviderSelections berisi daftar penyedia identitas yang dapat digunakan pengguna untuk masuk. Urutan elemen mengontrol urutan tombol masuk yang disajikan kepada pengguna. Tambahkan elemen XML ClaimsProviderSelection . Atur nilai TargetClaimsExchangeId ke nama yang mudah diingat.
Pada langkah orkestrasi berikutnya, tambahkan elemen ClaimsExchange . Atur Id ke nilai id pertukaran klaim target. Perbarui nilai TechnicalProfileReferenceId ke Id profil teknis yang Anda buat sebelumnya.

XML berikut menunjukkan dua langkah orkestrasi pertama perjalanan pengguna dengan penyedia identitas:

<OrchestrationStep Order="1" Type="CombinedSignInAndSignUp" ContentDefinitionReferenceId="api.signuporsignin">
  <ClaimsProviderSelections>
    ...
    <ClaimsProviderSelection TargetClaimsExchangeId="WeiboExchange" />
  </ClaimsProviderSelections>
  ...
</OrchestrationStep>

<OrchestrationStep Order="2" Type="ClaimsExchange">
  ...
  <ClaimsExchanges>
    <ClaimsExchange Id="WeiboExchange" TechnicalProfileReferenceId="Weibo-OAuth2" />
  </ClaimsExchanges>
</OrchestrationStep>

Mengonfigurasi kebijakan pihak terandal

Kebijakan pihak yang mengandalkan, misalnya SignUpSignIn.xml, menentukan perjalanan pengguna yang akan dijalankan Azure AD B2C. Temukan elemen DefaultUserJourney dalam pihak yang memercayai. Perbarui ReferenceId agar sesuai dengan ID perjalanan pengguna, di mana Anda menambahkan penyedia identitas.

Dalam contoh berikut, untuk CustomSignUpSignIn alur pengguna, ReferenceId ditentukan menjadi CustomSignUpSignIn:

<RelyingParty>
  <DefaultUserJourney ReferenceId="CustomSignUpSignIn" />
  ...
</RelyingParty>

Mengunggah kebijakan kustom

Masuk ke portal Azure.
Pilih ikon Direktori + Langganan di toolbar portal, lalu pilih direktori yang berisi penyewa Azure AD B2C Anda.
Di portal Microsoft Azure, cari dan pilih AAD B2C.
Di bawah Kebijakan, pilih Kerangka Kerja Pengalaman Identitas.
Pilih Unggah Kebijakan Kustom, lalu unggah dua file kebijakan yang Anda ubah, dalam urutan berikut: kebijakan ekstensi, misalnya TrustFrameworkExtensions.xml, lalu kebijakan pihak yang mengandalkan, seperti SignUpSignIn.xml.

Menguji kebijakan khusus Anda

Pilih kebijakan pihak kepercayaan Anda, misalnya B2C_1A_signup_signin.
Untuk Aplikasi , pilih aplikasi web yang sebelumnya Anda daftarkan . URL Balasan harus menampilkan https://jwt.ms.
Pilih tombol Jalankan sekarang.
Dari halaman pendaftaran atau masuk, pilih Weibo untuk masuk dengan akun Weibo.

Jika proses masuk berhasil, browser Anda dialihkan ke https://jwt.ms, yang menampilkan konten token yang dikembalikan oleh Azure AD B2C.

Bagikan melalui

Menyiapkan pendaftaran dan masuk dengan akun Weibo menggunakan Azure Active Directory B2C

Prasyarat

Membuat aplikasi Weibo

Mendaftarkan aplikasi Weibo

Mengonfigurasi Weibo sebagai penyedia identitas

Tambahkan penyedia identitas Weibo ke alur pengguna

Membuat kunci kebijakan

Mengonfigurasi Weibo sebagai penyedia identitas

Tambahkan transformasi klaim

Menambahkan perjalanan pengguna

Menambahkan Penyedia Identitas ke alur pengguna

Mengonfigurasi kebijakan pihak terandal

Mengunggah kebijakan kustom

Menguji kebijakan khusus Anda

Saran dan Komentar

Sumber Daya Tambahan: