Поделиться через


Обновление crossTenantAccessPolicyConfigurationPartner

Пространство имен: microsoft.graph

Обновите свойства конфигурации для конкретного партнера .

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба Правительство США L4 Правительство США L5 (DOD) Китай управляется 21Vianet

Разрешения

Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.

Тип разрешения Разрешения с наименьшими привилегиями Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись) Policy.ReadWrite.CrossTenantAccess Недоступно.
Делегированные (личная учетная запись Майкрософт) Не поддерживается. Не поддерживается.
Приложение Policy.ReadWrite.CrossTenantAccess Недоступно.

HTTP-запрос

PATCH /policies/crossTenantAccessPolicy/partners/{id}

Заголовки запросов

Имя Описание
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
Content-Type application/json. Обязательно.

Текст запроса

Укажите в тексте запроса только значения обновляемых свойств. Существующие свойства, которые не включены в текст запроса, сохраняют свои предыдущие значения или пересчитываются на основе изменений других значений свойств.

В следующей таблице указаны свойства, которые можно обновить.

Свойство Тип Описание
automaticUserConsentSettings inboundOutboundPolicyConfiguration Определяет конфигурацию для партнера для параметров автоматического согласия пользователя.
b2bCollaborationInbound crossTenantAccessPolicyB2BSetting Определяет конфигурацию партнера для пользователей из других организаций, обращаюющихся к вашим ресурсам через совместную работу Microsoft Entra B2B.
b2bCollaborationOutbound crossTenantAccessPolicyB2BSetting Определяет конфигурацию партнера для пользователей в вашей организации, отправляющихся на исходящий доступ к ресурсам в другой организации через совместную работу Microsoft Entra B2B.
b2bDirectConnectInbound crossTenantAccessPolicyB2BSetting Определяет конфигурацию партнера для пользователей из других организаций, обращаюющихся к вашим ресурсам через прямое подключение Microsoft Entra B2B.
b2bDirectConnectOutbound crossTenantAccessPolicyB2BSetting Определяет конфигурацию конкретного партнера для пользователей в вашей организации, которые получают исходящий доступ к ресурсам в другой организации через прямое подключение Microsoft Entra B2B.
inboundTrust crossTenantAccessPolicyInboundTrust Определяет конфигурацию партнера для доверия другим утверждениям условного доступа из внешних организаций Microsoft Entra.
tenantRestrictions crossTenantAccessPolicyTenantRestrictions Определяет конфигурацию ограничений клиента по умолчанию для пользователей в вашей организации, которые получают доступ к внешней организации в вашей сети или на устройствах.

Отклик

В случае успешного выполнения этот метод возвращает код отклика 204 No Content.

Примеры

Пример 1. Настройка параметров входящего доверия

В следующем примере настраивается политика для конкретного партнера, задавая параметры входящего доверия, чтобы принимать MFA, совместимые устройства и устройства с гибридным присоединением к Microsoft Entra от клиента партнера.

Запрос

Ниже показан пример запроса.

PATCH https://graph.microsoft.com/v1.0/policies/crossTenantAccessPolicy/partners/90e29127-71ad-49c7-9ce8-db3f41ea06f1
Content-Type: application/json

{
  "inboundTrust": {
    "isMfaAccepted": true,
    "isCompliantDeviceAccepted": true,
    "isHybridAzureADJoinedDeviceAccepted": true
  }
}

Отклик

Ниже показан пример отклика.

HTTP/1.1 204 No Content

Пример 2. Настройка параметров automaticUserConsent

В следующем примере настраивается политика для конкретного партнера, предоставляя согласие на совместную работу B2B от имени пользователей и принимая согласие администратора для пользователей партнера.

Запрос

Ниже показан пример запроса.

PATCH https://graph.microsoft.com/v1.0/policies/crossTenantAccessPolicy/partners/90e29127-71ad-49c7-9ce8-db3f41ea06f1
Content-Type: application/json

{
  "automaticUserConsentSettings": {
    "inboundAllowed": true,
    "outboundAllowed": true
  }
}

Отклик

Ниже показан пример отклика.

HTTP/1.1 204 No Content

Пример 3. Настройка параметров ограничений клиента

В следующем примере показано, как настроить параметры ограничений клиента.

Запрос

Ниже показан пример запроса.

PATCH https://graph.microsoft.com/beta/policies/crossTenantAccessPolicy/partners/90e29127-71ad-49c7-9ce8-db3f41ea06f1
Content-Type: application/json

{
  "tenantRestrictions": {
    "usersAndGroups": {
      "accessType": "allowed",
      "targets": [
        {
          "target": "AllUsers",
          "targetType": "user"
        }
      ]
    },
    "applications": {
      "accessType": "allowed",
      "targets": [
        {
          "target": "Office365",
          "targetType": "application"
        }
      ]
    }
  }
}

Отклик

Ниже приводится пример отклика.

HTTP/1.1 204 No Content