Mendaftarkan aplikasi di penyewa eksternal Anda

Berlaku untuk: Penyewa Tenaga Kerja Penyewa eksternal (pelajari lebih lanjut)

MICROSOFT Entra External ID memungkinkan organisasi Anda mengelola identitas pelanggan, dan mengontrol akses dengan aman ke aplikasi dan API publik Anda. Aplikasi tempat pelanggan Anda dapat membeli produk Anda, berlangganan layanan Anda, atau mengakses akun dan data mereka. Pelanggan Anda hanya perlu masuk di perangkat atau browser web sekali dan memiliki akses ke semua aplikasi Anda, Anda memberi mereka izin.

Untuk mengaktifkan aplikasi Anda untuk masuk dengan ID Eksternal, Anda perlu mendaftarkan aplikasi Anda dengan ID Eksternal. Pendaftaran aplikasi menetapkan hubungan kepercayaan antara aplikasi dan ID Eksternal. Selama pendaftaran aplikasi, Anda menentukan URI pengalihan. URI pengalihan adalah titik akhir tempat pengguna dialihkan oleh ID Eksternal setelah mereka mengautentikasi. Proses pendaftaran aplikasi menghasilkan ID aplikasi, dikenal juga sebagai ID klien, yang secara unik mengidentifikasi aplikasi Anda.

ID eksternal mendukung autentikasi untuk berbagai arsitektur aplikasi modern, misalnya aplikasi web atau aplikasi satu halaman. Interaksi setiap jenis aplikasi dengan penyewa eksternal berbeda, oleh karena itu, Anda harus menentukan jenis aplikasi yang ingin Anda daftarkan.

Dalam artikel ini, Anda mempelajari cara mendaftarkan aplikasi di penyewa eksternal Anda.

Prasyarat

• Akun Azure yang memiliki langganan aktif. Buat akun secara gratis.
• Penyewa eksternal Anda. Jika Anda belum memilikinya, daftar untuk uji coba gratis.

Pilih jenis aplikasi Anda

Aplikasi satu halaman (SPA)

Daftarkan aplikasi Halaman tunggal Anda

ID eksternal mendukung autentikasi untuk Aplikasi halaman tunggal (SPAs).

Langkah-langkah berikut menunjukkan cara mendaftarkan SPA Anda di pusat admin Microsoft Entra:

1. Masuk ke pusat admin Microsoft Entra setidaknya sebagai Pengembang Aplikasi.

2. Jika Anda memiliki akses ke beberapa penyewa, gunakan ikon Pengaturan di menu atas untuk beralih ke penyewa eksternal Anda dari menu Direktori + langganan.

3. Telusuri Aplikasi >Identitas>Pendaftaran aplikasi.

4. Pilih + Pendaftaran baru.

5. Di halaman Daftarkan aplikasi yang muncul, masukkan informasi pendaftaran aplikasi Anda:

   1. Di bagian Nama , masukkan nama aplikasi yang bermakna yang ditampilkan kepada pengguna aplikasi, misalnya ciam-client-app.

   2. Di bawah Jenis akun yang didukung, pilih Hanya akun dalam direktori organisasi ini.

   3. Di bawah URI Pengalihan (opsional), pilih Aplikasi halaman tunggal (SPA) lalu, di kotak URL, masukkan http://localhost:3000/.

6. Pilih Daftarkan.

7. Panel Gambaran Umum aplikasi ditampilkan saat pendaftaran selesai. Rekam ID Direktori (penyewa) dan ID Aplikasi (klien) yang akan digunakan dalam kode sumber aplikasi Anda.

Tentang URI pengalihan

URI pengalihan adalah titik akhir tempat pengguna dikirim oleh server otorisasi (dalam hal ini, ID Microsoft Entra) setelah menyelesaikan interaksinya dengan pengguna, dan ke mana token akses atau kode otorisasi dikirim ke setelah otorisasi berhasil.

Dalam aplikasi produksi, hal ini biasanya adalah titik akhir yang dapat diakses publik tempat aplikasi Anda berjalan, seperti https://contoso.com/auth-response.

Selama pengembangan aplikasi, Anda dapat menambahkan titik akhir di mana aplikasi Anda mendengarkan secara lokal, seperti http://localhost:3000. Anda dapat menambahkan dan mengubah URI pengalihan di aplikasi Anda yang telah terdaftar kapan saja.

Pembatasan berikut berlaku untuk mengalihkan URI:

• URL balasan harus dimulai dengan skema https, kecuali Anda menggunakan URL pengalihan localhost.

• URL balasan peka huruf besar/kecil. Ukuran huruf harus sesuai dengan ukuran huruf pada jalur URL pada aplikasi berjalan. Misalnya, jika aplikasi Anda termasuk sebagai bagian dari jalurnya .../abc/response-oidc, jangan tentukan .../ABC/response-oidc di URL balasan. Karena browser web memperlakukan jalur sebagai peka huruf besar/kecil, cookie yang terkait dengan .../abc/response-oidc dapat dikecualikan jika dialihkan ke URL .../ABC/response-oidc yang ukuran hurufnya tidak cocok.

• URL balasan harus menyertakan atau mengecualikan garis miring ke depan seperti yang diharapkan oleh aplikasi Anda. Misalnya, https://contoso.com/auth-response dan https://contoso.com/auth-response/ mungkin diperlakukan sebagai URL yang tidak cocok di aplikasi Anda.

Memberikan izin admin

