Saltar al contenido principal
GET
Listar políticas MAIP

Listar Políticas MAIP

GET /v1/maip/policies Devuelve todas las políticas de agentes MAIP configuradas para el inquilino autenticado. Las políticas definen reglas de aplicación en tiempo de ejecución que rigen lo que los agentes pueden hacer en función de las puntuaciones de confianza, los alcances, la profundidad de la delegación y el tipo de agente.

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.

Respuesta

Devuelve una matriz de objetos de política.
string
Clave primaria UUID de la política.
string
UUID del inquilino propietario.
string
Nombre de política legible por humanos. Usado en mensajes de denegación y registros de auditoría.
string
Descripción detallada de lo que aplica la política.
string
Categoría de política. Una de: "scope", "trust", "rate", "custom".
string
Estado del ciclo de vida de la política. Uno de: "active", "disabled", "archived". Solo Las políticas active se evalúan durante las comprobaciones de políticas.
integer
Prioridad de evaluación. Los números más bajos se evalúan primero. Predeterminado: 100.
object
Array JSON de reglas de política. Cada regla contiene condiciones, un efecto ("allow", "deny", "require_approval"), y un bandera requires_approval. Consulte Crear política para ver el esquema de reglas.
string
Marca de tiempo de creación ISO 8601.
string
Marca de tiempo de última actualización ISO 8601.

Ejemplo

Autorizaciones

X-API-Key
string
header
requerido

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

Respuesta

Matriz de políticas

id
string<uuid>

Clave primaria UUID

tenant_id
string<uuid>

UUID del inquilino propietario

name
string

Nombre de la política legible por humanos

description
string

Descripción detallada de la política

category
enum<string>

Categoría de política

Opciones disponibles:
scope,
trust,
rate,
custom
status
enum<string>

Estado del ciclo de vida de la política

Opciones disponibles:
active,
disabled,
archived
priority
integer

Prioridad de evaluación (menor = primero)

rules
object[]

Matriz de reglas de política

created_at
string<date-time>
updated_at
string<date-time>