Zugreifen auf nationale Cloudbereitstellungen mit den Microsoft Graph SDKs

Standardmäßig sind die Microsoft Graph SDKs für den Zugriff auf Daten im globalen Microsoft Graph-Dienst konfiguriert, wobei die https://graph.microsoft.com Stamm-URL für den Zugriff auf die Microsoft Graph-REST-API verwendet wird. Entwickler können diese Konfiguration überschreiben, um eine Verbindung mit nationalen Microsoft Graph-Cloudbereitstellungen herzustellen.

Voraussetzungen

Sie benötigen die folgenden Informationen, um ein Microsoft Graph SDK für die Verbindung mit einer nationalen Cloudbereitstellung zu konfigurieren.

• Anwendungsregistrierungsdetails, z. B. Client-ID, Mandanten-ID und geheimer Clientschlüssel oder Zertifikat. Die Anwendungsregistrierung MUSS in der Microsoft Entra Admin Center erstellt werden, die der bereitstellung der nationalen Cloud entspricht. Ausführliche Informationen finden Sie unter App-Registrierung und Tokendienststammendpunkte .
• Der Tokenendpunkt für die Bereitstellung der nationalen Cloud.
• Der Microsoft Graph-Dienststammendpunkt für die Bereitstellung der nationalen Cloud. Eine Liste der Endpunkte finden Sie unter Microsoft Graph und Graph Explorer Dienststammendpunkte.

Konfigurieren des SDK

Um eine Verbindung mit einer nationalen Cloudbereitstellung herzustellen, müssen Sie Ihren Authentifizierungsanbieter so konfigurieren, dass er eine Verbindung mit dem richtigen Tokendienstendpunkt herstellt. Anschließend müssen Sie den SDK-Client so konfigurieren, dass er eine Verbindung mit dem richtigen Microsoft Graph-Dienststammendpunkt herstellt.

Berechtigungsbereiche

Jeder Berechtigungsbereichswert (einschließlich des Bereichs), der .default die Microsoft Graph-Domäne enthält, MUSS die Domäne des Microsoft Graph-Dienststammendpunkts für die bereitstellung der nationalen Cloud verwenden. Die verkürzten Namen des Berechtigungsbereichs, z User.Read . B. oder Mail.Send, sind ebenfalls gültig.

• Für inkrementelle oder dynamische ZustimmungUser.Read, und https://graph.microsoft.us/User.Read sind gleichwertig für die nationale Us Government L4-Cloud.
• Für statisch definierte Berechtigungen oder, wenn Sie den Clientanmeldeinformationsflow für Nur-App-Berechtigungen verwenden, https://graph.microsoft.us/.default ist der richtige .default Bereichswert.

Beispiele

Im folgenden Beispiel wird ein Interaktiver Authentifizierungsanbieter mit dem Microsoft Graph SDK konfiguriert, um eine Verbindung mit der nationalen Microsoft Graph für US Government L4-Cloud herzustellen.

C#

// Create the InteractiveBrowserCredential using details
// from app registered in the Azure AD for US Government portal
var credential = new InteractiveBrowserCredential(
    "YOUR_TENANT_ID",
    "YOUR_CLIENT_ID",
    new InteractiveBrowserCredentialOptions
    {
        // https://login.microsoftonline.us
        AuthorityHost = AzureAuthorityHosts.AzureGovernment,
        RedirectUri = new Uri("YOUR_REDIRECT_URI"),
    });

// Create the authentication provider
var authProvider = new AzureIdentityAuthenticationProvider(
    credential,
    ["https://graph.microsoft.us/.default"]);

// Create the Microsoft Graph client object using
// the Microsoft Graph for US Government L4 endpoint
// NOTE: The API version must be included in the URL
var graphClient = new GraphServiceClient(
    authProvider,
    "https://graph.microsoft.us/v1.0");

OK

import (
    "github.com/Azure/azure-sdk-for-go/sdk/azcore/cloud"
    "github.com/Azure/azure-sdk-for-go/sdk/azcore/policy"
    "github.com/Azure/azure-sdk-for-go/sdk/azidentity"
    graph "github.com/microsoftgraph/msgraph-sdk-go"
    auth "github.com/microsoftgraph/msgraph-sdk-go-core/authentication"
)