Setelah Anda mendaftarkan aplikasi, aplikasi akan diberi izin User.Read . Namun, karena penyewa adalah penyewa eksternal, pengguna pelanggan itu sendiri tidak dapat menyetujui izin ini. Anda sebagai admin harus menyetujui izin ini atas nama semua pengguna di penyewa:

1. Dari halaman Pendaftaran aplikasi, pilih aplikasi yang Anda buat (seperti ciam-client-app) untuk membuka halaman Gambaran Umumnya.

2. Di bagian Kelola, pilih Izin API.

   1. Pilih Berikan persetujuan admin untuk <nama> penyewa Anda, lalu pilih Ya.
   2. Pilih Refresh, lalu verifikasi bahwa Diberikan untuk <nama> penyewa Anda muncul di bawah Status untuk izin tersebut.

Berikan izin API (opsional):

Jika SPA Anda perlu memanggil API, Anda harus memberikan izin SPA API Anda sehingga dapat memanggil API. Anda juga harus mendaftarkan API web yang perlu Anda panggil.

Untuk memberikan izin API aplikasi klien Anda (ciam-client-app), ikuti langkah-langkah berikut:

1. Dari halaman Pendaftaran aplikasi, pilih aplikasi yang Anda buat (seperti ciam-client-app) untuk membuka halaman Gambaran Umumnya.

2. Di bagian Kelola, pilih Izin API.

3. Di Izin yang dikonfigurasi, pilih Tambahkan izin.

4. Pilih tab API yang digunakan organisasi saya.

5. Dalam daftar API, pilih API seperti ciam-ToDoList-api.

6. Pilih opsi Izin yang didelegasikan.

7. Dari daftar izin, pilih ToDoList.Read, ToDoList.ReadWrite (gunakan kotak pencarian jika perlu).

8. Pilih tombol Tambahkan izin akses. Pada titik ini, Anda telah menetapkan izin dengan benar. Namun, karena penyewa adalah penyewa pelanggan, pengguna konsumen itu sendiri tidak dapat menyetujui izin ini. Untuk mengatasi masalah ini, Anda sebagai admin harus menyetujui izin ini atas nama semua pengguna di penyewa:

   1. Pilih Berikan persetujuan admin untuk <nama> penyewa Anda, lalu pilih Ya.

   2. Pilih Refresh, lalu verifikasi bahwa Diberikan untuk <nama> penyewa Anda muncul di bawah Status untuk kedua cakupan.

9. Dari daftar Izin yang dikonfigurasi, pilih izin ToDoList.Read dan ToDoList.ReadWrite, satu per satu, lalu salin URI lengkap izin untuk digunakan nanti. URI izin lengkap terlihat mirip dengan api://{clientId}/{ToDoList.Read} atau api://{clientId}/{ToDoList.ReadWrite}.

Jika Anda ingin mempelajari cara mengekspos izin dengan menambahkan tautan, buka bagian API Web.

Menguji alur pengguna (opsional)

Untuk menguji alur pengguna dengan pendaftaran aplikasi ini, aktifkan alur pemberian izin implisit untuk autentikasi.

Penting

Alur implisit harus digunakan hanya untuk tujuan pengujian dan bukan untuk mengautentikasi pengguna di aplikasi produksi Anda. Setelah Anda selesai menguji, sebaiknya hapus.

Untuk mengaktifkan alur implisit, ikuti langkah-langkah berikut:

1. Masuk ke pusat admin Microsoft Entra setidaknya sebagai Pengembang Aplikasi.
2. Jika Anda memiliki akses ke beberapa penyewa, gunakan ikon Pengaturan di menu atas untuk beralih ke penyewa eksternal Anda dari menu Direktori + langganan.
3. Telusuri Aplikasi >Identitas>Pendaftaran aplikasi.
4. Pilih pendaftaran aplikasi yang Anda buat.
5. Di bagian Kelola, pilih Autentikasi.
6. Di bagian Izin implisit dan alur hibrid, pilih kotak centang Token ID (digunakan untuk alur implisit dan hibrid).
7. Pilih Simpan.

Aplikasi web

Daftarkan aplikasi Web Anda

ID eksternal mendukung autentikasi untuk aplikasi web.

Langkah-langkah berikut menunjukkan cara mendaftarkan aplikasi web Anda di pusat admin Microsoft Entra:

1. Masuk ke pusat admin Microsoft Entra setidaknya sebagai Pengembang Aplikasi.

2. Jika Anda memiliki akses ke beberapa penyewa, gunakan ikon Pengaturan di menu atas untuk beralih ke penyewa eksternal Anda dari menu Direktori + langganan.

3. Telusuri Aplikasi >Identitas>Pendaftaran aplikasi.

4. Pilih + Pendaftaran baru.

5. Di halaman Daftarkan aplikasi yang muncul, masukkan informasi pendaftaran aplikasi Anda:

   1. Di bagian Nama , masukkan nama aplikasi yang bermakna yang ditampilkan kepada pengguna aplikasi, misalnya ciam-client-app.

   2. Di bawah Jenis akun yang didukung, pilih Hanya akun dalam direktori organisasi ini.

   3. Di bawah URI Pengalihan (opsional), pilih Web lalu, dalam kotak URL, masukkan URL seperti, http://localhost:3000/.

6. Pilih Daftarkan.

7. Panel Gambaran Umum aplikasi ditampilkan saat pendaftaran selesai. Rekam ID Direktori (penyewa) dan ID Aplikasi (klien) yang akan digunakan dalam kode sumber aplikasi Anda.

