Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
По умолчанию пакеты SDK Microsoft Graph настраиваются для доступа к данным в глобальной службе Microsoft Graph, используя корневой https://graph.microsoft.com URL-адрес для доступа к REST API Microsoft Graph. Разработчики могут переопределить эту конфигурацию, чтобы подключиться к национальным облачным развертываниям Microsoft Graph.
Предварительные условия
Для настройки пакета SDK Microsoft Graph для подключения к национальному облачному развертыванию потребуются следующие сведения.
- Сведения о регистрации приложения, такие как идентификатор клиента, идентификатор клиента, секрет клиента или сертификат. Регистрация приложения должна быть создана в Центр администрирования Microsoft Entra, соответствующем развертыванию национального облака. Дополнительные сведения см. в статье Регистрация приложений и корневые конечные точки службы маркеров .
- Конечная точка маркера для развертывания национального облака.
- Корневая конечная точка службы Microsoft Graph для развертывания национального облака. Список конечных точек см. в статье Microsoft Graph и Graph Обозреватель корневых конечных точек службы.
Настройка пакета SDK
Чтобы подключиться к национальному облачному развертыванию, необходимо настроить поставщик проверки подлинности для подключения к правильной конечной точке службы маркеров. Затем необходимо настроить клиент SDK для подключения к правильной корневой конечной точке службы Microsoft Graph.
Области разрешений
Любое значение разрешения область (включая .default область), содержащее домен Microsoft Graph, должно использовать домен корневой конечной точки службы Microsoft Graph для развертывания национального облака. Сокращенные имена разрешений область, например User.Read или Mail.Send, также допустимы.
- Для добавочного или динамического согласия
User.Readиhttps://graph.microsoft.us/User.Readэквивалентны для национального облака уровня 4 для государственных организаций США. - Для статически определенных разрешений или если вы используете поток учетных данных клиента для разрешений только для приложений,
https://graph.microsoft.us/.defaultявляется правильным.defaultобласть значение.
Примеры
В следующем примере поставщик интерактивной проверки подлинности с пакетом SDK Microsoft Graph настраивается для подключения к Microsoft Graph для национального облака уровня 4 для государственных организаций США.
// 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,
isCaeEnabled: true,
scopes: ["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");