Usar o MSAL em um ambiente de nuvem nacional

Você pode usar MSAL.NET para entrar usuários, adquirir tokens e chamar a API do Microsoft Graph em nuvens nacionais.

Os tutoriais a seguir demonstram como criar um aplicativo Web ASP.NET Core. O aplicativo usa o OpenID Connect para fazer login de usuários com uma conta corporativa e de estudante em uma organização que pertence a uma nuvem nacional.

• Para iniciar sessão de utilizadores e adquirir tokens, siga este tutorial: Crie uma aplicação Web ASP.NET Core que inicie sessão em utilizadores em nuvens soberanas com a plataforma de identidade da Microsoft.
• Para chamar a API do Microsoft Graph, siga este tutorial: Usando a plataforma de identidade da Microsoft para chamar a API do Microsoft Graph de um aplicativo Web ASP.NET Core, em nome de um usuário que entra usando sua conta corporativa e de estudante no Microsoft National Cloud.

Para habilitar seu aplicativo MSAL.js para nuvens soberanas:

• Registe a sua aplicação num portal específico, dependendo da nuvem. Para obter mais informações sobre como escolher o portal, consulte Pontos finais de registro do aplicativo
• Use qualquer um dos exemplos do repositório com algumas alterações na configuração, dependendo da nuvem, que é mencionada a seguir.
• Use uma autoridade específica, dependendo da nuvem em que você registrou o aplicativo. Para obter mais informações sobre autoridades para diferentes nuvens, consulte Pontos de extremidade de autenticação do Microsoft Entra.
• Chamar a API do Microsoft Graph requer uma URL de ponto de extremidade específica para a nuvem que você está usando. Para encontrar pontos de extremidade do Microsoft Graph para todas as nuvens nacionais, consulte Pontos de extremidade raiz do serviço Microsoft Graph e Graph Explorer.

Aqui está um exemplo de autoridade:

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

Aqui está um exemplo de um ponto de extremidade do Microsoft Graph, com escopo:

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

Aqui está o código mínimo para autenticar um usuário com uma nuvem soberana e chamar o 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
})

Para habilitar seu aplicativo MSAL Python para nuvens soberanas:

• Registe a sua aplicação num portal específico, dependendo da nuvem. Para obter mais informações sobre como escolher o portal, consulte Pontos finais de registro do aplicativo

• Use qualquer um dos exemplos do repositório com algumas alterações na configuração, dependendo da nuvem, que é mencionada a seguir.

• Use uma autoridade específica, dependendo da nuvem em que você registrou o aplicativo. Para obter mais informações sobre autoridades para diferentes nuvens, consulte Pontos de extremidade de autenticação do Microsoft Entra.

  Aqui está um exemplo de autoridade:

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

• Chamar a API do Microsoft Graph requer uma URL de ponto de extremidade específica para a nuvem que você está usando. Para encontrar pontos de extremidade do Microsoft Graph para todas as nuvens nacionais, consulte Pontos de extremidade raiz do serviço Microsoft Graph e Graph Explorer.

  Aqui está um exemplo de um ponto de extremidade do Microsoft Graph, com escopo:

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

Para habilitar seu aplicativo MSAL for Java para nuvens soberanas:

• Registe a sua aplicação num portal específico, dependendo da nuvem. Para obter mais informações sobre como escolher o portal, consulte Pontos finais de registro do aplicativo
• Use qualquer um dos exemplos do repositório com algumas alterações na configuração, dependendo da nuvem, que são mencionadas a seguir.
• Use uma autoridade específica, dependendo da nuvem em que você registrou o aplicativo. Para obter mais informações sobre autoridades para diferentes nuvens, consulte Pontos de extremidade de autenticação do Microsoft Entra.

Aqui está um exemplo de autoridade:

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

• Chamar a API do Microsoft Graph requer uma URL de ponto de extremidade específica para a nuvem que você está usando. Para encontrar pontos de extremidade do Microsoft Graph para todas as nuvens nacionais, consulte Pontos de extremidade raiz do serviço Microsoft Graph e Graph Explorer.

Aqui está um exemplo de um ponto de extremidade gráfico, com escopo:

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

MSAL para iOS e macOS pode ser usado para adquirir tokens em nuvens nacionais, mas requer configuração adicional ao criar MSALPublicClientApplication.

Por exemplo, se você quiser que seu aplicativo seja um aplicativo multilocatário em uma nuvem nacional (aqui Governo dos EUA), você pode escrever:

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 para iOS e macOS pode ser usado para adquirir tokens em nuvens nacionais, mas requer configuração adicional ao criar MSALPublicClientApplication.

Por exemplo, se você quiser que seu aplicativo seja um aplicativo multilocatário em uma nuvem nacional (aqui Governo dos EUA), você pode escrever:

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