Tentang URI pengalihan

URI pengalihan adalah titik akhir tempat pengguna dikirim oleh server otorisasi (dalam hal ini, ID Microsoft Entra) setelah menyelesaikan interaksinya dengan pengguna, dan ke mana token akses atau kode otorisasi dikirim ke setelah otorisasi berhasil.

Dalam aplikasi produksi, hal ini biasanya adalah titik akhir yang dapat diakses publik tempat aplikasi Anda berjalan, seperti https://contoso.com/auth-response.

Selama pengembangan aplikasi, Anda dapat menambahkan titik akhir di mana aplikasi Anda mendengarkan secara lokal, seperti http://localhost:3000. Anda dapat menambahkan dan mengubah URI pengalihan di aplikasi Anda yang telah terdaftar kapan saja.

Pembatasan berikut berlaku untuk mengalihkan URI:

• URL balasan harus dimulai dengan skema https, kecuali Anda menggunakan URL pengalihan localhost.

• URL balasan peka huruf besar/kecil. Ukuran huruf harus sesuai dengan ukuran huruf pada jalur URL pada aplikasi berjalan. Misalnya, jika aplikasi Anda termasuk sebagai bagian dari jalurnya .../abc/response-oidc, jangan tentukan .../ABC/response-oidc di URL balasan. Karena browser web memperlakukan jalur sebagai peka huruf besar/kecil, cookie yang terkait dengan .../abc/response-oidc dapat dikecualikan jika dialihkan ke URL .../ABC/response-oidc yang ukuran hurufnya tidak cocok.

• URL balasan harus menyertakan atau mengecualikan garis miring ke depan seperti yang diharapkan oleh aplikasi Anda. Misalnya, https://contoso.com/auth-response dan https://contoso.com/auth-response/ mungkin diperlakukan sebagai URL yang tidak cocok di aplikasi Anda.

Memberikan izin admin

Setelah Anda mendaftarkan aplikasi, aplikasi akan diberi izin User.Read . Namun, karena penyewa adalah penyewa eksternal, pengguna pelanggan itu sendiri tidak dapat menyetujui izin ini. Anda sebagai admin harus menyetujui izin ini atas nama semua pengguna di penyewa:

1. Dari halaman Pendaftaran aplikasi, pilih aplikasi yang Anda buat (seperti ciam-client-app) untuk membuka halaman Gambaran Umumnya.

2. Di bagian Kelola, pilih Izin API.

   1. Pilih Berikan persetujuan admin untuk <nama> penyewa Anda, lalu pilih Ya.
   2. Pilih Refresh, lalu verifikasi bahwa Diberikan untuk <nama> penyewa Anda muncul di bawah Status untuk izin tersebut.

Membuat rahasia klien

 

Buat rahasia klien untuk aplikasi terdaftar. Aplikasi ini menggunakan rahasia klien untuk membuktikan identitasnya ketika meminta token.

1. Dari halaman Pendaftaran aplikasi, pilih aplikasi yang Anda buat (seperti ciam-client-app) untuk membuka halaman Gambaran Umumnya.
2. Di bagian Kelola, pilih Sertifikat & rahasia.
3. Pilih Rahasia klien baru.
4. Dalam kotak Deskripsi , masukkan deskripsi untuk rahasia klien (misalnya, rahasia klien aplikasi ciam).
5. Di bawah Kedaluwarsa, pilih durasi yang rahasianya valid (sesuai aturan keamanan organisasi Anda), lalu pilih Tambahkan.
6. Catat Nilai rahasia. Anda akan menggunakan nilai ini untuk konfigurasi pada langkah selanjutnya. Nilai rahasia tidak akan ditampilkan lagi, dan tidak dapat diambil dengan cara apa pun, setelah Anda menavigasi jauh dari Sertifikat dan rahasia. Pastikan Anda merekamnya.

Memberikan izin API (opsional)

Jika aplikasi web Anda perlu memanggil API, Anda harus memberikan izin API aplikasi web Anda sehingga dapat memanggil API. Anda juga harus mendaftarkan API web yang perlu Anda panggil.

Untuk memberikan izin API aplikasi klien Anda (ciam-client-app), ikuti langkah-langkah berikut:

1. Dari halaman Pendaftaran aplikasi, pilih aplikasi yang Anda buat (seperti ciam-client-app) untuk membuka halaman Gambaran Umumnya.

2. Di bagian Kelola, pilih Izin API.

3. Di Izin yang dikonfigurasi, pilih Tambahkan izin.

4. Pilih tab API yang digunakan organisasi saya.

5. Dalam daftar API, pilih API seperti ciam-ToDoList-api.

6. Pilih opsi Izin yang didelegasikan.

7. Dari daftar izin, pilih ToDoList.Read, ToDoList.ReadWrite (gunakan kotak pencarian jika perlu).

8. Pilih tombol Tambahkan izin akses. Pada titik ini, Anda telah menetapkan izin dengan benar. Namun, karena penyewa adalah penyewa pelanggan, pengguna konsumen itu sendiri tidak dapat menyetujui izin ini. Untuk mengatasi masalah ini, Anda sebagai admin harus menyetujui izin ini atas nama semua pengguna di penyewa:

   1. Pilih Berikan persetujuan admin untuk <nama> penyewa Anda, lalu pilih Ya.

   2. Pilih Refresh, lalu verifikasi bahwa Diberikan untuk <nama> penyewa Anda muncul di bawah Status untuk kedua cakupan.

