Создание accessReview (не рекомендуется)

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

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Предостережение

Эта версия API проверки доступа устарела и перестанет возвращать данные 19 мая 2023 г. Используйте API проверок доступа.

В функции проверки доступа Microsoft Entra создайте объект accessReview.

Перед выполнением этого запроса вызывающий объект должен предварительно получить список шаблонов бизнес-потока, чтобы иметь значение businessFlowTemplateId , которое будет включаться в запрос.

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

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

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

Разрешения

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

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

Вызывающий объект также должен иметь разрешение ProgramControl.ReadWrite.All, чтобы после создания проверки доступа вызывающий объект смог создать programControl. Кроме того, вошедшего в систему пользователя также должна быть роль каталога, которая позволяет ему создавать проверку доступа. Дополнительные сведения см. в разделе Требования к роли и разрешениям для проверок доступа.

HTTP-запрос

POST /accessReviews

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

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

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

В тексте запроса укажите представление объекта accessReview в формате JSON.

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

Свойство Тип Описание
displayName String Имя проверки доступа.
startDateTime DateTimeOffset Дата и время начала проверки. Это должна быть дата в будущем.
endDateTime DateTimeOffset Дата и время окончания проверки. Это должно быть по крайней мере на один день позже даты начала.
description String Описание, отображаемого рецензентам.
businessFlowTemplateId String Идентификатор шаблона бизнес-потока, полученный из объекта businessFlowTemplate.
ReviewerType String Тип связи рецензента с правами доступа проверяемого объекта, одного из self, delegatedили entityOwners.
reviewedEntity identity Объект, для которого создается проверка доступа, например членство в группе или назначения пользователей приложению.

Если reviewerType имеет значение delegated, то вызывающий объект также должен включать свойство reviewers с коллекцией объектов userIdentity , представляющих рецензентов.

Если приложение вызывает этот API без вошедшего пользователя, вызывающий объект также должен включать свойство createdBy , значением для которого является userIdentity пользователя, который будет определен как создатель проверки.

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

Отклик

В случае успешного выполнения этот метод возвращает код отклика 201 Created и объект accessReview в теле отклика.

Пример

Это пример создания однократной (не повторяющейся) проверки доступа с явным указанием двух пользователей в качестве рецензентов.

Запрос

В тексте запроса укажите представление объекта accessReview в формате JSON.

POST https://graph.microsoft.com/beta/accessReviews
Content-type: application/json

{
    "displayName":"TestReview",
    "startDateTime":"2017-02-10T00:35:53.214Z",
    "endDateTime":"2017-03-12T00:35:53.214Z",
    "reviewedEntity": {
        "id": "99025615-a0b1-47ec-9117-35377b10998b"
    },
    "reviewerType" : "delegated",
    "businessFlowTemplateId": "6e4f3d20-c5c3-407f-9695-8460952bcc68",
    "description":"Sample description",
    "reviewers":
    [
        {
            "id":"f260246a-09b1-4fd5-8d18-daed736071ec"
        },
        {
            "id":"5a4e184c-4ee5-4883-96e9-b371f8da88e3"
        }
    ],
    "settings":
    {
        "mailNotificationsEnabled": true,
        "remindersEnabled": true,
        "justificationRequiredOnApproval":true,
        "autoReviewEnabled":false,
        "activityDurationInDays":30,
        "autoApplyReviewResultsEnabled":false,
        "accessRecommendationsEnabled":false,
        "recurrenceSettings":{
            "recurrenceType":"onetime",
            "recurrenceEndType":"endBy",
            "durationInDays":0,
            "recurrenceCount":0
        },
        "autoReviewSettings":{
            "notReviewedResult":"Deny"
        }
    }
}

Отклик

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

HTTP/1.1 201 Created
Content-type: application/json

{
    "id": "006111db-0810-4494-a6df-904d368bd81b",
    "displayName": "TestReview",
    "startDateTime": "2017-02-10T00:35:53.214Z",
    "endDateTime": "2017-03-12T00:35:53.214Z",
    "status": "Initializing",
    "businessFlowTemplateId": "6e4f3d20-c5c3-407f-9695-8460952bcc68",
    "reviewerType": "delegated",
    "description": "Sample description"
}