Uso de MSAL en un entorno de nube nacional

Puede usar MSAL.NET para iniciar sesión de usuarios, adquirir tokens y llamar a Microsoft Graph API en nubes nacionales.

En los tutoriales siguientes se muestra cómo compilar una aplicación web ASP.NET Core. La aplicación usa OpenID Connect para iniciar sesión de usuarios con una cuenta profesional y educativa en una organización que pertenezca a una nube nacional.

• Para iniciar sesión de usuarios y adquirir tokens, siga este tutorial: Creación de una aplicación web de ASP.NET Core que inicia sesión de usuarios en nubes soberanas con la plataforma de identidad de Microsoft.
• Para llamar a Microsoft Graph API, siga este tutorial: Uso de la plataforma de identidad de Microsoft para llamar a Microsoft Graph API desde una aplicación web de ASP.NET Core, en nombre de un usuario que inicia sesión con su cuenta profesional y educativa en Microsoft National Cloud.

Para habilitar la aplicación MSAL.js para las nubes soberanas:

• Registre la aplicación en un portal específico, en función de la nube. Para más información sobre cómo elegir el portal, consulte los puntos finales de registro de aplicaciones.
• Use cualquiera de los ejemplos del repositorio con algunos cambios en la configuración, en función de la nube, que se menciona a continuación.
• Use una autoridad específica, en función de la nube en la que registró la aplicación. Para obtener más información sobre las autoridades de distintas nubes, consulte Puntos de conexión de Autenticación de Microsoft Entra.
• Llamar a Microsoft Graph API requiere una dirección URL de punto de conexión específica de la nube que usa. Para encontrar los puntos de conexión de Microsoft Graph para todas las nubes nacionales, consulte la sección titulada Puntos de conexión raíz del servicio Microsoft Graph y Graph Explorer.

Esta es una autoridad de ejemplo:

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

A continuación, se muestra un ejemplo de un punto de conexión de Microsoft Graph con el ámbito:

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

Este es el código mínimo para autenticar a un usuario con una nube soberana y llamar a 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 su aplicación de MSAL en Python para nubes soberanas:

• Registre la aplicación en un portal específico, en función de la nube. Para más información sobre cómo elegir el portal, consulte Puntos finales de registro de aplicaciones.

• Use cualquiera de los ejemplos del repositorio con algunos cambios en la configuración, en función de la nube, que se menciona a continuación.

• Use una autoridad específica, en función de la nube en la que registró la aplicación. Para obtener más información sobre las autoridades para diferentes nubes, consulte los Puntos de conexión de autenticación de Microsoft Entra.

  Esta es una autoridad de ejemplo:

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

• Llamar a Microsoft Graph API requiere una dirección URL de punto de conexión específica de la nube que usa. Para encontrar los puntos de conexión de Microsoft Graph para todas las nubes nacionales, consulte los puntos de conexión raíz del servicio de Microsoft Graph y de la Graph Explorer.

  Este es un ejemplo de un endpoint de Microsoft Graph, con alcance:

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

Para habilitar la aplicación MSAL para Java para nubes soberanas:

• Registre la aplicación en un portal específico, en función de la nube. Para más información sobre cómo elegir el portal, consulte los puntos finales de registro de aplicaciones.
• Use cualquiera de los ejemplos del repositorio con algunos cambios en la configuración, en función de la nube, que se mencionan a continuación.
• Use una autoridad específica, en función de la nube en la que registró la aplicación. Para obtener más información sobre las autoridades de distintas nubes, consulte Puntos de conexión de Autenticación de Microsoft Entra.

Esta es una autoridad de ejemplo:

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

• Llamar a Microsoft Graph API requiere una dirección URL de punto de conexión específica de la nube que usa. Para obtener puntos de conexión de Microsoft Graph para todas las nubes nacionales, consulte los puntos de conexión raíz del servicio Microsoft Graph y Graph Explorer.

A continuación se muestra un ejemplo de un punto de conexión de Graph con el ámbito:

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

MSAL para iOS y macOS se puede usar para adquirir tokens en nubes nacionales, pero requiere una configuración adicional al crear MSALPublicClientApplication.

Por ejemplo, si quiere que la aplicación sea una aplicación multiinquilino en una nube nacional (aquí gobierno de EE. UU.), puede escribir:

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 y macOS se puede usar para adquirir tokens en nubes nacionales, pero requiere una configuración adicional al crear MSALPublicClientApplication.

Por ejemplo, si quiere que la aplicación sea una aplicación multiinquilino en una nube nacional (aquí gobierno de EE. UU.), puede escribir:

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