9. Dari daftar Izin yang dikonfigurasi, pilih izin ToDoList.Read dan ToDoList.ReadWrite, satu per satu, lalu salin URI lengkap izin untuk digunakan nanti. URI izin lengkap terlihat mirip dengan api://{clientId}/{ToDoList.Read} atau api://{clientId}/{ToDoList.ReadWrite}.

Menguji alur pengguna (opsional)

Untuk menguji alur pengguna dengan pendaftaran aplikasi ini, aktifkan alur pemberian izin implisit untuk autentikasi.

Penting

Alur implisit harus digunakan hanya untuk tujuan pengujian dan bukan untuk mengautentikasi pengguna di aplikasi produksi Anda. Setelah Anda selesai menguji, sebaiknya hapus.

Untuk mengaktifkan alur implisit, ikuti langkah-langkah berikut:

1. Masuk ke pusat admin Microsoft Entra setidaknya sebagai Pengembang Aplikasi.
2. Jika Anda memiliki akses ke beberapa penyewa, gunakan ikon Pengaturan di menu atas untuk beralih ke penyewa eksternal Anda dari menu Direktori + langganan.
3. Telusuri Aplikasi >Identitas>Pendaftaran aplikasi.
4. Pilih pendaftaran aplikasi yang Anda buat.
5. Di bagian Kelola, pilih Autentikasi.
6. Di bagian Izin implisit dan alur hibrid, pilih kotak centang Token ID (digunakan untuk alur implisit dan hibrid).
7. Pilih Simpan.

API Web

Daftarkan API Web Anda

1. Masuk ke pusat admin Microsoft Entra setidaknya sebagai Pengembang Aplikasi.

2. Jika Anda memiliki akses ke beberapa penyewa, gunakan ikon Pengaturan di menu atas untuk beralih ke penyewa eksternal Anda dari menu Direktori + langganan.

3. Telusuri Aplikasi >Identitas>Pendaftaran aplikasi.

4. Pilih + Pendaftaran baru.

5. Di halaman Daftarkan aplikasi yang muncul, masukkan informasi pendaftaran aplikasi Anda:

   1. Di bagian Nama, masukkan nama aplikasi yang bermakna yang akan ditampilkan kepada pengguna aplikasi, misalnya ciam-ToDoList-api.

   2. Di bawah Jenis akun yang didukung, pilih Hanya akun dalam direktori organisasi ini.

6. Pilih Daftar untuk membuat aplikasi.

7. Panel Gambaran Umum aplikasi ditampilkan saat pendaftaran selesai. Rekam ID Direktori (penyewa) dan ID Aplikasi (klien) yang akan digunakan dalam kode sumber aplikasi Anda.

Mengekspos izin

API perlu menerbitkan minimal satu cakupan, juga disebut Izin Yang Didelegasikan, agar aplikasi klien mendapatkan token akses bagi pengguna dengan sukses. Untuk menerbitkan cakupan, ikuti langkah-langkah berikut:

1. Dari halaman Pendaftaran aplikasi, pilih aplikasi API yang Anda buat (ciam-ToDoList-api) untuk membuka halaman Gambaran Umumnya.

2. Di bagian Kelola, pilih Ekspos API.

3. Di bagian atas halaman, di samping URI ID Aplikasi, pilih tautan Tambahkan untuk menghasilkan URI yang unik untuk aplikasi ini.

4. Terima URI ID Aplikasi yang diusulkan seperti api://{clientId}, dan pilih Simpan. Saat aplikasi web Anda meminta token akses untuk API web, aplikasi web menambahkan URI sebagai awalan untuk setiap cakupan yang Anda tentukan untuk API.

5. Di bagian Cakupan yang ditentukan oleh API ini, pilih Tambahkan cakupan.

6. Masukkan nilai berikut yang menentukan akses baca ke API, lalu pilih Tambahkan cakupan untuk menyimpan perubahan Anda:

   Properti	Nilai
   Nama cakupan	ToDoList.Read
   Siapa yang dapat menyetujui	Hanya Admin
   Nama tampilan persetujuan admin	Membaca daftar Pengguna ToDo menggunakan 'TodoListApi'
   Deskripsi persetujuan admin	Izinkan aplikasi membaca daftar ToDo pengguna menggunakan 'TodoListApi'.
   Status	Diaktifkan

7. Pilih Tambahkan cakupan lagi, dan masukkan nilai berikut yang menentukan cakupan akses baca dan tulis ke API. Pilih Tambahkan cakupan untuk menyimpan perubahan Anda:

   Properti	Nilai
   Nama cakupan	ToDoList.ReadWrite
   Siapa yang dapat menyetujui	Hanya Admin
   Nama tampilan persetujuan admin	Membaca dan menulis daftar ToDo pengguna menggunakan 'ToDoListApi'
   Deskripsi persetujuan admin	Izinkan aplikasi membaca dan menulis daftar ToDo pengguna menggunakan 'ToDoListApi'
   Status	Diaktifkan

8. Di bawah Kelola, pilih Manifes untuk membuka editor manifes API.

9. Atur accessTokenAcceptedVersion properti ke 2.

10. Pilih Simpan.

Pelajari selengkapnya tentang prinsip hak istimewa paling sedikit saat menerbitkan izin untuk API web.

Menambahkan peran aplikasi

