Saltar para o conteúdo principal
POST
Avaliar Política MAIP

Avaliar Política MAIP

POST /v1/maip/policies/evaluate Avalia todas as políticas MAIP ativas para o inquilino autenticado contra um agente específico e escopo solicitado. Retorna se a ação é permitida, negada ou requer aprovação humana. Este é o ponto de verificação de aplicação em tempo de execução que os agentes chamam antes de realizar operações sensíveis.
A avaliação da política usa um modelo de negação-prevalece: se qualquer política ativa com um correspondente deny aciona a regra, a ação é bloqueada independentemente de qualquer allow regras. O sinalizador requires_approval é aditivo — ele pode ser definido mesmo quando o ação é permitida.

Autenticação

Requer cabeçalho X-API-Key ou token JWT de portador. Com escopo de locatário via cookie ou declaração JWT.

Lógica de Avaliação

A avaliação realiza três verificações sequenciais:
  1. Verificação de Status do Agente — O agente deve ter status: "active". Agentes suspensos ou revogados são sempre negados.
  2. Verificação de Acesso ao Escopo — O escopo solicitado deve estar presente nos escopos concedidos do agente. Escopos explicitamente negados (prefixados com !) sempre bloqueiam o acesso.
  3. Verificação de Regras de Política — Todas as políticas de locatário ativas são avaliadas em ordem de prioridade. As condições de cada regra são combinadas com AND. Se alguma regra deny corresponder, a ação é bloqueada.

Resposta

boolean
true se a ação for permitida, false se negada por qualquer verificação.
string[]
Nomes das políticas que negaram a ação. Array vazio se permitido.
string
Razão legível por humanos para a negação. Uma das seguintes: - "agent is not active" — Agente está suspenso ou revogado - "scope not granted to agent" — Escopo não em escopos concedidos do agente - "denied by policy" — Uma ou mais políticas bloquearam a ação
boolean
true se qualquer regra de política correspondente tiver requires_approval: true, mesmo que o ação é permitida de outra forma. O chamador deve apresentar uma aprovação humana fluxo de trabalho antes de prosseguir.

Exemplo

Autorizações

X-API-Key
string
header
obrigatório

Chave de API para autenticação máquina a máquina

Corpo

application/json
agent_id
string
obrigatório

Identificador de agente compatível com MAIP

scope
string
obrigatório

Escopo de permissão sendo solicitado

action
string

Ação específica sendo realizada

resource
string

Recurso específico sendo acessado

Resposta

Resultado da avaliação

allowed
boolean

Se a ação é permitida

denied_by
string[]

Nomes das políticas que negaram a ação

reason
string

Razão de negação legível por humanos

requires_approval
boolean

Se a aprovação humana é necessária