Aracılığıyla paylaş

Öğretici: iOS uygulamanızı yerel kimlik doğrulaması için hazırlama

  • Makale

Bu öğreticide, iOS Swift uygulamanıza Microsoft Authentication Library (MSAL) yerel kimlik doğrulama SDK'sı çerçevesinin nasıl ekleneceği gösterilmektedir.

Bu öğreticide aşağıdakilerin nasıl yapılacağını öğreneceksiniz:

  • MSAL çerçevesini bir iOS uygulamasına ekleyin.
  • SDK örneği oluşturma.

Önkoşullar

IOS uygulamasına MSAL çerçevesi ekleme

  1. iOS projenizi Xcode'da açın.
  2. Dosya menüsünden Paket Bağımlılıkları Ekle... öğesini seçin.
  3. Paket URL'si olarak girin https://github.com/AzureAD/microsoft-authentication-library-for-objc ve Paket Ekle'yi seçin

Projenize MSAL eklemeye yönelik daha fazla bilgi ve diğer mekanizmalar için bkz . Proje BeniOku dosyası.

SDK örneği oluşturma

  1. Sınıfınızın en üstüne ekleyerek import MSAL MSAL kitaplığını görünüm denetleyicinize ViewController aktarın.

  2. İşlevden hemen önce viewDidLoad() aşağıdaki kodu ekleyerek sınıfınıza ViewController bir nativeAuth üye değişkeni ekleyin:

    var nativeAuth: MSALNativeAuthPublicClientApplication!

  3. Ardından işleve viewDidLoad() aşağıdaki kodu ekleyin:

     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)")
 }

  4. Aşağıdaki değerleri Microsoft Entra yönetim merkezindeki değerlerle değiştirin:

    1. Enter_the_Application_Id_Here Değerini bulun ve daha önce kaydettiğiniz uygulamanın Uygulama (istemci) kimliğiyledeğiştirin.
    2. Enter_the_Tenant_Subdomain_Here öğesini bulun ve dizin (kiracı) alt etki alanıyla değiştirin. Örneğin, kiracı birincil etki alanınız ise contoso.onmicrosoft.comkullanın contoso. Dizin (kiracı) alt etki alanınız yoksa kiracı ayrıntılarınızı okumayı öğrenin.

  5. Derlemek için projenizin araç çubuğunda Ürün>Derlemesi'ni seçin.

İsteğe bağlı: Günlük yapılandırması

MSAL, günlüğü etkinleştirmek ve yapılandırmak için kullanabileceğiniz bir günlük API'sini sağlar. MSAL'den gelen tüm hata ayıklama çıkışını görmek için işlevin başlangıcına viewDidLoad() aşağıdaki kodu ekleyin:

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

Bu, tüm hata ayıklama günlüklerini MSAL'den çıkararak sorunları tanılamaya ve yerel kimlik doğrulama akışlarının nasıl çalıştığını öğrenmeye yardımcı olabilir. Günlük düzeylerini ve en iyi yöntemleri yapılandırma hakkında daha fazla bilgi edinmek için bkz . iOS/macOS için MSAL'de günlüğe kaydetme.

Sonraki adımlar