API perlu menerbitkan minimal satu peran aplikasi untuk aplikasi, juga disebut Izin Aplikasi, agar aplikasi klien mendapatkan token akses sebagai diri mereka sendiri. Izin aplikasi adalah jenis izin yang harus diterbitkan API ketika mereka ingin memungkinkan aplikasi klien berhasil mengautentikasi sebagai diri mereka sendiri dan tidak perlu memasukkan pengguna. Untuk menerbitkan izin aplikasi, ikuti langkah-langkah berikut:

1. Dari halaman Pendaftaran aplikasi, pilih aplikasi yang Anda buat (seperti ciam-ToDoList-api) untuk membuka halaman Gambaran Umumnya.

2. Di bawah Kelola, pilih Peran aplikasi.

3. Pilih Buat peran aplikasi, lalu masukkan nilai berikut, lalu pilih Terapkan untuk menyimpan perubahan Anda:

   Properti	Nilai
   Nama tampilan	ToDoList.Read.All
   Jenis anggota yang diizinkan	Aplikasi
   Nilai	ToDoList.Read.All
   Deskripsi	Izinkan aplikasi membaca daftar ToDo setiap pengguna menggunakan 'TodoListApi'

4. Pilih Buat peran aplikasi lagi, lalu masukkan nilai berikut untuk peran aplikasi kedua, lalu pilih Terapkan untuk menyimpan perubahan Anda:

   Properti	Nilai
   Nama tampilan	ToDoList.ReadWrite.All
   Jenis anggota yang diizinkan	Aplikasi
   Nilai	ToDoList.ReadWrite.All
   Deskripsi	Izinkan aplikasi membaca dan menulis daftar ToDo setiap pengguna menggunakan 'ToDoListApi'

Aplikasi Desktop atau Seluler

Mendaftarkan aplikasi Desktop atau Seluler Anda

Langkah-langkah berikut menunjukkan cara mendaftarkan aplikasi Anda di pusat admin Microsoft Entra:

1. Masuk ke pusat admin Microsoft Entra setidaknya sebagai Pengembang Aplikasi.

2. Jika Anda memiliki akses ke beberapa penyewa, gunakan ikon Pengaturan di menu atas untuk beralih ke penyewa eksternal Anda dari menu Direktori + langganan.

3. Telusuri Aplikasi >Identitas>Pendaftaran aplikasi.

4. Pilih + Pendaftaran baru.

5. Di halaman Daftarkan aplikasi yang muncul, masukkan informasi pendaftaran aplikasi Anda:

   1. Di bagian Nama , masukkan nama aplikasi yang bermakna yang ditampilkan kepada pengguna aplikasi, misalnya ciam-client-app.

   2. Di bawah Jenis akun yang didukung, pilih Hanya akun dalam direktori organisasi ini.

   3. Di bawah URI Pengalihan (opsional), pilih opsi Aplikasi seluler dan desktop lalu, di kotak URL, masukkan URI dengan skema unik. Misalnya, URI pengalihan aplikasi desktop Electron terlihat mirip dengan http://localhost sementara UI Aplikasi Multi-platform .NET (MAUI) terlihat mirip msal{ClientId}://authdengan .

6. Pilih Daftarkan.

7. Panel Gambaran Umum aplikasi ditampilkan saat pendaftaran selesai. Rekam ID Direktori (penyewa) dan ID Aplikasi (klien) yang akan digunakan dalam kode sumber aplikasi Anda.

Memberikan izin admin

Setelah Anda mendaftarkan aplikasi, aplikasi akan diberi izin User.Read . Namun, karena penyewa adalah penyewa eksternal, pengguna pelanggan itu sendiri tidak dapat menyetujui izin ini. Anda sebagai admin harus menyetujui izin ini atas nama semua pengguna di penyewa:

1. Dari halaman Pendaftaran aplikasi, pilih aplikasi yang Anda buat (seperti ciam-client-app) untuk membuka halaman Gambaran Umumnya.

2. Di bagian Kelola, pilih Izin API.

   1. Pilih Berikan persetujuan admin untuk <nama> penyewa Anda, lalu pilih Ya.
   2. Pilih Refresh, lalu verifikasi bahwa Diberikan untuk <nama> penyewa Anda muncul di bawah Status untuk izin tersebut.

Memberikan izin API (opsional)

Jika aplikasi seluler Anda perlu memanggil API, Anda harus memberikan izin API aplikasi seluler Anda sehingga dapat memanggil API. Anda juga harus mendaftarkan API web yang perlu Anda panggil.

Untuk memberikan izin API aplikasi klien Anda (ciam-client-app), ikuti langkah-langkah berikut:

1. Dari halaman Pendaftaran aplikasi, pilih aplikasi yang Anda buat (seperti ciam-client-app) untuk membuka halaman Gambaran Umumnya.

2. Di bagian Kelola, pilih Izin API.

3. Di Izin yang dikonfigurasi, pilih Tambahkan izin.

4. Pilih tab API yang digunakan organisasi saya.

5. Dalam daftar API, pilih API seperti ciam-ToDoList-api.

6. Pilih opsi Izin yang didelegasikan.

7. Dari daftar izin, pilih ToDoList.Read, ToDoList.ReadWrite (gunakan kotak pencarian jika perlu).

