resourcePolicyRoot: evaluateAssignedPolicies

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.

Evalúe las directivas asignadas aplicables para una solicitud de API proporcionada mediante resourcePolicyRoot.

Esta acción no realiza la solicitud de API simulada. El efecto notificado y si la solicitud se bloquearía se devuelven por separado. Los errores de carga o evaluación de directivas pueden aparecer en la propiedad errorDetails de las entradas de la colección de detalles incluso cuando isResultDetailed es false.

Disponibilidad de API

Esta API está disponible en las siguientes implementaciones en la nube nacional.

Servicio global Administración pública de EE. UU. Gobierno de EE. UU. L5 (DOD) China operado por 21Vianet
✅ ❌ ❌ ❌

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use uno o varios permisos con privilegios más altos 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) ResourcePolicyEvaluation.Read.All No disponible.
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación ResourcePolicyEvaluation.Read.All No disponible.

Importante

Para el acceso delegado con cuentas profesionales o educativas, el usuario que ha iniciado sesión debe tener asignado un rol compatible de Microsoft Entra o un rol personalizado que conceda los permisos necesarios para esta operación. El Evaluador de directivas de recursos es el rol con privilegios mínimos admitido para esta operación.

Solicitud HTTP

POST /admin/resourcePolicy/evaluateAssignedPolicies

Encabezados de solicitud

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

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione los parámetros siguientes.

Parámetro Tipo Description
resourceUri Cadena Obligatorio. El URI de la solicitud o recurso a evaluar, como /beta/applications.
httpMethod requestHttpMethod Obligatorio. El método HTTP de la solicitud simulada. Los valores posibles son: post, patch, put, get, delete, unknownFutureValue.
resourceBody Json Obligatorio. El cuerpo JSON de la solicitud simulada. Este parámetro que acepta valores NULL se puede establecer en null.
ámbito String Opcional. El alcance de la evaluación. El valor predeterminado es / (el inquilino).
isResultDetailed Booleano Opcional. Si se deben solicitar resultados detallados de la directiva correctos. El valor predeterminado es false. Independientemente de este valor se pueden devolver detalles que contengan errores.
includeNormalizedRequestInput Booleano Opcional. Si se debe incluir el documento de entrada del motor de directivas en la respuesta. El valor predeterminado es false.

Respuesta

Si se realiza correctamente, esta acción devuelve 200 OK un objeto policiesEvaluationResult en el cuerpo de la respuesta.

Ejemplos

En estos ejemplos se supone que el inquilino tiene habilitadas las siguientes asignaciones en el ámbito /. Ambas directivas se aplican a las operaciones de creación y actualización de aplicaciones.

Nombre único de la asignación Nombre único de definición Requisito de directiva Modo de cumplimiento
tenant_application_baseline require_application_name La aplicación tiene un displayName no vacío. doNotEnforce
tenant_application_audience require_single_tenant_application El signInAudience de la aplicación es AzureADMyOrg. enforce

Ejemplo 1: Evaluar varias directivas asignadas

La solicitud simulada proporciona un nombre para mostrar y un público con inicio de sesión multiinquilino. La política de nombres informa complianty los informes denyde política de audiencia. Dado que se aplica la directiva de audiencia, el resultado agregado tiene appliedPoliciesEffects establecido y denyisBlocked establecido en true.

Solicitud

POST https://graph.microsoft.com/beta/admin/resourcePolicy/evaluateAssignedPolicies
Content-Type: application/json

{
  "resourceUri": "/beta/applications",
  "httpMethod": "post",
  "resourceBody": {
    "displayName": "Contoso application",
    "signInAudience": "AzureADMultipleOrgs"
  },
  "scope": "/",
  "isResultDetailed": true
}

Respuesta

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

