Memasukkan pengguna dalam contoh aplikasi Android .NET MAUI

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

Panduan cara ini menggunakan sampel .NET Multi-platform App UI (.NET MAUI) untuk menunjukkan cara menambahkan autentikasi ke aplikasi Android dengan menggunakan penyewa eksternal. Aplikasi sampel memungkinkan pengguna untuk masuk dan keluar. Contoh aplikasi Android .NET MAUI menggunakan Microsoft Authentication Library (MSAL) untuk .NET untuk menangani autentikasi.

Dalam artikel ini, Anda melakukan tugas berikut:

• Daftarkan aplikasi Android .NET MAUI di penyewa eksternal.
• Buat alur pengguna masuk dan keluar di penyewa eksternal.
• Kaitkan aplikasi Android .NET MAUI Anda dengan alur pengguna.
• Perbarui contoh aplikasi Android .NET MAUI untuk menggunakan detail penyewa eksternal Anda sendiri.
• Jalankan dan uji sampel aplikasi Android .NET MAUI.

Prasyarat

• .NET 7.0 SDK
• Visual Studio 2022 dengan beban kerja MAUI terinstal:
  • Petunjuk untuk Windows
  • Instruksi untuk macOS
• Penyewa eksternal. Jika Anda belum memilikinya, daftar untuk uji coba gratis.

Mendaftarkan aplikasi Android .NET MAUI

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.

Untuk menentukan jenis aplikasi ke pendaftaran aplikasi Anda, ikuti langkah-langkah berikut:

1. Di bagian Kelola, pilih Autentikasi.
2. Pada halaman Konfigurasi platform , pilih Tambahkan platform, lalu pilih opsi Aplikasi seluler dan Desktop.
3. Untuk URI Pengalihan masukkan msalEnter_the_Application_Id_Here://auth, ganti Enter_the_Application_Id_Here dengan ID Aplikasi (klien) yang Anda salin sebelumnya, lalu pilih Konfigurasikan.
4. Pilih Simpan untuk menyimpan perubahan.

Memberikan izin admin

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. Dari daftar Izin yang dikonfigurasi, aplikasi Anda telah diberi izin User.Read. Namun, karena penyewa adalah penyewa eksternal, pengguna konsumen itu sendiri tidak dapat menyetujui izin 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.

Membuat alur pengguna

Ikuti langkah-langkah ini untuk membuat alur pengguna yang dapat digunakan pelanggan untuk masuk atau mendaftar ke aplikasi.

1. Masuk ke pusat admin Microsoft Entra sebagai setidaknya Administrator Alur Pengguna ID Eksternal.

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 ke >Identitas Eksternal Identitas>Alur pengguna.

4. Pilih + Alur pengguna baru.

5. Pada halaman Buat :

   1. Masukkan Nama untuk alur pengguna, seperti SignInSignUpSample.

   2. Di daftar Penyedia identitas, pilih Akun Email. IdP ini memungkinkan pengguna untuk masuk atau mendaftar menggunakan alamat email mereka.

      Catatan

      Penyedia identitas tambahan akan dicantumkan di sini hanya setelah Anda menyiapkan federasi dengan mereka. Misalnya, jika menyiapkan federasi dengan Google atau Facebook, Anda akan dapat memilih idP tambahan tersebut di sini.

   3. Di bawah Akun email, Anda bisa memilih salah satu dari dua opsi. Untuk tutorial ini, pilih Email dengan kata sandi.

      • Email dengan kata sandi: Memungkinkan pengguna baru untuk mendaftar dan masuk menggunakan alamat email sebagai nama masuk dan kata sandi sebagai kredensial faktor pertama mereka.
      • Kode akses satu kali email: Memungkinkan pengguna baru untuk mendaftar dan masuk menggunakan alamat email sebagai nama masuk dan kode akses satu kali email sebagai kredensial faktor pertama mereka. Kode akses satu kali email harus diaktifkan di tingkat penyewa (Semua Kode sandi Satu kali Email Penyedia>Identitas) agar opsi ini tersedia di tingkat alur pengguna.

   4. Di bawah Atribut pengguna, pilih atribut yang ingin Anda kumpulkan dari pengguna saat mendaftar. Dengan memilih Tampilkan lainnya, Anda dapat memilih atribut dan klaim untuk Negara/Wilayah, Nama Tampilan, dan Kode Pos. Pilih OK. (Pengguna hanya dimintai atribut saat mendaftar untuk pertama kalinya.)

