Bagikan melalui

Cara mengotorisasi akun pengembang dengan menggunakan ID Eksternal Microsoft Entra

BERLAKU UNTUK: Pengembang | Dasar v2 | Standar | Standar v2 | Premium | Premium v2

MICROSOFT Entra External ID adalah solusi manajemen identitas cloud yang memungkinkan identitas eksternal mengakses aplikasi dan sumber daya Anda dengan aman. Anda dapat menggunakannya untuk mengelola akses ke portal pengembang API Management Anda dengan identitas eksternal.

Dalam artikel ini, Anda mempelajari konfigurasi idP Microsoft Entra ID untuk skenario berikut yang didukung oleh portal pengembang API Management:

  • Integrasi dengan MICROSOFT Entra External ID di penyewa tenaga kerja Anda. Misalnya, jika penyewa tenaga kerja Anda adalah untuk organisasi Contoso, Anda mungkin ingin mengonfigurasi Google atau Facebook sebagai penyedia identitas eksternal sehingga pengguna eksternal ini juga dapat masuk menggunakan akun mereka.
  • Integrasi dengan Microsoft Entra External ID di tenant eksternal terpisah. Konfigurasi ini hanya memungkinkan pengguna eksternal dari penyewa tersebut untuk masuk ke portal pengembang.

Nota

Saat ini, Anda tidak dapat mengonfigurasi lebih dari satu id Microsoft Entra ID untuk portal pengembang.

Untuk gambaran umum opsi untuk mengamankan akses ke portal pengembang, lihat Mengamankan akses ke portal pengembang API Management.

Nota

API Management menyediakan dukungan warisan untuk Azure Active Directory B2C sebagai penyedia identitas eksternal. Namun, kami sarankan Anda menggunakan MICROSOFT Entra External ID sebagai penyedia identitas alih-alih Azure Active Directory B2C untuk penyebaran baru portal pengembang API Management.

Penting

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

Prasyarat

Tambahkan penyedia identitas eksternal ke penyewa Anda

Jika Anda menggunakan tenant tenaga kerja, penyedia identitas eksternal harus diaktifkan di tenant tenaga kerja Anda. Mengonfigurasi penyedia identitas eksternal berada di luar cakupan artikel ini. Untuk informasi selengkapnya, lihat Penyedia identitas untuk ID Eksternal pada tenant tenaga kerja.

Membuat pendaftaran aplikasi Microsoft Entra

Buat pendaftaran aplikasi di penyewa MICROSOFT Entra ID Anda. Pendaftaran aplikasi mewakili aplikasi portal pengembang di Microsoft Entra dan memungkinkan portal untuk memasukkan pengguna dengan menggunakan ID Microsoft Entra.

  1. Di portal Azure, buka Microsoft Entra ID.
  2. Di menu bar samping, di bawah Kelola, pilih Pendaftaran> aplikasi+ Pendaftaran baru.
  3. Di halaman Daftarkan aplikasi , masukkan informasi pendaftaran aplikasi Anda.
    • Di bagian Nama , masukkan nama aplikasi yang Anda pilih.
    • Di bagian Jenis akun yang didukung , pilih Akun hanya di direktori organisasi ini.
    • Di URI Pengalihan, pilih Aplikasi halaman tunggal (SPA) dan masukkan URL berikut: https://{your-api-management-service-name}.developer.azure-api.net/signin, di mana {your-api-management-service-name} adalah nama instans API Management Anda.
    • Pilih Daftar untuk membuat aplikasi. 1.Pada halaman Gambaran Umum aplikasi, temukan ID Aplikasi (klien) dan ID Direktori (penyewa) dan salin nilai-nilai ini ke lokasi yang aman. Anda membutuhkannya nanti.
  4. Di menu bilah samping, di bawah Kelola, pilih Sertifikat & rahasia.
  5. Dari halaman Sertifikat & rahasia , pada tab Rahasia klien , pilih + Rahasia klien baru.
    • Masukkan Deskripsi.
    • Pilih opsi apa pun untuk Kedaluwarsa.
    • Pilih Tambahkan.
  6. Salin nilai Rahasia klien ke lokasi yang aman sebelum meninggalkan halaman. Anda akan membutuhkannya nanti.
  7. Di menu bar samping, di bawah Kelola, pilih Konfigurasi> token+ Tambahkan klaim opsional.
    1. Di Jenis token, pilih ID.
    2. Pilih (centang) klaim berikut: email, family_name, given_name.
    3. Pilih Tambahkan. Jika diminta, pilih Aktifkan email Microsoft Graph, izin profil.