{
  "@odata.type": "#microsoft.graph.policiesEvaluationResult",
  "resourceUri": "/beta/applications",
  "httpMethod": "post",
  "appliedPoliciesEffects": "deny",
  "isBlocked": true,
  "message": "Resource is non-compliant with policies: require_single_tenant_application.",
  "normalizedRequestInput": null,
  "details": [
    {
      "@odata.type": "#microsoft.graph.policiesEvaluationDetail",
      "assignmentUniqueName": "tenant_application_baseline",
      "assignedPolicyDisplayName": "Require an application name",
      "appliedPolicyEffects": "compliant",
      "enforcementMode": "doNotEnforce",
      "reasons": null,
      "errorDetails": null
    },
    {
      "@odata.type": "#microsoft.graph.policiesEvaluationDetail",
      "assignmentUniqueName": "tenant_application_audience",
      "assignedPolicyDisplayName": "Require a single-tenant application",
      "appliedPolicyEffects": "deny",
      "enforcementMode": "enforce",
      "reasons": [
        "Applications must use the AzureADMyOrg sign-in audience."
      ],
      "errorDetails": null
    }
  ]
}

Ejemplo 2: Inspección de la entrada de solicitud normalizada

Establezca includeNormalizedRequestInput para true inspeccionar la entrada suministrada al motor de directivas. En este ejemplo se evalúa una actualización de la aplicación que cumple ambas directivas asignadas. La entrada normalizada contiene la versión de API, el contexto de autenticación del autor de la llamada, los segmentos de URI y las claves de recursos, y el cuerpo del recurso suministrado. Los valores del contexto de autenticación reflejan el autor de la llamada de la API de evaluación.

Solicitud

POST https://graph.microsoft.com/beta/admin/resourcePolicy/evaluateAssignedPolicies
Content-Type: application/json

{
  "resourceUri": "/beta/applications/8b1c4b61-8369-42e5-8f6c-624d27dfba20",
  "httpMethod": "patch",
  "resourceBody": {
    "displayName": "Contoso application",
    "signInAudience": "AzureADMyOrg"
  },
  "scope": "/",
  "isResultDetailed": true,
  "includeNormalizedRequestInput": true
}

Respuesta

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

{
  "@odata.type": "#microsoft.graph.policiesEvaluationResult",
  "resourceUri": "/beta/applications/8b1c4b61-8369-42e5-8f6c-624d27dfba20",
  "httpMethod": "patch",
  "appliedPoliciesEffects": "compliant",
  "isBlocked": false,
  "message": "Resource is compliant with assigned policies.",
  "normalizedRequestInput": {
    "request": {
      "apiVersion": "beta",
      "authContext": {
        "isAppOnly": true,
        "appid": "bdf7919e-a1bd-46d6-b99d-446cc0116353",
        "tid": "f41b6369-cba8-48c9-bf58-1e066b0a46f0",
        "oid": "0d52b272-6161-49d5-a0e8-31082a0e7d19"
      },
      "uriSegments": [
        {
          "name": "applications",
          "type": "microsoft.graph.application",
          "keys": {
            "id": "8b1c4b61-8369-42e5-8f6c-624d27dfba20"
          }
        }
      ],
      "resourceKeys": {
        "id": "8b1c4b61-8369-42e5-8f6c-624d27dfba20"
      }
    },
    "resource": {
      "displayName": "Contoso application",
      "signInAudience": "AzureADMyOrg"
    }
  },
  "details": [
    {
      "@odata.type": "#microsoft.graph.policiesEvaluationDetail",
      "assignmentUniqueName": "tenant_application_baseline",
      "assignedPolicyDisplayName": "Require an application name",
      "appliedPolicyEffects": "compliant",
      "enforcementMode": "doNotEnforce",
      "reasons": null,
      "errorDetails": null
    },
    {
      "@odata.type": "#microsoft.graph.policiesEvaluationDetail",
      "assignmentUniqueName": "tenant_application_audience",
      "assignedPolicyDisplayName": "Require a single-tenant application",
      "appliedPolicyEffects": "compliant",
      "enforcementMode": "enforce",
      "reasons": null,
      "errorDetails": null
    }
  ]
}