Saltar al contenido principal
POST
Recalcular puntuación de confianza
Activa un recálculo bajo demanda de la puntuación de confianza para un agente específico. La puntuación se deriva de múltiples factores ponderados, incluyendo la tasa de anomalías, el historial de tiempo de actividad, la profundidad de la delegación y el volumen de recibos. Utilice este endpoint después de un evento significativo (rotación de claves, violación de políticas, ráfaga de atestaciones) para asegurarse de que la puntuación refleje la postura actual del agente. Las puntuaciones de confianza van de 0.0 (sin confianza) a 1.0 (confianza total) y son utilizadas por los motores de políticas, la selección de testigos y las puertas de delegación en toda la plataforma.

Autenticación

Requiere el encabezado X-API-Key o el token Bearer JWT. El espacio de trabajo se deriva de la credencial autenticada; no envíe X-Tenant-ID.

Respuesta

string
El identificador del agente que fue puntuado.
number
La puntuación de confianza calculada como un número flotante entre 0.0 y 1.0.
object
Desglose de los factores individuales que contribuyeron a la puntuación.
string
Marca de tiempo ISO 8601 de cuándo se completó el cálculo.

Pesos del factor de puntuación

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 MAIP (por ejemplo, maip:a0000000:01abc...)

Respuesta

Puntuación de confianza recalculada

score
number<float>
Rango requerido: 0 <= x <= 1
factors
object
deltas
object
computed_at
string<date-time>