8. Pilih tombol Tambahkan izin akses. Pada titik ini, Anda telah menetapkan izin dengan benar. Namun, karena penyewa adalah penyewa pelanggan, pengguna konsumen itu sendiri tidak dapat menyetujui izin ini. Untuk mengatasi masalah ini, Anda sebagai admin harus menyetujui izin ini atas nama semua pengguna di penyewa:

   1. Pilih Berikan persetujuan admin untuk <nama> penyewa Anda, lalu pilih Ya.

   2. Pilih Refresh, lalu verifikasi bahwa Diberikan untuk <nama> penyewa Anda muncul di bawah Status untuk kedua cakupan.

9. Dari daftar Izin yang dikonfigurasi, pilih izin ToDoList.Read dan ToDoList.ReadWrite, satu per satu, lalu salin URI lengkap izin untuk digunakan nanti. URI izin lengkap terlihat mirip dengan api://{clientId}/{ToDoList.Read} atau api://{clientId}/{ToDoList.ReadWrite}.

Menguji alur pengguna (opsional)

Untuk menguji alur pengguna dengan pendaftaran aplikasi ini, aktifkan alur pemberian izin implisit untuk autentikasi.

Penting

Alur implisit harus digunakan hanya untuk tujuan pengujian dan bukan untuk mengautentikasi pengguna di aplikasi produksi Anda. Setelah Anda selesai menguji, sebaiknya hapus.

Untuk mengaktifkan alur implisit, ikuti langkah-langkah berikut:

1. Masuk ke pusat admin Microsoft Entra setidaknya sebagai Pengembang Aplikasi.
2. Jika Anda memiliki akses ke beberapa penyewa, gunakan ikon Pengaturan di menu atas untuk beralih ke penyewa eksternal Anda dari menu Direktori + langganan.
3. Telusuri Aplikasi >Identitas>Pendaftaran aplikasi.
4. Pilih pendaftaran aplikasi yang Anda buat.
5. Di bagian Kelola, pilih Autentikasi.
6. Di bagian Izin implisit dan alur hibrid, pilih kotak centang Token ID (digunakan untuk alur implisit dan hibrid).
7. Pilih Simpan.

Aplikasi Daemon

Daftarkan aplikasi Daemon Anda

Langkah-langkah berikut menunjukkan cara mendaftarkan aplikasi daemon Anda di pusat admin Microsoft Entra:

1. Masuk ke pusat admin Microsoft Entra setidaknya sebagai Pengembang Aplikasi.

2. Jika Anda memiliki akses ke beberapa penyewa, gunakan ikon Pengaturan di menu atas untuk beralih ke penyewa eksternal Anda dari menu Direktori + langganan.

3. Telusuri Aplikasi >Identitas>Pendaftaran aplikasi.

4. Pilih + Pendaftaran baru.

5. Di halaman Daftarkan aplikasi yang muncul, masukkan informasi pendaftaran aplikasi Anda:

   1. Di bagian Nama , masukkan nama aplikasi yang bermakna yang akan ditampilkan kepada pengguna aplikasi, misalnya ciam-client-app.

   2. Di bawah Jenis akun yang didukung, pilih Hanya akun dalam direktori organisasi ini.

6. Pilih Daftarkan.

7. Panel Gambaran Umum aplikasi ditampilkan saat pendaftaran selesai. Rekam ID Direktori (penyewa) dan ID Aplikasi (klien) yang akan digunakan dalam kode sumber aplikasi Anda.

Memberikan izin API

Aplikasi daemon masuk dengan sendirinya menggunakan alur kredensial klien OAuth 2.0. Anda memberikan izin aplikasi (peran aplikasi), yang diperlukan oleh aplikasi yang mengautentikasi sebagai dirinya sendiri. Anda juga harus mendaftarkan API web yang perlu dipanggil aplikasi daemon Anda.

1. Dari halaman Pendaftaran aplikasi, pilih aplikasi yang Anda buat, seperti ciam-client-app.

2. Di bagian Kelola, pilih Izin API.

3. Di Izin yang dikonfigurasi, pilih Tambahkan izin.

4. Pilih tab API yang digunakan organisasi saya.

5. Dalam daftar API, pilih API seperti ciam-ToDoList-api.

6. Pilih opsi Izin aplikasi . Kami memilih opsi ini sebagai aplikasi masuk sebagai dirinya sendiri, tetapi bukan atas nama pengguna.

7. Dari daftar izin, pilih TodoList.Read.All, ToDoList.ReadWrite.All (gunakan kotak pencarian jika perlu).

8. Pilih tombol Tambahkan izin akses.

9. Pada titik ini, Anda telah menetapkan izin dengan benar. Namun, karena aplikasi daemon tidak mengizinkan pengguna untuk berinteraksi dengannya, pengguna itu sendiri tidak dapat menyetujui izin ini. Untuk mengatasi masalah ini, Anda sebagai admin harus menyetujui izin ini atas nama semua pengguna di penyewa:

   1. Pilih Berikan persetujuan admin untuk <nama> penyewa Anda, lalu pilih Ya.
   2. Pilih Refresh, lalu verifikasi bahwa Diberikan untuk <nama> penyewa Anda muncul di bawah Status untuk kedua izin.

Menguji alur pengguna (opsional)

Untuk menguji alur pengguna dengan pendaftaran aplikasi ini, aktifkan alur pemberian izin implisit untuk autentikasi.

Penting

Alur implisit harus digunakan hanya untuk tujuan pengujian dan bukan untuk mengautentikasi pengguna di aplikasi produksi Anda. Setelah Anda selesai menguji, sebaiknya hapus.

Untuk mengaktifkan alur implisit, ikuti langkah-langkah berikut:

