Usare MSAL in un ambiente cloud nazionale

È possibile usare MSAL.NET per accedere agli utenti, acquisire token e chiamare l'API Microsoft Graph nei cloud nazionali.

Le esercitazioni seguenti illustrano come creare un'app Web ASP.NET Core. L'app usa OpenID Connessione per consentire agli utenti di accedere con un account aziendale e dell'istituto di istruzione in un'organizzazione appartenente a un cloud nazionale.

• Per accedere agli utenti e acquisire i token, seguire questa esercitazione: Creare un'app Web di ASP.NET Core che accedono agli utenti nei cloud sovrani con Microsoft Identity Platform.
• Per chiamare l'API Microsoft Graph, seguire questa esercitazione: Uso di Microsoft Identity Platform per chiamare l'API Microsoft Graph da un'app Web ASP.NET Core, per conto di un utente che accede usando il proprio account aziendale e dell'istituto di istruzione in Microsoft National Cloud.

Per abilitare l'applicazione MSAL.js per i cloud sovrani:

• Registrare l'applicazione in un portale specifico, a seconda del cloud. Per altre informazioni su come scegliere il portale, vedere Endpoint di registrazione app
• Usare uno degli esempi del repository con alcune modifiche alla configurazione, a seconda del cloud, indicato di seguito.
• Usare un'autorità specifica, a seconda del cloud in cui è stata registrata l'applicazione. Per altre informazioni sulle autorità per diversi cloud, vedere Endpoint di autenticazione di Microsoft Entra.
• Per chiamare l'API Microsoft Graph è necessario un URL dell'endpoint specifico per il cloud in uso. Per trovare gli endpoint di Microsoft Graph per tutti i cloud nazionali, fare riferimento agli endpoint radice del servizio Microsoft Graph e Graph Explorer.

Ecco un'autorità di esempio:

"authority": "https://login.microsoftonline.us/Enter_the_Tenant_Info_Here"

Di seguito è riportato un esempio di endpoint di Microsoft Graph con ambito:

"endpoint" : "https://graph.microsoft.us/v1.0/me"
"scope": "User.Read"

Ecco il codice minimo per autenticare un utente con un cloud sovrano e chiamare Microsoft Graph:

const msalConfig = {
    auth: {
        clientId: "Enter_the_Application_Id_Here",
        authority: "https://login.microsoftonline.us/Enter_the_Tenant_Info_Here",
        redirectUri: "/",
    }
};

// Initialize MSAL
const msalObj = new PublicClientApplication(msalConfig);

// Get token using popup experience
try {
    const graphToken = await msalObj.acquireTokenPopup({
        scopes: ["User.Read"]
    });
} catch(error) {
    console.log(error)
}

// Call the Graph API
const headers = new Headers();
const bearer = `Bearer ${graphToken}`;

headers.append("Authorization", bearer);

fetch("https://graph.microsoft.us/v1.0/me", {
    method: "GET",
    headers: headers
})

Per abilitare l'applicazione Python MSAL per i cloud sovrani:

• Registrare l'applicazione in un portale specifico, a seconda del cloud. Per altre informazioni su come scegliere il portale, vedere Endpoint di registrazione app

• Usare uno degli esempi del repository con alcune modifiche alla configurazione, a seconda del cloud, indicato di seguito.

• Usare un'autorità specifica, a seconda del cloud in cui è stata registrata l'applicazione. Per altre informazioni sulle autorità per diversi cloud, vedere Endpoint di autenticazione di Microsoft Entra.

  Ecco un'autorità di esempio:

  "authority": "https://login.microsoftonline.us/Enter_the_Tenant_Info_Here"
  

• Per chiamare l'API Microsoft Graph è necessario un URL dell'endpoint specifico per il cloud in uso. Per trovare gli endpoint di Microsoft Graph per tutti i cloud nazionali, fare riferimento agli endpoint radice del servizio Microsoft Graph e Graph Explorer.

  Di seguito è riportato un esempio di endpoint di Microsoft Graph con ambito:

  "endpoint" : "https://graph.microsoft.us/v1.0/me"
  "scope": "User.Read"
  

Per abilitare l'applicazione MSAL per Java per cloud sovrani:

• Registrare l'applicazione in un portale specifico, a seconda del cloud. Per altre informazioni su come scegliere il portale, vedere Endpoint di registrazione app
• Usare uno degli esempi del repository con alcune modifiche apportate alla configurazione, a seconda del cloud, indicato di seguito.
• Usare un'autorità specifica, a seconda del cloud in cui è stata registrata l'applicazione. Per altre informazioni sulle autorità per diversi cloud, vedere Endpoint di autenticazione di Microsoft Entra.

Ecco un'autorità di esempio:

"authority": "https://login.microsoftonline.us/Enter_the_Tenant_Info_Here"

• Per chiamare l'API Microsoft Graph è necessario un URL dell'endpoint specifico per il cloud in uso. Per trovare gli endpoint di Microsoft Graph per tutti i cloud nazionali, fare riferimento agli endpoint radice del servizio Microsoft Graph e Graph Explorer.

Di seguito è riportato un esempio di endpoint del grafo con ambito:

"endpoint" : "https://graph.microsoft.us/v1.0/me"
"scope": "User.Read"

MSAL per iOS e macOS può essere usato per acquisire i token nei cloud nazionali, ma richiede una configurazione aggiuntiva durante la creazione di MSALPublicClientApplication.

Ad esempio, se si vuole che l'applicazione sia un'applicazione multi-tenant in un cloud nazionale (qui US Government), è possibile scrivere:

MSALAADAuthority *aadAuthority =
                [[MSALAADAuthority alloc] initWithCloudInstance:MSALAzureUsGovernmentCloudInstance
                                                   audienceType:MSALAzureADMultipleOrgsAudience
                                                      rawTenant:nil
                                                          error:nil];

MSALPublicClientApplicationConfig *config =
                [[MSALPublicClientApplicationConfig alloc] initWithClientId:@"<your-client-id-here>"
                                                                redirectUri:@"<your-redirect-uri-here>"
                                                                  authority:aadAuthority];

NSError *applicationError = nil;
MSALPublicClientApplication *application =
                [[MSALPublicClientApplication alloc] initWithConfiguration:config error:&applicationError];

MSAL per iOS e macOS può essere usato per acquisire i token nei cloud nazionali, ma richiede una configurazione aggiuntiva durante la creazione di MSALPublicClientApplication.

Ad esempio, se si vuole che l'applicazione sia un'applicazione multi-tenant in un cloud nazionale (qui US Government), è possibile scrivere:

let authority = try? MSALAADAuthority(cloudInstance: .usGovernmentCloudInstance, audienceType: .azureADMultipleOrgsAudience, rawTenant: nil)

let config = MSALPublicClientApplicationConfig(clientId: "<your-client-id-here>", redirectUri: "<your-redirect-uri-here>", authority: authority)
if let application = try? MSALPublicClientApplication(configuration: config) { /* Use application */}