6. Pilih Buat. Alur pengguna baru muncul di daftar Alur pengguna. Jika perlu, refresh halaman.

Untuk mengaktifkan pengaturan ulang kata sandi mandiri, gunakan langkah-langkah dalam artikel Mengaktifkan pengaturan ulang kata sandi mandiri.

Kaitkan aplikasi Android .NET MAUI dengan alur pengguna

Agar pengguna pelanggan dapat melihat pengalaman pendaftaran atau masuk saat mereka menggunakan aplikasi, Anda perlu mengaitkan aplikasi Anda dengan alur pengguna. Meskipun banyak aplikasi dapat dikaitkan dengan alur pengguna Anda, satu aplikasi hanya dapat dikaitkan dengan satu alur pengguna.

1. Pada menu bilah samping, pilih Identitas.

2. Pilih Identitas Eksternal, lalu Alur pengguna.

3. Di halaman Alur pengguna, pilih Nama alur pengguna yang Anda buat sebelumnya, misalnya, SignInSignUpSample.

4. Di bawah Gunakan, pilih Aplikasi.

5. Pilih Tambahkan aplikasi.

6. Pilih aplikasi dari daftar seperti ciam-client-app atau gunakan kotak pencarian untuk menemukan aplikasi, lalu pilih.

7. Memilih Pilih.

Setelah mengaitkan aplikasi dengan alur pengguna, Anda dapat menguji alur pengguna dengan mensimulasikan pengalaman pendaftaran atau masuk pengguna dengan aplikasi Anda dari dalam pusat admin Microsoft Entra. Untuk melakukannya, gunakan langkah-langkah dalam Menguji alur pengguna pendaftaran dan masuk Anda.

Mengkloning atau mengunduh sampel aplikasi Android .NET MAUI

Untuk mendapatkan kode sampel aplikasi Android .NET MAUI, unduh file .zip atau kloning sampel aplikasi Android .NET MAUI dari GitHub dengan menjalankan perintah berikut:

git clone https://github.com/Azure-Samples/ms-identity-ciam-dotnet-tutorial.git

Mengonfigurasi contoh aplikasi Android .NET MAUI

1. Di Visual Studio, buka file ms-identity-ciam-dotnet-tutorial-main/1-Authentication/2-sign-in-maui/appsettings.json .
2. Temukan tempat penampung:
   1. Enter_the_Tenant_Subdomain_Here dan ganti dengan subdomain Direktori (penyewa). Misalnya, jika domain utama penyewa Anda adalah contoso.onmicrosoft.com, gunakan contoso. Jika Anda tidak memiliki nama penyewa, pelajari cara membaca detail penyewa Anda.
   2. Enter_the_Application_Id_Here dan ganti dengan ID Aplikasi (klien) aplikasi yang Anda daftarkan sebelumnya.
3. Di Visual Studio, buka file ms-identity-ciam-dotnet-tutorial-main/1-Authentication/2-sign-in-maui/Platforms/Android/AndroidManifest.xml .
4. Temukan tempat penampung:
   1. Enter_the_Application_Id_Here dan ganti dengan ID Aplikasi (klien) aplikasi yang Anda daftarkan sebelumnya.

Jalankan dan uji sampel aplikasi Android .NET MAUI

Aplikasi MAUI .NET dirancang untuk berjalan pada beberapa sistem operasi dan perangkat. Anda harus memilih target mana yang ingin Anda uji dan debug aplikasi Anda.

Atur Target Debug di toolbar Visual Studio ke perangkat yang ingin Anda debug dan uji. Langkah-langkah berikut menunjukkan pengaturan Target Debug ke Android:

1. Pilih drop-down Target Debug.
2. Pilih Emulator Android.
3. Pilih perangkat emulator.

Jalankan aplikasi dengan menekan F5 atau pilih tombol putar di bagian atas Visual Studio.

1. Anda sekarang dapat menguji sampel aplikasi Android .NET MAUI. Setelah Anda menjalankan aplikasi, jendela aplikasi Android muncul di emulator:

   

2. Pada jendela Android yang muncul, pilih tombol Masuk . Jendela browser terbuka, dan Anda diminta untuk masuk.

   

   Selama proses masuk, Anda diminta untuk memberikan berbagai izin (untuk memungkinkan aplikasi mengakses data Anda). Setelah berhasil masuk dan menyetujui, layar aplikasi menampilkan halaman utama.

   

Langkah berikutnya

• Sesuaikan branding default.
• Mengonfigurasi rincian masuk dengan Google.