국가별 클라우드 환경에서 MSAL 사용

MSAL.NET 사용하여 사용자를 로그인하고, 토큰을 획득하고, 국가별 클라우드에서 Microsoft Graph API를 호출할 수 있습니다.

다음 자습서에서는 ASP.NET Core 웹앱을 빌드하는 방법을 보여 줍니다. 앱은 OpenID Connect를 사용하여 국가별 클라우드에 속한 조직의 회사 및 학교 계정으로 사용자를 로그인합니다.

• 사용자를 로그인하고 토큰을 획득하려면 다음 자습서를 따릅니다. Microsoft ID 플랫폼을 사용하여 소버린 클라우드에서 ASP.NET Core 웹앱 로그인 사용자를 빌드합니다.
• Microsoft Graph API를 호출하려면 다음 튜토리얼을 따르세요: Microsoft National Cloud에서 회사 및 학교 계정을 사용하여 로그인하는 사용자를 대신해 ASP.NET Core 웹 앱에서 Microsoft ID 플랫폼을 사용하여 Microsoft Graph API를 호출하기.

소버린 클라우드에 MSAL.js 애플리케이션을 사용하도록 설정하려면 다음을 수행합니다.

• 클라우드에 따라 특정 포털에 애플리케이션을 등록합니다. 포털을 선택하는 방법에 대한 자세한 내용은 앱 등록 엔드포인트를 참조하세요.
• 다음에 언급된 클라우드에 따라 구성에 대한 몇 가지 변경 내용과 함께 리포지토리의 샘플을 사용합니다.
• 애플리케이션을 등록한 클라우드에 따라 특정 기관을 사용합니다. 다양한 클라우드의 권한에 대한 자세한 내용은 Microsoft Entra 인증 엔드포인트를 참조하세요.
• Microsoft Graph API를 호출하려면 사용 중인 클라우드와 관련된 엔드포인트 URL이 필요합니다. 모든 국가별 클라우드에 대한 Microsoft Graph 엔드포인트를 찾으려면 Microsoft Graph 및 Graph Explorer 서비스 루트 엔드포인트를 참조하세요.

다음은 예제 기관입니다.

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

범위가 있는 Microsoft Graph 엔드포인트의 예는 다음과 같습니다.

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

소버린 클라우드를 사용하여 사용자를 인증하고 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
})

소버린 클라우드에 MSAL Python 애플리케이션을 사용하도록 설정하려면 다음을 수행합니다.

• 클라우드에 따라 특정 포털에 애플리케이션을 등록합니다. 포털을 선택하는 방법에 대한 자세한 내용은 앱 등록 엔드포인트를 참조하세요.

• 다음에 언급된 클라우드에 따라 구성에 대한 몇 가지 변경 내용과 함께 리포지토리의 샘플을 사용합니다.

• 애플리케이션을 등록한 클라우드에 따라 특정 기관을 사용합니다. 다양한 클라우드의 권한에 대한 자세한 내용은 Microsoft Entra 인증 엔드포인트를 참조하세요.

  다음은 예제 기관입니다.

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

• Microsoft Graph API를 호출하려면 사용 중인 클라우드와 관련된 엔드포인트 URL이 필요합니다. 모든 국가별 클라우드에 대한 Microsoft Graph 엔드포인트를 찾으려면 Microsoft Graph 및 Graph Explorer 서비스 루트 엔드포인트를 참조하세요.

  범위가 있는 Microsoft Graph 엔드포인트의 예는 다음과 같습니다.

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

소버린 클라우드에 대해 Java 애플리케이션용 MSAL을 사용하도록 설정하려면 다음을 수행합니다.

• 클라우드에 따라 특정 포털에 애플리케이션을 등록합니다. 포털을 선택하는 방법에 대한 자세한 내용은 앱 등록 엔드포인트를 참조하세요.
• 다음에 언급된 클라우드에 따라 구성에 대한 몇 가지 변경 내용과 함께 리포지토리의 샘플을 사용합니다.
• 애플리케이션을 등록한 클라우드에 따라 특정 기관을 사용합니다. 다양한 클라우드의 권한에 대한 자세한 내용은 Microsoft Entra 인증 엔드포인트를 참조하세요.

다음은 예제 기관입니다.

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

• Microsoft Graph API를 호출하려면 사용 중인 클라우드와 관련된 엔드포인트 URL이 필요합니다. 모든 국가별 클라우드에 대한 Microsoft Graph 엔드포인트를 찾으려면 Microsoft Graph 및 Graph Explorer 서비스 루트 엔드포인트를 참조하세요.

다음은 범위가 있는 그래프 엔드포인트의 예입니다.

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

iOS 및 macOS용 MSAL을 사용하여 국가별 클라우드에서 토큰을 획득할 수 있지만 만들 MSALPublicClientApplication때 추가 구성이 필요합니다.

예를 들어 애플리케이션이 국가 클라우드(여기 미국 정부)의 다중 테넌트 애플리케이션이 되도록 하려면 다음을 작성할 수 있습니다.

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];

iOS 및 macOS용 MSAL을 사용하여 국가별 클라우드에서 토큰을 획득할 수 있지만 만들 MSALPublicClientApplication때 추가 구성이 필요합니다.

예를 들어 애플리케이션이 국가 클라우드(여기 미국 정부)의 다중 테넌트 애플리케이션이 되도록 하려면 다음을 작성할 수 있습니다.

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