Intramedial befindet sich in der eingeschränkten Beta. Bei der Registrierung oder Anmeldung müssen Sie das erhaltene Beta-Tester-Passwort angeben oder unter preview@intramedial.com eines anfordern. Vielen Dank.
Wird geladen…
coordination.quarantineModul 32
Plane-Modul
Agent quarantine
Trennen Sie einen Agenten bei der Zulassung ab, aber nur mit der Freigabe einer zweiten Person oder einem Urteil, das genau diesen Agenten nennt.
coordination.quarantine fügt die DID eines Agenten dem Quarantäne-Set hinzu, sodass die Zulassung für ihn quarantine antwortet. Die Route ist destruktiv und standardmäßig geschlossen: Sie braucht eine warrant, entweder eine von einem anderen Administrator freigegebene Dual-Control-Anfrage oder einen adjudizierten Fall auf Stufe 3 oder 4, der den Agenten nennt.
Intralock · Leases · Parley · Fleet Map
A Trustvice Product
Agenten handeln, wenn die Ebene Ja sagt – und das Protokoll sagt, warum.
Leiten Sie Agent-Aktionen, Inhalts-Hashes, API-Checks, DNS-Abfragen, Webhooks, LLM-Aufrufe und Git-Commits über Intramedial – für einen signierten Beleg, den jeder prüft, ohne uns zu vertrauen.
StatusDas Aktionsschema kann keine Freigabe tragen
Die Aktion coordination.quarantine akzeptiert nur did, hat also keinen Platz für eine warrant. Senden Sie die REST-Route mit einem Feld warrant, oder nutzen Sie coordination.halt mit scope: agent, das ein Administrator direkt aufrufen kann.
Protokoll
Das Protokoll
Was erfasst wird
did
Pflicht. Der unter Quarantäne zu stellende Agent. actorDid wird als Alias akzeptiert.
warrant
Über REST Pflicht. Ein Objekt mit kind (dual-control oder adjudicated) und der id der Anfrage oder des Falls.
Für lift. Ein Grund, der in das Ereignis coordination.lift eingeht.
quarantined
In der Antwort von fleetmap: die DIDs, die derzeit im Quarantäne-Set sind.
Mechanismus
Schritt für Schritt
So funktioniert es
Formen und Phasen
A
Dual-Control-Freigabe
warrant: {kind: dual-control, id}, wobei id mit dc_ beginnt. Ein Administrator reicht dual-control/request für den Scope quarantine ein; ein anderer Administrator gibt ihn frei.
B
Adjudizierte Freigabe
warrant: {kind: adjudicated, id}, wobei id ein Fall ist. Der Fall braucht ein bestehendes Urteil auf Stufe 3 oder 4, eine Quarantäne-Abhilfe und diese DID unter den genannten Subjekten.
Schritt für Schritt
Eine Freigabe besorgen
Reichen Sie eine Dual-Control-Anfrage für den Scope quarantine mit diesem Body ein, oder lassen Sie einen Schiedsfall zu einem Urteil kommen, das die Quarantäne für diesen Agenten anordnet.
Die Route senden
quarantine nimmt did und die warrant. Ohne eine lehnt der Dispatcher mit 403 ab, bevor das Modul läuft.
Die Zulassung lehnt ab
Die DID tritt dem Quarantäne-Set bei und wird mit der Policy des Workspace gespeichert. Die nächste Zulassung für diesen Agenten antwortet quarantine.
Ausprobieren
Live-Demo
Direkt auf dieser Seite ausführen
GET/api/v1/acp/coordination/fleetmap
// Kein Body: Das ist ein GET. Klicken Sie auf Ausführen.
Läuft in einem gemeinsamen Demo-Workspace mit einem Demo-Schlüssel: Jeder kann sehen, was darin liegt, senden Sie also nichts Privates. Doku zu coordination.quarantine
Antworten
Klicken Sie auf Ausführen, um die Anfrage links an den gemeinsamen Demo-Workspace zu senden.
Läuft in einem gemeinsamen Demo-Workspace mit einem Demo-Schlüssel: Jeder kann sehen, was darin liegt, senden Sie also nichts Privates.
Code
Live-Beispiel
Eine echte Anfrage
Eine Anfrage in der Form, die die API akzeptiert, und eine Beispielantwort in der Form, die das Modul liefert.
Ein Schiedsfall entscheidet Quarantäne für einen Agenten. Der Fall ist die Freigabe, und niemand muss die Entscheidung mit einem zweiten Administrator wiederholen.
Zwei Administratoren stimmen zu
Einer reicht die Anfrage ein, der andere gibt sie mit MFA frei. Die Quarantäne-Route akzeptiert die freigegebene ID als ihre Freigabe.
Prüfen, wer gestoppt ist
fleetmap liefert die DIDs unter Quarantäne zusammen mit Agenten, Leases und Presence, sodass eine Konsole zeigen kann, was die Zulassung ablehnen wird.
Einen Agenten freigeben
lift entfernt die DID. Administrator und Grund werden im Ledger erfasst, was ein bloßer Quarantäne-Aufruf nicht tut.
Wann etwas anderes passt
Einen Agenten als Administrator sofort stoppen. Nutzen Sie coordination.halt, das einen Grund braucht und sich selbst im Ledger erfasst, aber keine zweite Person.
Einen einzelnen Grant widerrufen. Das ist die Route revoke, die dieselbe Art Freigabe trägt.
Entscheiden, dass ein Agent unter Quarantäne gehört. arbitration.arbiter urteilt über Fälle; diese Route wendet das Ergebnis an.
Nachweis
Garantien
Was es leistet und was nicht
Ein Modul ist eine starke Aussage über etwas Enges. Verlassen Sie sich genau darauf.
Es leistet
Ein Aufruf ohne gültige Freigabe wird vom Dispatcher abgelehnt, weil das Gate standardmäßig geschlossen ist.
Eine adjudizierte Freigabe wird gegen den echten Fall geprüft: Stufe 3 oder 4, ein bestehendes Urteil, eine passende Abhilfe und ein passendes Subjekt.
Ein Urteil gegen einen Agenten ist keine Freigabe gegen einen anderen; der Fall muss diese DID nennen.
Ein Agent unter Quarantäne wird bei der Zulassung ohne Modellaufruf mit dem Grund quarantine abgelehnt.
Es leistet nicht
Dass die Quarantäne erfasst, wer sie setzte oder warum. Die Route speichert nur die DID und schreibt kein eigenes Ereignis; die Anfrage oder der Fall ist die Aufzeichnung.
Dass der Agent überall abgelehnt wird. Wie jede Ablehnung gilt sie dort, wo die Ressourcenklasse auf enforce steht; geschützte Klassen immer.
Dass der Agent aufgehört hat zu laufen. Die Quarantäne lehnt Zulassungen ab; der Prozess kann außerhalb der Plane weiter handeln.
Details
Bauhinweise
Bevor Sie bauen
Warum das Gate standardmäßig geschlossen ist
Ein Gate, das nicht auf dem Pfad liegt, schützt nichts, daher sitzt es im Dispatcher. Eine destruktive Route ohne Freigabe wird abgelehnt, nicht durchgewunken.
Urteile sind von zwei Personen ausgenommen
Ein Urteil auf Stufe 3 hat bereits eine Fallakte, eine Ledger-Spur und eine Berufung, sodass es nicht zwei Administratoren braucht, um seine eigene Abhilfe anzuwenden.
Was ein Urteil sein muss
Eine Verweisung an einen Menschen, ein Fallback-Urteil und ein wiedereröffneter Fall sind keine Freigaben. Ein Modellurteil gilt nur, wo ein Detektor oder ein Administrator das Subjekt nannte.
Berechtigungen
lift ist für einen angemeldeten Administrator. fleetmap ist ein Lesevorgang und trägt keine Rolle.
Limits und Bemessung
quarantine ohne did liefert 400, und ohne Freigabe liefert es 403.
Die Freigabe muss für den Scope quarantine und für dieses Subjekt gelten, sonst wird der Aufruf abgelehnt.
Die Aktionen coordination.quarantine und coordination.lift nehmen nur did, sodass eine warrant oder ein why nicht mitreisen kann.
Quarantäne ist ein Set von DIDs; sie hat kein Ablaufdatum und gilt bis lift oder unhalt.
Zugriff
API & MCP
REST und MCP
Authentifizieren Sie sich mit einem Workspace-API-Schlüssel als Bearer-Token. Die Basis-URL ist https://api.intramedial.com.
REST-Endpunkte
POST/api/v1/acp/coordination/quarantineEinen Agenten unter einer Freigabe unter Quarantäne stellen.
POST/api/v1/acp/coordination/liftEine Quarantäne aufheben und im Ledger erfassen, wer sie aufhob.
GET/api/v1/acp/coordination/fleetmapAgenten, Leases, Presence und das Quarantäne-Set lesen.
MCP-Aktionen
MCPcoordination.quarantineAus einem Aktionsaufruf unter Quarantäne stellen; die Aktion kann keine Freigabe tragen.
MCPcoordination.liftEine Quarantäne aus einem Aktionsaufruf aufheben.
MCPcoordination.fleetmap.getDie Fleet Map von einem Agenten aus lesen.
lift nimmt did und ein optionales why. Es ist für Administratoren und erfasst coordination.lift im Ledger mit dem, der aufhob, und warum.
iam.assume31
Cloud credential broker
Geben Sie einem Agenten ein kurzlebiges Cloud-Credential nur, solange er eine aktive Lease auf die Rolle hält, und lassen Sie das Credential mit der Lease sterben.
Plane-Modul