1. Masuk ke pusat admin Microsoft Entra setidaknya sebagai Pengembang Aplikasi.
2. Jika Anda memiliki akses ke beberapa penyewa, gunakan ikon Pengaturan di menu atas untuk beralih ke penyewa eksternal Anda dari menu Direktori + langganan.
3. Telusuri Aplikasi >Identitas>Pendaftaran aplikasi.
4. Pilih pendaftaran aplikasi yang Anda buat.
5. Di bagian Kelola, pilih Autentikasi.
6. Di bagian Izin implisit dan alur hibrid, pilih kotak centang Token ID (digunakan untuk alur implisit dan hibrid).
7. Pilih Simpan.

API Microsoft Graph

Mendaftarkan aplikasi Microsoft Graph API

Untuk mengaktifkan aplikasi Anda untuk memasukkan pengguna dengan Microsoft Entra, MICROSOFT Entra External ID harus mengetahui aplikasi yang Anda buat. Pendaftaran aplikasi membangun hubungan kepercayaan antara aplikasi dan Microsoft Entra. Saat Anda mendaftarkan aplikasi, ID Eksternal menghasilkan pengidentifikasi unik yang dikenal sebagai ID Aplikasi (klien), nilai yang digunakan untuk mengidentifikasi aplikasi Anda saat membuat permintaan autentikasi.

Langkah-langkah berikut menunjukkan cara mendaftarkan aplikasi Anda di pusat admin Microsoft Entra:

1. Masuk ke pusat admin Microsoft Entra setidaknya sebagai Pengembang Aplikasi.

2. Jika Anda memiliki akses ke beberapa penyewa, gunakan ikon Pengaturan di menu atas untuk beralih ke penyewa eksternal Anda dari menu Direktori + langganan.

3. Telusuri Aplikasi >Identitas>Pendaftaran aplikasi.

4. Pilih + Pendaftaran baru.

5. Di halaman Daftarkan aplikasi yang muncul;

   1. Masukkan Nama aplikasi yang bermakna yang ditampilkan kepada pengguna aplikasi, misalnya ciam-client-app.
   2. Di bawah Jenis akun yang didukung, pilih Hanya akun dalam direktori organisasi ini.

6. Pilih Daftarkan.

7. Panel Gambaran Umum aplikasi ditampilkan setelah pendaftaran berhasil. Rekam ID Aplikasi (klien) yang akan digunakan dalam kode sumber aplikasi Anda.

Memberikan Akses API ke aplikasi Anda

Agar aplikasi Anda mengakses data di Microsoft Graph API, berikan aplikasi terdaftar izin aplikasi yang relevan. Izin efektif aplikasi Anda adalah tingkat keistimewaan penuh yang tersirat oleh izin. Misalnya, untuk membuat, membaca, memperbarui, dan menghapus setiap pengguna di penyewa eksternal Anda, tambahkan izin User.ReadWrite.All.

1. Di bagian Kelola, pilih Izin API.

2. Di Izin yang dikonfigurasi, pilih Tambahkan izin.

3. Pilih tab API Microsoft, lalu pilih Microsoft Graph.

4. Pilih Izin aplikasi.

5. Perluas grup izin yang sesuai dan pilih kotak centang untuk memberikan izin kepada aplikasi manajemen Anda. Contohnya:

   • Pengguna>User.ReadWrite.All: Untuk migrasi pengguna atau skenario manajemen pengguna.

   • Grup>Group.ReadWrite.All: Untuk membuat grup, membaca dan memperbarui keanggotaan grup, dan menghapus grup.

   • AuditLog>AuditLog.Read.All: Untuk membaca log audit direktori.

   • Kebijakan>Policy.ReadWrite.TrustFramework: Untuk skenario integrasi berkelanjutan/pengiriman berkelanjutan (CI/CD). Misalnya, penyebaran kebijakan kustom dengan Azure Pipelines.

6. Pilih Tambahkan izin. Sesuai petunjuk, tunggu beberapa menit sebelum melanjutkan ke langkah berikutnya.

7. Pilih Berikan persetujuan admin untuk (nama penyewa Anda).

8. Jika saat ini Anda tidak masuk, masuk dengan akun di penyewa eksternal Anda yang telah ditetapkan setidaknya peran Administrator Aplikasi Cloud lalu pilih Berikan persetujuan admin untuk (nama penyewa Anda).

9. Pilih Refresh, lalu verifikasi bahwa itu "Diberikan untuk ..." muncul di bagian Status. Penerapan izin mungkin memerlukan waktu beberapa menit.

Setelah mendaftarkan aplikasi, Anda perlu menambahkan rahasia klien ke aplikasi Anda. Rahasia klien ini akan digunakan untuk mengautentikasi aplikasi Anda untuk memanggil Microsoft Graph API.

Membuat rahasia klien

Buat rahasia klien untuk aplikasi terdaftar. Aplikasi ini menggunakan rahasia klien untuk membuktikan identitasnya ketika meminta token.

1. Dari halaman Pendaftaran aplikasi, pilih aplikasi yang Anda buat (seperti ciam-client-app) untuk membuka halaman Gambaran Umumnya.
2. Di bagian Kelola, pilih Sertifikat & rahasia.
3. Pilih Rahasia klien baru.
4. Dalam kotak Deskripsi , masukkan deskripsi untuk rahasia klien (misalnya, rahasia klien aplikasi ciam).
5. Di bawah Kedaluwarsa, pilih durasi yang rahasianya valid (sesuai aturan keamanan organisasi Anda), lalu pilih Tambahkan.
6. Catat Nilai rahasia. Anda akan menggunakan nilai ini untuk konfigurasi pada langkah selanjutnya. Nilai rahasia tidak akan ditampilkan lagi, dan tidak dapat diambil dengan cara apa pun, setelah Anda menavigasi jauh dari Sertifikat dan rahasia. Pastikan Anda merekamnya.

