Der Agent arbeitet. Die Kontrolle über die endgültige Wirkung bleibt bei Ihnen.
Einen MCP-Server abzusichern reicht nicht: Ein Agent erreicht auch die Shell, Dateien, APIs und Automatisierungen, die sein Harness ihm zugänglich macht. Dieser Leitfaden bündelt den gesamten Weg für Entwickler und Institutionen: die vorhandene Konfiguration diagnostizieren, die Grenze testen, nur den exakten Kandidaten autorisieren, den Lauf steuern und mit Nachweisen rekonstruieren, was tatsächlich geschehen ist.
Verfügbar · Break the Mandate
Für wen es gedacht ist
Entwickler und Maintainer
Teams, die bereits Aufgaben an Coding-Agenten delegieren und diese länger arbeiten lassen möchten, ohne jeden Befehl freizugeben. Doctor auf den eigenen Dateien, ein lokales Lab ohne Konto und ein Beleg, der dem PR beigefügt wird.
Plattform- und Sicherheitsteams
Die Personen, die entscheiden, was ein Agent einhängen, erreichen und exportieren darf. Eine portable, in Git versionierte Konfiguration, dieselbe Validierung in CLI und Dashboard sowie Hold- und Stop-Steuerungen, die von der Laufzeitumgebung bestätigt werden.
Institutionen und Organisationen
Alle, die dafür einstehen, was autonome Software gegenüber Kunden, Prüfern oder Aufsichtsbehörden bewirkt. Die Autorität bleibt außerhalb des Agenten, jede Wirkung hinterlässt Nachweise, die sich offline verifizieren lassen, und die Grenzen dieser Nachweise sind dokumentiert.
Drei Angriffsflächen, ein Prinzip
Agenten dürfen Vorschläge machen. Die Autorität bleibt außerhalb des Agenten. Die Abdeckung beschränkt sich auf die deklarierten und getesteten Routen: SecureStamp kontrolliert keine Operationen, die diese Grenze umgehen, und benennt sie, statt sie zu verbergen.
MCP-Server
Ein über eine Shell gestarteter Server, ein in die Datei geschriebenes Secret oder ein nicht gepinntes Paket machen ein Tool zu einer Autoritätsroute, die niemand geprüft hat.
Doctor liest die gewählte Datei und schlägt eine korrigierte Kopie vor; MCP Guard vermittelt den Aufruf und Action Proof bindet die Autorisierung an die exakte Wirkung.
Action ProofAgenten
Der Agent kann dasselbe über MCP, die Shell, ein Skript oder einen direkten API-Aufruf versuchen. Seine Logs und Zusammenfassungen beschreiben, was er zu tun behauptet, nicht was geschehen ist.
Der Execution Guardian des Kunden lässt jede vermittelte Wirkung zu oder hält sie an; ein Beobachter außerhalb des Agenten erfasst das Ergebnis, und ein Task Contract begrenzt Schritte, Ressourcen, Budget und Gültigkeit.
Task ContractHarnesses
Mounts, Sockets, Credential-Helper, Proxys und das effektive Netzwerk bestimmen, welche Autorität der Agent tatsächlich hat, auch wenn die deklarierte Konfiguration etwas anderes sagt.
Das Lab testet das Harness-Profil Route für Route, im Vergleich zu einer permissiven Baseline, und markiert jede Route ohne Probe als not evaluated.
Agent- und Harness-LabBreak the Mandate — die Schritt-für-Schritt-Anleitung
Die Einstiegsfrage ist einfach: Kann Ihr Agent etwas außerhalb der genehmigten Aufgabe tun? Das Referenzszenario beantwortet sie in fünf Schritten, auf synthetischen Fixtures, ohne Konto und ohne API-Schlüssel eines Modells.
- 01
Eine nützliche Aufgabe
Der Agent bereitet eine echte Änderung innerhalb einer abgeschotteten Fixture vor.
- 02
Die Lücke in der Baseline
Derselbe Versuch außerhalb des Auftrags entfaltet in einer bewusst permissiven Baseline seine Wirkung, beobachtet aus einem anderen Prozess. Es ist eine bekannte experimentelle Kontrolle, keine auf Ihrem Rechner entdeckte Schwachstelle.
- 03
Die Lücke, eingedämmt
Bei aktiver Kontrolle wird diese Route eingedämmt, und die nützliche Aufgabe wird trotzdem abgeschlossen. Eine Ablehnung, die die Aufgabe nutzlos macht, zählt nicht als Wert.
- 04
Nachweise verfallen, wenn sich die Umgebung ändert
Eine wesentliche Abhängigkeit des Profils ändert sich: Die früheren Nachweise berechtigen diese Route nicht mehr, bis sie erneut validiert wurde.
- 05
Nur der exakte Kandidat verlässt das System
Der eingefrorene Kandidat wird geprüft. Wer seine Bytes oder sein Ziel ändert, macht den Export ungültig; wird das Genehmigte wiederhergestellt, ist die Wirkung zulässig.
Schnellstart
Doctor benötigt weder Docker noch ein Modell und führt nichts aus, was es liest. Das Referenzszenario ist synthetisch: Es führt nie Projektcode aus, und sein Bericht ist als simulierter Nachweis gekennzeichnet.
# Node 22.22.3 oder neuer npm install --save-dev @securestamp/mcp-guard @securestamp/execution-governance # 1. Doctor: statische Diagnose der Dateien, die Sie auswählen npx securestamp-mcp-doctor scan .mcp.json --propose npx securestamp-mcp-doctor scan-native <settings.json|config.toml> --format=<shape> npx securestamp-mcp-doctor scan-workflow .github/workflows/agent.yml # 2. Portables Szenario: die Referenz validieren und ausführen, mit einem Hold npx securestamp-execution-governance validate scenario.json npx securestamp-execution-governance run scenario.json --hold-before=step-1
Jeder Befehl gibt bei ungültigen Argumenten seine Verwendung und die unterstützten Formate aus. Für ein vollständiges HarnessProfileV1 verwenden Sie securestamp-mcp-doctor scan-harness. Mit --hold-before zeigt der Lauf eine angehaltene Wirkung, die nie zugelassen wird. Standardmäßig keine Telemetrie.
Doctor: zuerst Ihre nativen Dateien
Doctor liefert deklarierte Fakten, jeweils mit Quelldatei und Feld, sowie eine Teildiagnose, die angibt, welche Ebenen gelesen wurden und welche unbekannt bleiben. Kompatibilität wird als Form + Transport + getesteter Client beschrieben; ein nicht erkanntes Format wird als nicht unterstützt gemeldet und nie stillschweigend übersprungen.
.mcp.json · JSON mit mcpServers (stdio)Deklarierte Befehle, Credential-Referenzen, in die Datei geschriebene Secrets, Shell-Starts sowie veränderliche oder @latest-Pakete. Eine gepinnte Version begründet keine Integrität: Den effektiven Artefakt mit dem genehmigten zu vergleichen, ist Aufgabe des Ausführenden.
settings.json · config.toml ([mcp_servers])Berechtigungen, Tools und erkannte Konfigurationsebenen, mit Konflikten und fehlenden Daten. Eine einzelne Datei verrät keine verwalteten Richtlinien, CLI-Overrides oder geerbte Konfiguration: Die Ausgabe weist darauf hin.
.github/workflows/*.ymlAgent Workflow Doctor: nicht vertrauenswürdige Eingaben aus Issues, PRs oder Kommentaren, die den Agenten erreichen, deklarierte Berechtigungen, Secret-Referenzen, weit gefasste Tools und der Checkout externer Inhalte. Es lädt keine Actions herunter, löst keine Secrets auf und führt kein YAML aus.
HarnessProfileV1Das vollständige Profil für fortgeschrittene Nutzer. Doctor erfindet es nie aus einer einzelnen Datei: Mounts, Beobachter, effektive Credentials und Backend werden vom Betreiber gewählt und validiert.
- Liest nur die Dateien, auf die es verwiesen wird; es durchsucht nicht das Home-Verzeichnis.
- Führt keine Befehle, Hooks oder Ausdrücke aus der Datei aus.
- Löst keine Secrets auf und validiert keine Tokens.
- Schlägt einen prüfbaren Patch auf einer Kopie vor; überschreibt nie das Original.
- Zeigt ein unauffälliges Ergebnis mit demselben Gewicht wie einen Befund.
- Eine statische Diagnose begründet weder Isolation noch Schutz.
Exact Export: der Agent bereitet vor, Sie autorisieren die exakte Änderung
Der Agent bereitet die Änderung in einer abgeschotteten Kopie Ihres Projekts vor. Das Export-Credential bleibt außerhalb seiner Umgebung, und nur der geprüfte Kandidat verlässt das System, über den Execution Guardian.
- 01
Vorbereiten
In Quarantäne, auf einem Snapshot des gewählten Projekts; Ihr .git wird nie als vertrauenswürdige Basis wiederverwendet.
- 02
Einfrieren
Der Kandidat wird vor der Prüfung festgelegt: Basis, Bytes und Digests, Ref, Ziel und vorheriger Zustand.
- 03
Autorisieren
Die Freigabe ist an diesen Kandidaten gebunden. Eine spätere Änderung macht sie ungültig; ein --yes ersetzt weder MFA noch Quorum.
- 04
Ausführen
Vom Guardian in Verwahrung gehalten, mit Prüfung des Zustands am Ziel: Drift und Races werden nie überschrieben.
- 05
Verifizieren
Unabhängige Verifikation der Postcondition und ein Beleg, den Sie dem PR oder Issue beifügen.
Das anfängliche Ziel ist ein lokales Git-Repository. Mit einem autorisierten Profil und Ziel legt der GitHub-Adapter einen neuen Ref an: Er aktualisiert keinen Branch, führt kein Force-Push, kein Merge und kein Deploy aus, und das Öffnen eines PR ist eine eigene Wirkung mit eigener Autorisierung. Die Verwahrung des Credentials wird nur für das Profil behauptet, das sie mit effektiver Identität, Mounts, Sockets und Netzwerk sowie Canaries aus dem Kontext des Agenten nachweist.
Eine portable Konfiguration, drei Schnittstellen
Die Konfiguration ist eine JSON-Datei, die in Ihrem Repository versioniert wird. Die Bibliothek erzeugt die vollständigen Verträge und ihre Digests; niemand schreibt Signaturen von Hand. CLI und Dashboard importieren und exportieren dieselbe Darstellung und durchlaufen dieselbe Validierung: Es gibt keine Web-Richtlinie, die von der Richtlinie in Git abweicht. Jede Änderung erzeugt eine neue Revision, und aktive Läufe behalten ihren Snapshot.
Szenario
Ein versioniertes SSPI-execution-scenario: Parameter, die Projektquelle mit Kandidaten- und Basis-Digests sowie die Schritte mit ihrer Operation und erwarteten Wirkung. Es akzeptiert keine beliebigen Skripte und kein erwartetes Ergebnis, das bearbeitet wurde, um eine Lücke in einen Erfolg zu verwandeln.
Profil
Der Runner und sein Profil: Backend, Observer-Lease und Lease des Steuerkanals. Das System prüft ihre Verfügbarkeit und die Anwendbarkeit der Nachweise.
Mandat
Wirkungs- und Zeitgrenzen, Digests jeder Wirkung und Ressource sowie die erforderlichen Freigaben: ein Task Contract außerhalb der Reichweite des Agenten.
npm · @securestamp/execution-governancePortable Szenariovarianten als Verträge, eine Kontrollebene mit Hold, Resume und Stop sowie geschwärzte Berichte: Szenarien validieren und serialisieren, Läufe starten, idempotente Anweisungen ausgeben und Berichte erstellen, verifizieren und vergleichen. Es verleiht keine Befugnis, schließt den Host nicht ein und ersetzt nicht den Guardian des Kunden.
CLI · securestamp-mcp-doctor · securestamp-execution-governancescan, scan-native, scan-workflow und scan-harness für die Diagnose; validate und run für Szenarien. Kein Konto. Jeder Lauf erzeugt seinen eigenen Bericht, ohne einen anderen zu überschreiben.
Dashboard · securestamp.online/dashboard/agentsSzenarien, Vorbereitung, Läufe, Live-Detail und Analyse nach dem Lauf, auf registrierten Runnern, die der Kunde betreibt. Der Browser führt den Test nicht aus und erhält keine Anbieter-Credentials; das Verbinden eines Runners ist optional.
Hold, Resume, Stop
Die Steuerungen wirken auf die vom Guardian vermittelten Routen. Der Agent kann weiter schlussfolgern, während seine Wirkungen angehalten sind; die Oberfläche zeigt dies als „Wirkungen angehalten / Prozess läuft“ und nie als eingefrorenen Agenten.
Hold
Der Guardian schließt die Zulassung neuer Wirkungen und behält Budget, verbrauchte Grants und Verlauf. Bereits gesendete Aufrufe werden nicht eingefroren, und es entsteht keine Warteschlange veralteter Wirkungen.
Resume
Vor dem Wiederöffnen werden Mandat, Gültigkeit, Richtlinie, Profil, Beobachter und Budgets neu validiert. Jede neue Anfrage wird erneut bewertet.
Stop
Endgültig für den Lauf: schließt die Zulassung dauerhaft, bricht ausstehende Arbeit ab und beendet überwachte Prozesse samt ihrer Kindprozesse. Hat Vorrang vor Resume und vor einer Wiederverbindung.
Eine erfolgreiche HTTP-Antwort bestätigt nur, dass der Befehl empfangen wurde. Das Dashboard zeigt getrennt an, was angefordert, was vom Supervisor angewendet und was beobachtet wurde. Bricht der Remote-Kanal ab, während der Beobachter gesund ist, bleiben die Zulassungen lokal angehalten; fällt der Beobachter aus, unterbindet das Profil den Egress und beendet den Container. Der lokale Stop hängt nie vom Dashboard ab.
Berichte: Zustände, die nicht zu einer Ampel zusammenfallen
Der Ausführungsbericht trägt nur eine informative Prüfsumme, deklariert seine Nachweisstufe und erlaubt Laufvergleiche; eine Prüfsumme authentifiziert keinen Aussteller. Wenn ein vollständiges Action-Proof-Bundle angehängt ist, prüft der unabhängige Verifier es offline mit außerhalb des Berichts gelieferten Vertrauensankern und bindet Kandidat, Ziel, Autorität und beobachtetes Receipt-Ergebnis. FAIL, SKIP, fehlende Evidenz und nicht bewertete Routen bleiben sichtbar; ein Instrumentierungsfehler ergibt INCOMPLETE, nie PASS.
| Laufstatus | queued · running · held · stopping · stopped · completed · failed · incomplete |
| Ergebnis der Route | PASS · FAIL · SKIP |
| Abdeckung | protected · contradicted · partial · not_evaluated |
| Integration | simulated · integration_real · no_evaluated |
| Vollständigkeit | complete · incomplete |
| Ergebnis des Berichts | PASS · FAIL · INCOMPLETE |
| Ergebnis der Wirkung | succeeded · failed_no_effect · indeterminate |
Prüfsumme ist informativ
Ein Report-Digest prüft die präsentierten Bytes, kann aber von jedem neu berechnet werden, der den Bericht umschreibt. Er authentifiziert keinen Aussteller.
Aussteller vom Betreiber als vertrauenswürdig eingestuft
Nur relativ zu Ankern, die der Betreiber installiert. Ein Anker, der im Artefakt selbst mitgeliefert wird, macht es nicht vertrauenswürdig.
Von einem Dritten reproduziert
Jemand anderes hat dasselbe Pack ausgeführt und dasselbe Ergebnis erhalten. Das ist eine andere Aussage und wird getrennt ausgewiesen.
Informativer Pull-Request-Check
Vergleicht Base und Head der nativen Dateien mit denselben Importern und Regeln, zeigt deklarierte Änderungen, Unbekanntes und Kandidaten für eine erneute Validierung und validiert einen beigefügten Beleg gegen seine Anker. Er läuft von einer gepinnten, vertrauenswürdigen Revision aus, mit Leserechten, ohne Secrets und ohne Code aus dem PR auszuführen. Er dient der Information für das Review: Er ist nicht der Check, der einen Export autorisiert, und ersetzt weder den Guardian noch ein Ruleset.
Was dies nicht leistet
- Es macht das Modell nicht sicher und beweist keine allgemeine Alignment: Es testet Ausführungsgrenzen auf einem deklarierten Profil.
- Es kontrolliert keine Routen, die den Guardian umgehen; eine Route ohne Probe bleibt not evaluated und gilt nie durch Vererbung als geschützt.
- Es macht keine bereits eingetretene Wirkung rückgängig: Hold und Stop sind kein Rollback.
- Ein Beleg zeigt Integrität und Geltungsbereich unter seinen Ankern; er zeigt weder, dass der genehmigte Code harmlos ist, noch dass ihn jemand Unabhängiges auditiert hat.
- Es ist kein unternehmensweiter Kill-Switch: v1 steuert den gewählten Lauf und seine deklarierten Runner.
- Die Kompatibilität wird pro Profil, Version und Umgebung veröffentlicht. Ein PASS auf einem Harness überträgt sich nicht auf ein anderes Betriebssystem, eine andere Route oder einen anderen Client.
Weiterlesen
Status
Verfügbar: Doctor auf nativen Dateien, das über npm, CLI und Dashboard parametrisierte Referenzszenario, Exact Export in ein lokales Git und der informative PR-Check. Berichte unterscheiden Prüfsummen-Historie von einem angehängten Action-Proof-Bundle; ein teilbarer Beleg wird nur behauptet, wenn das Bundle mit externen Ankern verifiziert. Jede Fähigkeit veröffentlicht ihr Nachweisniveau — simulated, echte Integration oder not evaluated — pro Profil und Umgebung.
Offen und reproduzierbar
Szenarien, Fixtures, Rezepte und Vektoren sind veröffentlicht, damit Dritte jede Eigenschaft reproduzieren oder widerlegen können. Gegenbeispiele werden als Issues mit Seed, Profil und beobachtetem Ergebnis eingereicht; sensible Funde folgen SECURITY.md. Es gibt kein Ranking „sicherer Agenten“ und keine generischen Badges.