// Create the InteractiveBrowserCredential using details
// from app registered in the Azure AD for US Government portal
credential, _ := azidentity.NewInteractiveBrowserCredential(
    &azidentity.InteractiveBrowserCredentialOptions{
        ClientID: "YOUR_CLIENT_ID",
        TenantID: "YOUR_TENANT_ID",
        ClientOptions: policy.ClientOptions{
            // https://login.microsoftonline.us
            Cloud: cloud.AzureGovernment,
        },
        RedirectURL: "YOUR_REDIRECT_URL",
    })

// Create the authentication provider
authProvider, _ := auth.NewAzureIdentityAuthenticationProviderWithScopes(credential,
    []string{"https://graph.microsoft.us/.default"})

// Create a request adapter using the auth provider
adapter, _ := graph.NewGraphRequestAdapter(authProvider)

// Set the service root to the
// Microsoft Graph for US Government L4 endpoint
// NOTE: The API version must be included in the URL
adapter.SetBaseUrl("https://graph.microsoft.us/v1.0")

// Create a Graph client using request adapter
graphClient := graph.NewGraphServiceClient(adapter)

Java

// Create the InteractiveBrowserCredential using details
// from app registered in the Azure AD for US Government portal
final InteractiveBrowserCredential credential = new InteractiveBrowserCredentialBuilder()
    .clientId("YOUR_CLIENT_ID").tenantId("YOUR_TENANT_ID")
    // https://login.microsoftonline.us
    .authorityHost(AzureAuthorityHosts.AZURE_GOVERNMENT)
    .redirectUrl("YOUR_REDIRECT_URI").build();

final String[] scopes = new String[] {"https://graph.microsoft.us/.default"};

// Create the authentication provider
if (null == scopes || null == credential) {
    throw new Exception("Unexpected error");
}

final GraphServiceClient graphClient = new GraphServiceClient(credential, scopes);
// Set the service root to the
// Microsoft Graph for US Government L4 endpoint
// NOTE: The API version must be included in the URL
graphClient.getRequestAdapter().setBaseUrl("https://graph.microsoft.us/v1.0");

PHP

$scopes = ['https://graph.microsoft.us/.default'];

// Create the Microsoft Graph client object using
// the Microsoft Graph for US Government L4 endpoint
// $tokenRequestContext is one of the token context classes
// from Microsoft\Kiota\Authentication\Oauth
$graphClient = new GraphServiceClient($tokenRequestContext, $scopes, NationalCloud::US_GOV);

PowerShell

Connect-MgGraph -Environment USGov -ClientId 'YOUR_CLIENT_ID' `
  -TenantId 'YOUR_TENANT_ID' -Scopes 'https://graph.microsoft.us/.default'

Python

scopes = ['https://graph.microsoft.us/.default']

credential = InteractiveBrowserCredential(
    tenant_id='YOUR_TENANT_ID',
    client_id='YOUR_CLIENT_ID',
    redirect_uri='YOUR_REDIRECT_URI')

auth_provider = AzureIdentityAuthenticationProvider(credential, scopes=scopes)

# Create the HTTP client using
# the Microsoft Graph for US Government L4 endpoint
http_client = GraphClientFactory.create_with_default_middleware(
    host=NationalClouds.US_GOV)

adapter = GraphRequestAdapter(auth_provider, http_client)

graph_client = GraphServiceClient(request_adapter=adapter)

TypeScript

// Create the InteractiveBrowserCredential using details
// from app registered in the Azure AD for US Government portal
const credential = new InteractiveBrowserCredential({
  clientId: 'YOUR_CLIENT_ID',
  tenantId: 'YOUR_TENANT_ID',
  // https://login.microsoftonline.us
  authorityHost: AzureAuthorityHosts.AzureGovernment,
  redirectUri: 'YOUR_REDIRECT_URI',
});

// Create the authentication provider
const authProvider = new TokenCredentialAuthenticationProvider(credential, {
  scopes: ['https://graph.microsoft.us/.default'],
});

// Create the Microsoft Graph client object using
// the Microsoft Graph for US Government L4 endpoint
// NOTE: Do not include the version in the baseUrl
const graphClient = Client.initWithMiddleware({
  authProvider: authProvider,
  baseUrl: 'https://graph.microsoft.us',
});