Verwenden der MSAL in einer nationalen Cloudumgebung

Über MSAL.NET können Sie Benutzer anmelden, Token anfordern und die Microsoft Graph-API in nationalen Clouds aufrufen.

In den folgenden Tutorials erfahren Sie, wie Sie eine ASP.NET Core Web-App erstellen. Die App verwendet OpenID Connect, um Benutzer mit einem Geschäfts-, Schul- oder Unikonto in einer Organisation anzumelden, die zu einer nationalen Cloud gehört.

• Um Benutzer anzumelden und Token zu erwerben, folgen Sie diesem Tutorial: Erstellen einer ASP.NET Core-Webanwendung, mit der Sie Benutzer in Sovereign Clouds mit der Microsoft Identity Platform anmelden.
• Um die Microsoft Graph API aufzurufen, folgen Sie diesem Tutorial: Verwenden der Microsoft Identity Platform zum Abrufen der Microsoft Graph-API aus einer ASP.NET Core 2.x-Web-App im Namen eines Benutzers, der sich mit seinem Geschäfts-, Schul- oder Unikonto bei einer nationalen Microsoft-Cloud anmeldet.

So aktivieren Sie Ihre MSAL.js-Anwendung für Sovereign Clouds

• Registrieren Sie Ihre Anwendung abhängig von der Cloud in einem bestimmten Portal. Weitere Informationen zum Auswählen des Portals finden Sie unter App-Registrierungsendpunkte.
• Verwenden Sie abhängig von der Cloud eines der Beispiele aus dem Repository mit einigen Änderungen, die im Folgenden genannt werden.
• Verwenden Sie abhängig von der Cloud, in der Sie die Anwendung registriert haben, eine bestimmte Autorisierung. Weitere Informationen zu autoritativen Stellen für verschiedene Clouds finden Sie unter Microsoft Entra-Authentifizierungsendpunkte.
• Zum Aufrufen der Microsoft Graph-API ist eine Endpunkt-URL erforderlich, die für die von Ihnen verwendete Cloud spezifisch ist. Informationen zum Ermitteln von Microsoft Graph-Endpunkten für alle nationalen Clouds finden Sie unter Stammendpunkte für Microsoft Graph und Graph Explorer.

Hier ist ein Beispiel für eine Autorisierung:

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

Hier finden Sie ein Beispiel für einen Microsoft Graph-Endpunkt mit einem Bereich:

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

Im Folgenden finden Sie den minimalen Code zum Authentifizieren eines Benutzers bei einer Sovereign Cloud und zum Aufrufen von 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
})

So aktivieren Sie Ihre MSAL-Python-Anwendung für Sovereign Clouds

• Registrieren Sie Ihre Anwendung abhängig von der Cloud in einem bestimmten Portal. Weitere Informationen zum Auswählen des Portals finden Sie unter App-Registrierungsendpunkte.

• Verwenden Sie abhängig von der Cloud eines der Beispiele aus dem Repository mit einigen Änderungen, die im Folgenden genannt werden.

• Verwenden Sie abhängig von der Cloud, in der Sie die Anwendung registriert haben, eine bestimmte Autorisierung. Weitere Informationen zu autoritativen Stellen für verschiedene Clouds finden Sie unter Microsoft Entra-Authentifizierungsendpunkte.

  Hier ist ein Beispiel für eine Autorisierung:

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

• Zum Aufrufen der Microsoft Graph-API ist eine Endpunkt-URL erforderlich, die für die von Ihnen verwendete Cloud spezifisch ist. Informationen zum Ermitteln von Microsoft Graph-Endpunkten für alle nationalen Clouds finden Sie unter Stammendpunkte für Microsoft Graph und Graph Explorer.

  Hier finden Sie ein Beispiel für einen Microsoft Graph-Endpunkt mit einem Bereich:

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

So aktivieren Sie Ihre MSAL-Java-Anwendung für Sovereign Clouds

• Registrieren Sie Ihre Anwendung abhängig von der Cloud in einem bestimmten Portal. Weitere Informationen zum Auswählen des Portals finden Sie unter App-Registrierungsendpunkte.
• Verwenden Sie abhängig von der Cloud eines der Beispiele aus dem Repository mit einigen Änderungen, die im Folgenden genannt werden.
• Verwenden Sie abhängig von der Cloud, in der Sie die Anwendung registriert haben, eine bestimmte Autorisierung. Weitere Informationen zu autoritativen Stellen für verschiedene Clouds finden Sie unter Microsoft Entra-Authentifizierungsendpunkte.

Hier ist ein Beispiel für eine Autorisierung:

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

• Zum Aufrufen der Microsoft Graph-API ist eine Endpunkt-URL erforderlich, die für die von Ihnen verwendete Cloud spezifisch ist. Informationen zum Ermitteln von Microsoft Graph-Endpunkten für alle nationalen Clouds finden Sie unter Stammendpunkte für Microsoft Graph und Graph Explorer.

Hier ist ein Beispiel für einen Graph-Endpunkt mit einem Bereich:

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

MSAL für iOS und macOS kann zum Abrufen von Token in nationalen Clouds verwendet werden. Für die Erstellung von MSALPublicClientApplication ist jedoch zusätzliche Konfiguration erforderlich.

Wenn Sie beispielsweise möchten, dass Ihre Anwendung eine mehrinstanzenfähige Anwendung in einer nationalen Cloud (in diesem Fall US Government) ist, könnten Sie Folgendes schreiben:

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 für iOS und macOS kann zum Abrufen von Token in nationalen Clouds verwendet werden. Für die Erstellung von MSALPublicClientApplication ist jedoch zusätzliche Konfiguration erforderlich.

Wenn Sie beispielsweise möchten, dass Ihre Anwendung eine mehrinstanzenfähige Anwendung in einer nationalen Cloud (in diesem Fall US Government) ist, könnten Sie Folgendes schreiben:

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