Compartir a través de


Creación de accessReview (en desuso)

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Precaución

Esta versión de la API de revisión de acceso está en desuso y dejará de devolver datos el 19 de mayo de 2023. Use la API de revisiones de acceso.

En la característica Microsoft Entra revisiones de acceso, cree un nuevo objeto accessReview.

Antes de realizar esta solicitud, el autor de la llamada debe haber recuperado previamente la lista de plantillas de flujo de negocio para tener el valor de businessFlowTemplateId que se va a incluir en la solicitud.

Después de realizar esta solicitud, el autor de la llamada debe crear un control programControl para vincular la revisión de acceso a un programa.

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global Gobierno de EE. UU. L4 Us Government L5 (DOD) China operada por 21Vianet

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) AccessReview.ReadWrite.Membership AccessReview.ReadWrite.All
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación AccessReview.ReadWrite.Membership No disponible.

El autor de la llamada también debe tener el permiso ProgramControl.ReadWrite.All para que, después de crear una revisión de acceso, el autor de la llamada pueda crear un control programControl. Además, el usuario que ha iniciado sesión también debe estar en un rol de directorio que le permita crear una revisión de acceso. Para obtener más información, consulte los requisitos de permisos y roles para las revisiones de acceso.

Solicitud HTTP

POST /accessReviews

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.
Tipo de contenido application/json. Obligatorio.

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione una representación JSON de un objeto accessReview .

En la tabla siguiente se muestran las propiedades necesarias al crear un accessReview.

Propiedad Tipo Descripción
displayName Cadena Nombre de la revisión de acceso.
startDateTime DateTimeOffset Fecha y hora en que la revisión está programada para iniciarse. Debe ser una fecha en el futuro.
endDateTime DateTimeOffset Fecha y hora en que la revisión está programada para finalizar. Debe ser al menos un día después de la fecha de inicio.
description Cadena La descripción, para mostrarla a los revisores.
businessFlowTemplateId Cadena Identificador de plantilla de flujo de negocio, obtenido de una clase businessFlowTemplate.
reviewerType Cadena Tipo de relación de revisor con los derechos de acceso del objeto revisado, uno de self, delegatedo entityOwners.
reviewedEntity identity Objeto para el que se crea una revisión de acceso, como la pertenencia de un grupo o las asignaciones de usuarios a una aplicación.

Si reviewerType tiene el valor delegated, el autor de la llamada también debe incluir la propiedad reviewers , con una colección de objetos userIdentity que representan a los revisores.

Si la aplicación llama a esta API sin un usuario que ha iniciado sesión, el autor de la llamada también debe incluir la propiedad createdBy , cuyo valor es userIdentity del usuario que se identificará como el creador de la revisión.

Además, el autor de la llamada puede incluir la configuración, crear una serie de revisiones periódicas o cambiar del comportamiento de revisión predeterminado. En concreto, para crear una revisión periódica, el autor de la llamada debe incluir accessReviewRecurrenceSettings en la configuración de revisión de acceso,

Respuesta

Si se ejecuta correctamente, este método devuelve un 201 Created código de respuesta y un objeto accessReview en el cuerpo de la respuesta.

Ejemplo

Este es un ejemplo de creación de una revisión de acceso única (no periódica), especificando explícitamente dos usuarios como revisores.

Solicitud

En el cuerpo de la solicitud, proporcione una representación JSON del objeto accessReview .

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"
        }
    }
}

Respuesta

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

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"
}