Mengaktifkan pendaftaran layanan mandiri untuk penyewa Anda

Agar pengguna eksternal mendaftar untuk akses ke portal pengembang, Anda harus menyelesaikan langkah-langkah berikut:

  • Aktifkan pendaftaran layanan mandiri untuk penyewa Anda.
  • Tambahkan aplikasi Anda ke alur pengguna pendaftaran layanan mandiri.

Untuk informasi selengkapnya dan langkah-langkah terperinci, lihat artikel berikut ini, bergantung pada apakah Anda menggunakan tenaga kerja atau penyewa eksternal:

Mengonfigurasi ID Microsoft Entra sebagai penyedia identitas untuk portal pengembang

Di instans API Management Anda, konfigurasikan penyedia identitas Microsoft Entra ID. Anda memerlukan nilai yang Anda salin dari pendaftaran aplikasi di bagian sebelumnya.

  1. Di tab portal Microsoft Azure , navigasikan ke instans API Management Anda.

  2. Di menu bilah samping, di bawah Portal pengembang, pilih Identitas>+ Tambahkan.

  3. Di halaman Tambahkan IdP , pilih ID Microsoft Entra. Setelah dipilih, Anda dapat memasukkan informasi lain yang diperlukan.

    1. Di id klien, masukkan ID Aplikasi (klien) dari pendaftaran aplikasi Anda.
    2. Di Rahasia klien, masukkan nilai Rahasia dari pendaftaran aplikasi Anda.
    3. Dalam Tenant Masuk, masukkan ID Direktori (tenant) dari registrasi aplikasi Anda.
    • Di menu dropdown Pustaka klien , pilih MSAL.

  4. Pilih Tambahkan.

    Cuplikan layar konfigurasi penyedia identitas ID Microsoft Entra di portal.

  5. Terbitkan ulang portal pengembang agar konfigurasi Microsoft Entra berlaku. Di menu bilah samping, di bawah Portal pengembang, pilih Gambaran umum> portalTerbitkan.

Penting

Anda perlu menerbitkan ulang portal pengembang saat membuat atau memperbarui pengaturan konfigurasi penyedia identitas agar perubahan diterapkan.

Masuk ke portal pengembang dengan MICROSOFT Entra External ID

Di portal pengembang, masuk dengan Microsoft Entra External ID dapat dilakukan menggunakan widget tombol Masuk OAuth. Widget sudah disertakan pada halaman masuk konten portal pengembang default.

  1. Untuk masuk dengan menggunakan MICROSOFT Entra External ID, buka jendela browser baru dan buka portal pengembang. Pilih Masuk.

  2. Pada halaman Masuk , pilih Azure Active Directory.

    Cuplikan layar pilih Azure Active Directory pada halaman Masuk di portal pengembang.

  3. Di jendela masuk untuk penyewa Microsoft Entra Anda, pilih Opsi masuk. Pilih penyedia identitas yang telah Anda konfigurasi di penyewa Microsoft Entra Anda untuk masuk. Misalnya, jika Anda mengonfigurasi Google sebagai penyedia identitas, pilih Masuk dengan Google.

    Cuplikan layar penyedia identitas eksternal tertentu di Microsoft Entra.

Untuk melanjutkan masuk, tanggapi perintah. Setelah proses masuk selesai, Anda dialihkan kembali ke portal pengembang.

Anda sekarang masuk ke portal pengembang untuk instans layanan API Management Anda. Anda ditambahkan sebagai identitas pengguna baru di bagian Pengguna dalam API Management, dan sebagai pengguna penyewa eksternal baru di Microsoft Entra ID.

Konten terkait

  • Last updated on