Intramedial está en beta restringida. Al registrarte o iniciar sesión, debes indicar la contraseña de beta tester que recibiste o solicitar una en preview@intramedial.com. Gracias.
Cargando…
coordination.quarantineMódulo 32
Módulo de la plataforma
Agent quarantine
Aísla a un agente en la admisión, pero solo con la aprobación de una segunda persona o un dictamen que nombre a ese agente exacto.
coordination.quarantine añade el DID de un agente al conjunto de cuarentena, de modo que la admisión responde quarantine para él. La ruta es destructiva y cerrada por defecto: necesita una warrant, ya sea una petición de control dual aprobada por otro administrador o un caso adjudicado en el peldaño 3 o 4 que nombre al agente.
Intralock · Leases · Parley · Fleet Map
Un producto Trustvice
Los agentes actúan cuando el plano dice sí, y el registro dice por qué.
Pasa por Intramedial acciones de agentes, hashes de contenido, pruebas de API, DNS, webhooks, llamadas LLM y commits. Obtén un recibo firmado que cualquiera verifica, sin fiarse de nadie.
EstadoEl esquema de acción no puede llevar una autorización
La acción coordination.quarantine acepta solo did, así que no tiene sitio para una warrant. Envía la ruta REST con un campo warrant, o usa coordination.halt con scope: agent, que un administrador puede llamar directamente.
Registro
El registro
Qué se registra
did
Obligatorio. El agente a poner en cuarentena. actorDid se acepta como alias.
warrant
Obligatorio por REST. Un objeto con kind (dual-control o adjudicated) y el id de la petición o el caso.
Para lift. Un motivo que va al evento coordination.lift.
quarantined
En la respuesta de fleetmap: los DID que están ahora en el conjunto de cuarentena.
Mecanismo
Paso a paso
Cómo funciona
Formas y fases
A
Autorización de control dual
warrant: {kind: dual-control, id} donde id empieza por dc_. Un administrador presenta dual-control/request para el scope quarantine; otro administrador distinto lo aprueba.
B
Autorización adjudicada
warrant: {kind: adjudicated, id} donde id es un caso. El caso necesita un dictamen vigente en el peldaño 3 o 4, un remedio de cuarentena y este DID entre los sujetos que nombra.
Paso a paso
Conseguir una autorización
Presenta una petición de control dual para el scope quarantine con este cuerpo, o haz que un caso de arbitraje llegue a un dictamen que ordene la cuarentena de este agente.
Enviar la ruta
quarantine toma did y la warrant. Sin una, el despachador rechaza con 403 antes de que se ejecute el módulo.
La admisión rechaza
El DID entra en el conjunto de cuarentena y se guarda con la política del workspace. La siguiente admisión de ese agente responde quarantine.
Pruébalo
Demo en vivo
Ejecútalo desde esta página
GET/api/v1/acp/coordination/fleetmap
// Sin cuerpo: esto es un GET. Pulsa Ejecutar.
Se ejecuta en un workspace de demostración compartido con una clave de demostración: cualquiera puede ver lo que contiene, así que no envíes nada privado. Docs de coordination.quarantine
Respuestas
Pulsa Ejecutar para enviar la solicitud de la izquierda al workspace de demostración compartido.
Se ejecuta en un workspace de demostración compartido con una clave de demostración: cualquiera puede ver lo que contiene, así que no envíes nada privado.
Código
Ejemplo en vivo
Una petición real
Una petición con la forma que acepta la API y una respuesta de ejemplo con la forma que devuelve el módulo.
Un caso de arbitraje dictamina la cuarentena de un agente. El caso es la autorización, y nadie tiene que repetir la decisión con un segundo administrador.
Dos administradores de acuerdo
Uno presenta la petición, el otro la aprueba con MFA. La ruta de cuarentena acepta el id aprobado como su autorización.
Comprobar quién está detenido
fleetmap devuelve los DID en cuarentena junto con agentes, leases y presencia, para que una consola muestre lo que rechazará la admisión.
Liberar a un agente
lift quita el DID. Su administrador y su motivo se registran en el ledger, algo que una llamada de cuarentena a secas no hace.
Cuándo usar otra cosa
Detener a un agente al instante como administrador. Usa coordination.halt, que necesita un motivo y se registra solo, pero no una segunda persona.
Revocar un solo grant. Eso es la ruta revoke, que lleva el mismo tipo de autorización.
Decidir que un agente debe ponerse en cuarentena. arbitration.arbiter dictamina sobre casos; esta ruta aplica el resultado.
Evidencia
Garantías
Qué hace y qué no hace
Un módulo es una afirmación fuerte sobre algo acotado. Confía en él exactamente para lo que es.
Hace
Una llamada sin autorización válida la rechaza el despachador, porque la puerta está cerrada por defecto.
Una autorización adjudicada se comprueba frente al caso real: peldaño 3 o 4, un dictamen vigente, un remedio coincidente y un sujeto coincidente.
Un dictamen contra un agente no es una autorización contra otro; el caso debe nombrar este DID.
Un agente en cuarentena se rechaza en la admisión con el motivo quarantine, sin llamada a un modelo.
No hace
Que la cuarentena registre quién la fijó o por qué. La ruta guarda solo el DID y no escribe ningún evento propio; la petición o el caso es el registro.
Que el agente se rechace en todas partes. Como toda denegación, se aplica donde la clase de recurso está en enforce; las clases protegidas siempre lo están.
Que el agente haya dejado de ejecutarse. La cuarentena rechaza admisiones; el proceso aún puede actuar fuera del plano.
Detalles
Notas de construcción
Antes de construir
Por qué la puerta está cerrada por defecto
Una puerta que no está en el camino no protege nada, así que está en el despachador. Una ruta destructiva sin autorización se rechaza, no se deja pasar.
Los dictámenes están exentos de dos personas
Un dictamen del peldaño 3 ya tiene expediente, rastro en el ledger y apelación, así que no necesita a dos administradores para aplicar su propio remedio.
Qué debe ser un dictamen
Una derivación a una persona, un dictamen de reserva y un caso reabierto no son autorizaciones. Un dictamen de modelo vale solo cuando un detector o un administrador nombró al sujeto.
Permisos
lift es para un administrador con sesión iniciada. fleetmap es una lectura y no lleva rol.
Límites y medición
quarantine sin did devuelve 400, y sin autorización devuelve 403.
La autorización debe ser del scope quarantine y de este sujeto, o la llamada se rechaza.
Las acciones coordination.quarantine y coordination.lift toman solo did, así que no pueden llevar una warrant ni un why.
La cuarentena es un conjunto de DID; no tiene caducidad, así que dura hasta lift o unhalt.
Acceso
API y MCP
REST y MCP
Autentícate con una clave de API del workspace como token Bearer. La URL base es https://api.intramedial.com.
Endpoints REST
POST/api/v1/acp/coordination/quarantinePone a un agente en cuarentena bajo una autorización.
POST/api/v1/acp/coordination/liftLevanta una cuarentena y registra en el ledger quién la levantó.
GET/api/v1/acp/coordination/fleetmapLee agentes, leases, presencia y el conjunto de cuarentena.
Acciones MCP
MCPcoordination.quarantinePone en cuarentena desde una llamada de acción; la acción no puede llevar una autorización.
MCPcoordination.liftLevanta una cuarentena desde una llamada de acción.
MCPcoordination.fleetmap.getLee el Fleet Map desde un agente.
Módulo de la plataforma
