Saltar al contenido principal
POST
Evaluar la política de MAIP

Evaluar Política MAIP

POST /v1/maip/policies/evaluate Evalúa todas las políticas MAIP activas para el inquilino autenticado contra un agente específico y el alcance solicitado. Devuelve si la acción está permitida, denegada o requiere aprobación humana. Este es el punto de control de aplicación en tiempo de ejecución que los agentes llaman antes de realizar operaciones sensibles.
La evaluación de políticas utiliza un modelo de denegación prevalece: si alguna política activa con un que coincida con las reglas de deny, la acción se bloquea independientemente de cualquier allow reglas. El indicador requires_approval es aditivo, se puede establecer incluso cuando el se permite la acción.

Autenticación

Requiere el encabezado X-API-Key o el token Bearer JWT. Con alcance de inquilino a través de cookie o reclamo JWT.

Lógica de evaluación

La evaluación realiza tres comprobaciones secuenciales:
  1. Verificación de estado del agente: El agente debe tener status: "active". Los agentes suspendidos o revocados siempre son denegados.
  2. Verificación de acceso al alcance: El alcance solicitado debe estar presente en los alcances concedidos del agente. Los alcances denegados explícitamente (con el prefijo !) siempre bloquean el acceso.
  3. Verificación de reglas de política — Todas las políticas de inquilino activas se evalúan en orden de prioridad. Las condiciones de cada regla se unen con AND. Si alguna regla deny coincide, la acción se bloquea.

Respuesta

boolean
true si la acción está permitida, false si es denegada por cualquier verificación.
string[]
Nombres de las políticas que denegaron la acción. Matriz vacía si se permitió.
string
Razón legible por humanos para la denegación. Una de: - "agent is not active" — Agente está suspendido o revocado - "scope not granted to agent" — Ámbito no en ámbitos concedidos del agente - "denied by policy" — Una o más políticas bloquearon la acción
boolean
true si alguna regla de política coincidente tiene requires_approval: true, incluso si la la acción está permitida de otra manera. El llamador debe presentar una aprobación humana flujo de trabajo antes de continuar.

Ejemplo

Autorizaciones

X-API-Key
string
header
requerido

Clave API para autenticación máquina a máquina

Cuerpo

application/json
agent_id
string
requerido

Identificador de agente compatible con MAIP

scope
string
requerido

Ámbito de permiso solicitado

action
string

Acción específica que se está realizando

resource
string

Recurso específico al que se accede

Respuesta

Resultado de la evaluación

allowed
boolean

Si la acción está permitida

denied_by
string[]

Nombres de las políticas que denegaron la acción

reason
string

Razón de denegación legible por humanos

requires_approval
boolean

Si se requiere aprobación humana