userProtectionScopeContainer: compute

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

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

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

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

Разрешения

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

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

HTTP-запрос

POST /me/dataSecurityAndGovernance/protectionScopes/compute

Примечание.

Для вызова конечной точки /me требуется вход пользователя и, следовательно, делегированное разрешение. Разрешения приложений не поддерживаются при использовании конечной /me точки.

POST /users/{usersId}/dataSecurityAndGovernance/protectionScopes/compute

Примечание.

Если у вас есть только userPrincipalName пользователя, используйте следующий URL-адрес для получения идентификатора объекта.

GET https://graph.microsoft.com/v1.0/users/{userPrincipalName}?$select=id

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

Имя Описание
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
Content-Type application/json. Обязательно.
Идентификатор запроса клиента Строка (рекомендуется GUID). Необязательный параметр. Уникальный идентификатор для этого запроса, который используется для трассировки и отладки в журналах и поддержки взаимодействий. Если идентификатор не указан, он может быть создан автоматически. Рекомендуется указать идентификатор, чтобы упростить трассировку и отладку. В ответе возвращается тот же идентификатор, который был отправлен в запросе.

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

В тексте запроса предоставьте JSON-объект с указанными ниже параметрами.

Параметр Тип Описание
activities microsoft.graph.security.userActivityTypes Необязательный параметр. Флаги, указывающие действия пользователя, поддерживаемые вызывающим приложением или интересующие его. Возможные значения: none, uploadText, uploadFile, downloadText, downloadFile, 'unknownFutureValue. Этот объект является многозначным перечислением.
deviceMetadata deviceMetadata Необязательный параметр. Сведения об устройстве пользователя (тип, ОС), используемом для оценки контекстной политики.
integratedAppMetadata integratedApplicationMetadata Необязательный параметр. Сведения о вызывающем приложении (имя, версия), интегрируемом с Microsoft Purview.
locations Коллекция policyLocation Необязательный параметр. Список конкретных расположений, в которые заинтересовано приложение. Если это указано, результаты обрезаются по политикам, охватывающим эти расположения. Используйте приложение расположения политики для расположений приложений, домен расположения политики для доменных расположений или URL-адрес расположения политики для расположений URL-адресов. Необходимо указать @odata.type свойство для объявления типа policyLocation. Например, "@odata.type": "microsoft.graph.policyLocationApplication".
Сводный раздел microsoft.graph.policyPivotProperty Необязательный параметр. Указывает способ агрегирования результатов. Если опущен или none, результаты могут быть менее агрегированными. Возможные значения: activity,location . none

Заголовки откликов

Имя Описание
Etag Индикатор изменения состояния политики, настроенной администратором. Если вы кэшировали значение Etag и оно совпадает с ETag из предыдущих результатов этого API, нет необходимости анализировать ответ и кэшировать проанализированные результаты. Кэшируйте это значение для вызовов для обработки содержимого.

Отклик

В случае успешного 200 OK выполнения это действие возвращает код отклика и коллекцию объектов policyUserScope в теле отклика. Каждый объект представляет набор расположений и действий, управляемых общим набором действий политики и режима выполнения для указанного пользователя.

Примеры

Пример 1. Защита вычислительных ресурсов область для корпоративного приложения

Запрос

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

POST https://graph.microsoft.com/v1.0/users/7c1f8f10-cba8-4a8d-9449-db4b876d1ef70/dataSecurityAndGovernance/protectionScopes/compute
Content-type: application/json
Client-Request-Id: 50dc805c-3af4-42d9-ad16-a746235cc736

{
   "activities": "uploadText,downloadText",
   "locations": [
      {
         "@odata.type": "microsoft.graph.policyLocationApplication",
         "value": "83ef208a-0396-4893-9d4f-d36efbffc8bd"
      }
   ]
}

Отклик

Ниже показан пример отклика. Он указывает, что для uploadText действия для интегрированного приложения с идентификатором 83ef208a-0396-4893-9d4f-d36efbffc8bd политики требуют встроенной оценки. uploadFile Для действия для интегрированного приложения с идентификатором 83ef208a-0396-4893-9d4f-d36efbffc8bd политики требуют автономной оценки и запускают restrictAccess действие (вероятно, блокировка отправки на основе контекстной информации; например, блокировка отправки для определенных пользователей или группы).

Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.

HTTP/1.1 200 OK
Content-type: application/json
Client-Request-Id: 50dc805c-3af4-42d9-ad16-a746235cc736

{
  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(microsoft.graph.policyUserScope)",
  "value": [
    {
      "activities": "uploadText",
      "executionMode": "evaluateInline",
      "locations": [
        {
          "value": "83ef208a-0396-4893-9d4f-d36efbffc8bd"
        }
      ],
      "policyActions": []
    },
    {
      "activities": "uploadFile",
      "executionMode": "evaluateOffline",
      "locations": [
        {
          "value": "83ef208a-0396-4893-9d4f-d36efbffc8bd"
        }
      ],
      "policyActions": [
        {
            "@odata.type": "#microsoft.graph.restrictAccessAction",
            "action": "restrictAccess",
            "restrictionAction": "block"
        }
     ]
    }
  ]
}

Пример 2. Защита вычислительных ресурсов область для приложения поставщика сети

Запрос

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

POST https://graph.microsoft.com/v1.0/security/dataSecurityAndGovernance/protectionScopes/compute
Content-type: application/json

{
    "activities": "uploadText,downloadText, uploadFile,downloadFile"
}

Отклик

Ниже показан пример отклика. Он указывает, что действия uploadText, downloadText, uploadFile или downloadFile для subdomain.domain1.com, domain2.com или "https://subdomain.domain3.com/content/subcontent" требуют автономной оценки. Действия UploadText для "subdomain.domain1.com", "domain2.com" или "https://subdomain.domain3.com/content/subcontent" требуют встроенной оценки.

Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.

HTTP/1.1 200 OK
Content-type: application/json

{
  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(microsoft.graph.policyTenantScope)",
  "value": [
    {
      "activities": "uploadText,uploadFile,downloadText,downloadFile",
      "executionMode": "evaluateOffline",
      "locations": [
        {
          "@odata.type": "#microsoft.graph.policyLocationDomain",
          "value": "subdomain.domain1.com"
        },
        {
          "@odata.type": "#microsoft.graph.policyLocationDomain",
          "value": "domain2.com"
        },
        {
          "@odata.type": "#microsoft.graph.policyLocationUrl",
          "value": "https://subdomain.domain3.com/content/subcontent"
        }
      ],
      "policyActions": []
    },
    {
      "activities": "uploadText",
      "executionMode": "evaluateInline",
      "locations": [
        {
          "@odata.type": "#microsoft.graph.policyLocationDomain",
          "value": "subdomain.domain1.com"
        },
        {
          "@odata.type": "#microsoft.graph.policyLocationDomain",
          "value": "domain2.com"
        },
        {
          "@odata.type": "#microsoft.graph.policyLocationUrl",
          "value": "https://subdomain.domain3.com/content/subcontent"
        }
      ],
      "policyActions": []
    }
  ]
}
  • Последнее обновление: