Esercitazione: Preparare l'app iOS/macOS per l'autenticazione nativa

Articolo
05/03/2025

Si applica a: cerchio bianco con un simbolo X grigio. tenant della forza lavoro cerchio verde con un simbolo di segno di spunta bianco. tenant esterni (altre)

Questa esercitazione illustra come aggiungere Microsoft Authentication Library (MSAL) native authentication SDK framework all'app iOS/macOS Swift.

In questa esercitazione si apprenderà come:

Aggiungere il framework MSAL a un'app iOS/macOS.
Creare un'istanza dell'SDK.

Prerequisiti

Xcode
Se non è già stato fatto, seguire le istruzioni riportate in Accedere agli utenti nell'app per dispositivi mobili iOS (Swift) di esempio usando l'autenticazione nativa e registrare un'app nel tenant esterno. Assicurarsi di completare i passaggi seguenti:
- Registrare un'applicazione.
- Abilitare il client pubblico e i flussi di autenticazione nativi.
- Concedere autorizzazioni API.
- Creare un flusso utente.
- Associare l'app al flusso utente.
Progetto iOS/macOS

Aggiungere il framework MSAL a un'app iOS/macOS

Aprire il progetto iOS/macOS in Xcode.
Selezionare Aggiungi dipendenze pacchetto... dal menu File.
Immettere https://github.com/AzureAD/microsoft-authentication-library-for-objc come URL del pacchetto e scegliere Aggiungi pacchetto.
Aggiungi un nuovo gruppo portachiavi al progetto Capabilities. Usare com.microsoft.adalcache in iOS e com.microsoft.identity.universalstorage in macOS.

Per ulteriori informazioni e altri meccanismi per aggiungere MSAL al tuo progetto, consulta il file Readme del progetto .

Creare un'istanza dell'SDK

Importare la libreria MSAL nel controller di visualizzazione aggiungendo import MSAL nella parte superiore della classe ViewController.
Aggiungere una variabile membro nativeAuth alla classe ViewController aggiungendo il codice seguente subito prima della funzione viewDidLoad():
```
var nativeAuth: MSALNativeAuthPublicClientApplication!
```

Aggiungere quindi il codice seguente alla funzione viewDidLoad():

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

Sostituire i valori seguenti con i valori dell'interfaccia di amministrazione di Microsoft Entra:
1. Individua il valore Enter_the_Application_Id_Here e sostituiscilo con l'ID Applicazione (client) dell'app registrata in precedenza.
2. Trovare il Enter_the_Tenant_Subdomain_Here e sostituirlo con il sottodominio Directory (tenant). Ad esempio, se il dominio primario del tenant è contoso.onmicrosoft.com, usare contoso. Se non hai il sottodominio della Directory (tenant), scopri come leggere i dettagli del tenant.
  
  I tipi di sfida sono un elenco di valori che l'app usa per notificare a Microsoft Entra il metodo di autenticazione che supporta.
  - Per i flussi di iscrizione e accesso con passcode monouso tramite posta elettronica, usare [.OOB].
  - Per i flussi di iscrizione e accesso con posta elettronica e password, usare [.OOB, .password].
  - Per la reimpostazione autonoma della password, usare [.OOB].
  Scopri di più sui tipi di sfida .
Per compilare, selezionare il prodotto >Build nella barra degli strumenti del progetto.

Facoltativo: configurazione della registrazione

MSAL offre un'API di registrazione che è possibile usare per abilitare e configurare la registrazione. Per visualizzare tutto l'output di debug di MSAL, aggiungere il codice seguente all'inizio della funzione viewDidLoad():

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

In questo modo vengono restituiti tutti i log di debug da MSAL, che possono essere utili per diagnosticare i problemi e apprendere il funzionamento dei flussi di autenticazione nativi. Per altre informazioni sulla configurazione dei livelli di log e sulle procedure consigliate, vedere Registrazione in MSAL per iOS/macOS.

Passaggio successivo

Esercitazione: Aggiungere la registrazione a un'app iOS/macOS usando l'autenticazione nativa

Condividi tramite