Tutorial: Menyiapkan aplikasi iOS Anda untuk autentikasi asli

Artikel
06/27/2024

Tutorial ini menunjukkan cara menambahkan kerangka kerja SDK autentikasi asli Microsoft Authentication Library (MSAL) ke aplikasi iOS Swift Anda.

Dalam tutorial ini, Anda akan mempelajari cara:

Tambahkan kerangka kerja MSAL ke aplikasi iOS.
Buat instans SDK.

Prasyarat

Xcode
Jika Anda belum melakukannya, ikuti instruksi di Memasukkan pengguna di contoh aplikasi seluler iOS (Swift) dengan menggunakan autentikasi asli dan daftarkan aplikasi di penyewa eksternal Anda. Pastikan Anda menyelesaikan langkah-langkah berikut:
- Daftarkan aplikasi.
- Aktifkan klien publik dan alur autentikasi asli.
- Berikan izin API.
- Membuat alur pengguna.
- Kaitkan aplikasi dengan alur pengguna.
Proyek iOS

Menambahkan kerangka kerja MSAL ke aplikasi iOS

Buka proyek iOS Anda di Xcode.
Pilih Tambahkan Dependensi Paket... dari menu File .
Masukkan https://github.com/AzureAD/microsoft-authentication-library-for-objc sebagai URL Paket dan pilih Tambahkan Paket

Untuk informasi selengkapnya dan mekanisme lain untuk menambahkan MSAL ke proyek Anda, lihat file Readme proyek.

Membuat instans SDK

Impor pustaka MSAL ke pengontrol tampilan Anda dengan menambahkan import MSAL di bagian atas kelas Anda ViewController .
nativeAuth Tambahkan variabel anggota ke kelas Anda ViewController dengan menambahkan kode berikut tepat sebelum viewDidLoad() fungsi:
```
var nativeAuth: MSALNativeAuthPublicClientApplication!
```

Selanjutnya, tambahkan kode berikut ke viewDidLoad() fungsi :

 do {
    nativeAuth = try MSALNativeAuthPublicClientApplication(
        clientId: "Enter_the_Application_Id_Here",
        tenantSubdomain: "Enter_the_Tenant_Subdomain_Here",
        challengeTypes: [.OOB]
    )

    print("Initialized Native Auth successfully.")
 } catch {
    print("Unable to initialize MSAL \(error)")
 }

Ganti nilai berikut dengan nilai dari pusat admin Microsoft Entra:
1. Enter_the_Application_Id_Here Temukan nilai dan ganti dengan ID Aplikasi (klien) aplikasi yang Anda daftarkan sebelumnya.
2. Enter_the_Tenant_Subdomain_Here Temukan dan ganti dengan subdomain Direktori (penyewa). Misalnya, jika domain utama penyewa Anda adalah contoso.onmicrosoft.com, gunakan contoso. Jika Anda tidak memiliki subdomain Direktori (penyewa), pelajari cara membaca detail penyewa Anda.
  
  Jenis tantangan adalah daftar nilai, yang digunakan aplikasi untuk memberi tahu Microsoft Entra tentang metode autentikasi yang didukungnya.
  - Untuk alur pendaftaran dan masuk dengan kode akses satu kali email, gunakan [.OOB].
  - Untuk alur pendaftaran dan masuk dengan email dan kata sandi, gunakan [.OOB, .password].
  - Untuk pengaturan ulang kata sandi mandiri (SSPR), gunakan [.OOB].
  Pelajari lebih lanjut jenis tantangan.
Untuk membuat, pilih Build Produk>di toolbar proyek Anda.

Opsional: Konfigurasi pengelogan

MSAL menyediakan API pengelogan yang dapat Anda gunakan untuk mengaktifkan dan mengonfigurasi pengelogan. Untuk melihat semua output debug dari MSAL, tambahkan kode berikut di awal viewDidLoad() fungsi:

MSALGlobalConfig.loggerConfig.logLevel = .verbose
MSALGlobalConfig.loggerConfig.setLogCallback { logLevel, message, containsPII in
   if !containsPII {
      print("MSAL: \(message ?? "")")
   }
}

Ini menghasilkan semua log debug dari MSAL, yang dapat membantu dalam mendiagnosis masalah dan mempelajari cara kerja alur autentikasi asli. Untuk mempelajari selengkapnya tentang mengonfigurasi tingkat log dan praktik terbaik, lihat Pengelogan di MSAL untuk iOS/macOS.

Langkah selanjutnya

Tutorial: Menambahkan pendaftaran di aplikasi seluler iOS menggunakan autentikasi asli

Bagikan melalui