Utiliser MSAL dans un environnement de cloud national

Vous pouvez utiliser MSAL.NET pour connecter des utilisateurs, acquérir des jetons et appeler l’API Microsoft Graph dans des clouds nationaux.

Les didacticiels suivants montrent comment créer une application web ASP.NET Core. L’application utilise OpenID Connect pour connecter des utilisateurs avec un compte professionnel et scolaire dans une organisation appartenant à un cloud national.

• Pour connecter des utilisateurs et obtenir des jetons, suivez ce tutoriel : Créer une application web ASP.NET Core en connectant les utilisateurs dans des clouds souverains avec la plateforme d’identités Microsoft.
• Pour appeler l’API Microsoft Graph, suivez ce tutoriel : Utilisation de la plateforme d’identités Microsoft pour appeler l’API Microsoft Graph à partir d’une application web ASP.NET Core, pour le compte d’un utilisateur qui se connecte à l’aide de son compte professionnel et scolaire dans le cloud national Microsoft.

Pour activer votre application MSAL.js pour les clouds souverains :

• Inscrivez votre application dans un portail spécifique en fonction du cloud. Pour plus d’informations sur la façon de choisir le portail, reportez-vous à Points de terminaison d’inscription d’application
• Utilisez n’importe lequel des exemple du référentiel en apportant quelques modifications à la configuration, en fonction du cloud, comme mentionné ci-dessous.
• Utilisez une autorité spécifique, en fonction du cloud dans lequel vous avez inscrit l’application. Pour plus d'informations sur les autorités pour différents cloud, reportez-vous à Points de terminaison d'authentification Microsoft Entra.
• L’appel de l’API Microsoft Graph nécessite une URL de point de terminaison spécifique au cloud que vous utilisez. Pour rechercher des points de terminaison Microsoft Graph pour tous les clouds nationaux, consultez Points de terminaison racine de service de jetons et d’inscription de l’application.

Voici un exemple d’autorité :

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

Voici un exemple de point de terminaison Microsoft Graph, avec l’étendue :

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

Voici le code minimal pour l’authentification d’un utilisateur avec cloud souverain et appelant 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
})

Pour activer votre application MSAL Python pour les clouds souverains :

• Inscrivez votre application dans un portail spécifique en fonction du cloud. Pour plus d’informations sur la façon de choisir le portail, reportez-vous à Points de terminaison d’inscription d’application

• Utilisez n’importe lequel des exemple du référentiel en apportant quelques modifications à la configuration, en fonction du cloud, comme mentionné ci-dessous.

• Utilisez une autorité spécifique, en fonction du cloud dans lequel vous avez inscrit l’application. Pour plus d’informations sur les autorités pour différents cloud, consultez Points de terminaison d’authentification Microsoft Entra.

  Voici un exemple d’autorité :

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

• L’appel de l’API Microsoft Graph nécessite une URL de point de terminaison spécifique au cloud que vous utilisez. Pour rechercher des points de terminaison Microsoft Graph pour tous les clouds nationaux, consultez Points de terminaison racine de service de jetons et d’inscription de l’application.

  Voici un exemple de point de terminaison Microsoft Graph, avec l’étendue :

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

Pour activer votre application MSAL pour Java pour les clouds souverains :

• Inscrivez votre application dans un portail spécifique en fonction du cloud. Pour plus d’informations sur la façon de choisir le portail, reportez-vous à Points de terminaison d’inscription d’application
• Utilisez n’importe lequel des exemples du référentiel en apportant quelques modifications à la configuration, en fonction du cloud, comme mentionné ci-dessous.
• Utilisez une autorité spécifique, en fonction du cloud dans lequel vous avez inscrit l’application. Pour plus d’informations sur les autorités pour différents cloud, consultez Points de terminaison d’authentification Microsoft Entra.

Voici un exemple d’autorité :

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

• L’appel de l’API Microsoft Graph nécessite une URL de point de terminaison spécifique au cloud que vous utilisez. Pour rechercher des points de terminaison Microsoft Graph pour tous les clouds nationaux, consultez Points de terminaison racine de service de jetons et d’inscription de l’application.

Voici un exemple de point de terminaison Graph, avec l’étendue :

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

MSAL pour iOS et macOS peut être utilisé pour acquérir des jetons dans les clouds ​​nationaux, mais une configuration supplémentaire est nécessaire lors de la création de MSALPublicClientApplication.

Par exemple, si vous souhaitez que votre application soit mutualisée dans un cloud national (US Government, en l’occurrence), vous pouvez écrire :

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 pour iOS et macOS peut être utilisé pour acquérir des jetons dans les clouds ​​nationaux, mais une configuration supplémentaire est nécessaire lors de la création de MSALPublicClientApplication.

Par exemple, si vous souhaitez que votre application soit mutualisée dans un cloud national (US Government, en l’occurrence), vous pouvez écrire :

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 */}