Menguji alur pengguna (opsional)

Untuk menguji alur pengguna dengan pendaftaran aplikasi ini, aktifkan alur pemberian izin implisit untuk autentikasi.

Penting

Alur implisit harus digunakan hanya untuk tujuan pengujian dan bukan untuk mengautentikasi pengguna di aplikasi produksi Anda. Setelah Anda selesai menguji, sebaiknya hapus.

Untuk mengaktifkan alur implisit, ikuti langkah-langkah berikut:

1. Masuk ke pusat admin Microsoft Entra setidaknya sebagai Pengembang Aplikasi.
2. Jika Anda memiliki akses ke beberapa penyewa, gunakan ikon Pengaturan di menu atas untuk beralih ke penyewa eksternal Anda dari menu Direktori + langganan.
3. Telusuri Aplikasi >Identitas>Pendaftaran aplikasi.
4. Pilih pendaftaran aplikasi yang Anda buat.
5. Di bagian Kelola, pilih Autentikasi.
6. Di bagian Izin implisit dan alur hibrid, pilih kotak centang Token ID (digunakan untuk alur implisit dan hibrid).
7. Pilih Simpan.

Autentikasi asli

Mendaftarkan aplikasi autentikasi asli

Untuk mengaktifkan aplikasi Anda untuk memasukkan pengguna dengan Microsoft Entra, MICROSOFT Entra External ID harus mengetahui aplikasi yang Anda buat. Pendaftaran aplikasi membangun hubungan kepercayaan antara aplikasi dan Microsoft Entra. Saat Anda mendaftarkan aplikasi, ID Eksternal menghasilkan pengidentifikasi unik yang dikenal sebagai ID Aplikasi (klien), nilai yang digunakan untuk mengidentifikasi aplikasi Anda saat membuat permintaan autentikasi.

Langkah-langkah berikut menunjukkan cara mendaftarkan aplikasi Anda di pusat admin Microsoft Entra:

1. Masuk ke pusat admin Microsoft Entra setidaknya sebagai Pengembang Aplikasi.

2. Jika Anda memiliki akses ke beberapa penyewa, gunakan ikon Pengaturan di menu atas untuk beralih ke penyewa eksternal Anda dari menu Direktori + langganan.

3. Telusuri Aplikasi >Identitas>Pendaftaran aplikasi.

4. Pilih + Pendaftaran baru.

5. Di halaman Daftarkan aplikasi yang muncul;

   1. Masukkan Nama aplikasi yang bermakna yang ditampilkan kepada pengguna aplikasi, misalnya ciam-client-app.
   2. Di bawah Jenis akun yang didukung, pilih Hanya akun dalam direktori organisasi ini.

6. Pilih Daftarkan.

7. Panel Gambaran Umum aplikasi ditampilkan setelah pendaftaran berhasil. Rekam ID Aplikasi (klien) yang akan digunakan dalam kode sumber aplikasi Anda.

Memberikan izin admin

Setelah Anda mendaftarkan aplikasi, aplikasi akan diberi izin User.Read . Namun, karena penyewa adalah penyewa eksternal, pengguna pelanggan itu sendiri tidak dapat menyetujui izin ini. Anda sebagai admin harus menyetujui izin ini atas nama semua pengguna di penyewa:

1. Dari halaman Pendaftaran aplikasi, pilih aplikasi yang Anda buat (seperti ciam-client-app) untuk membuka halaman Gambaran Umumnya.

2. Di bagian Kelola, pilih Izin API.

   1. Pilih Berikan persetujuan admin untuk <nama> penyewa Anda, lalu pilih Ya.
   2. Pilih Refresh, lalu verifikasi bahwa Diberikan untuk <nama> penyewa Anda muncul di bawah Status untuk izin tersebut.

Mengaktifkan klien publik dan alur autentikasi asli

Untuk menentukan bahwa aplikasi ini adalah klien publik dan dapat menggunakan autentikasi asli, aktifkan klien publik dan alur autentikasi asli:

1. Dari halaman pendaftaran aplikasi, pilih pendaftaran aplikasi yang ingin Anda aktifkan klien publik dan alur autentikasi asli.
2. Di bagian Kelola, pilih Autentikasi.
3. Di bawah Pengaturan tingkat lanjut, izinkan alur klien publik:
   1. Untuk Mengaktifkan alur seluler dan desktop berikut, pilih Ya.
   2. Untuk Aktifkan autentikasi asli, pilih Ya.
4. Pilih tombol Simpan .

Temukan ID Aplikasi (klien)

Setelah mendaftarkan aplikasi baru, Anda dapat menemukan ID Aplikasi (klien) dari gambaran umum di pusat admin Microsoft Entra.

1. Dari halaman Pendaftaran aplikasi, pilih tab Semua aplikasi atau Aplikasi yang dimiliki.

2. Pilih aplikasi untuk membuka halaman Gambaran Umumnya.

3. Di bagian Esensial , Anda menemukan semua detail aplikasi termasuk ID Aplikasi (klien).

   

Langkah berikutnya

• Membuat alur pengguna pendaftaran dan masuk