{"queue_id": 87, "relative_path": "Systemstruktur/Agenten-Wissen/Anthropic-Sonnet/ARC-023-Gateway-Key-Trennung-Audit-Log-Muster.md", "title": "ARC-023 — Gateway-Key-Trennung und Audit-Log-Muster fuer externe LLM-Aufrufer", "import_key": "646efdf91e62ceec95734121672fcc13a50361bc69523c77abb2f0308ad86b76", "chunk_count": 17, "created_nodes": 0, "created_relationships": 0, "body": null, "chunks": [{"chunk_key": "d2ac4bcd4c6b7884544f94679fb3120ad548cbd61ce85057a29c33f42e10fff2", "chunk_index": 0, "heading": "", "text": "---\ntype: agent_knowledge_archive\nsource: claude_sonnet_local_sessions\nstatus: aktiv\nscope: gateway-key, audit-trennung, llm-gateway, agent-sicherheit\ngraphiti_candidate: false\noperational_detail_level: internal\ngraphiti_review_required: true\ngraphiti_blocked_reason: Architekturmuster fuer externe LLM-Anbindung — vor Graphiti-Import auf Aktualitaet pruefen\n---", "text_hash": "a09dcd8dc2778f6ecd2f41e0adb54f13fbd8da08b28f295feaf2cc1213a7270c"}, {"chunk_key": "3833222d8714ec6ae5c8bb4828889e3b5b7bc3b1c68d23a21663d6e7d734ce4b", "chunk_index": 1, "heading": "ARC-023 — Gateway-Key-Trennung und Audit-Log-Muster fuer externe LLM-Aufrufer", "text": "graphiti_review_required: true\ngraphiti_blocked_reason: Architekturmuster fuer externe LLM-Anbindung — vor Graphiti-Import auf Aktualitaet pruefen\n---\n# ARC-023 — Gateway-Key-Trennung und Audit-Log-Muster fuer externe LLM-Aufrufer", "text_hash": "a14e16604c2c91907983e8602334b55e7c534783cf10311e0faf8b3875cf6570"}, {"chunk_key": "2ec456550e226ee9721a44eb0fe9f4a4022e4113486d8c574784f054643e7859", "chunk_index": 2, "heading": "Kernaussage", "text": "# ARC-023 — Gateway-Key-Trennung und Audit-Log-Muster fuer externe LLM-Aufrufer\n## Kernaussage\nExterne LLM-Aufrufer (Agenten, Dienste) erhalten jeweils einen eigenen Gateway-Key\nzur Audit-Trennung — nicht den Root-Key des LLM-Gateways. Jeder Key ist einem\nspezifischen Aufrufer zugeordnet. Externes Tool-Ausfuehrungsrecht: ausschliesslich\nREAD-only. Kein oeffentlicher Gateway-Zugang wurde implementiert.", "text_hash": "46c3e48503557c93f003edd6581dc1d3e7fc8f9e7dfa1b53a2db1479c5d79064"}, {"chunk_key": "2e985b6cc114b336ce8c67216c689c6cedbd37e8faa78c3cd5fbafcd38c04901", "chunk_index": 3, "heading": "Aus Sessions rekonstruiert, nicht live verifiziert", "text": "m\nspezifischen Aufrufer zugeordnet. Externes Tool-Ausfuehrungsrecht: ausschliesslich\nREAD-only. Kein oeffentlicher Gateway-Zugang wurde implementiert.\n## Aus Sessions rekonstruiert, nicht live verifiziert\nArchitekturmuster aus Session ec685aa4 (2026-05-11, Subagent von 9e9fb4f3 / ARC-011).\nAktueller Betriebsstatus nicht live geprueft.", "text_hash": "59cb0ebfea558b31af6a1b98faf8f6699665eb9ec678a502428cb2dbe0dc3adf"}, {"chunk_key": "eef00bdcd42c43b7b753104d07455b83a89e6ca9652d124dcf274bc22fe1060b", "chunk_index": 4, "heading": "Getroffene Entscheidungen", "text": "t live verifiziert\nArchitekturmuster aus Session ec685aa4 (2026-05-11, Subagent von 9e9fb4f3 / ARC-011).\nAktueller Betriebsstatus nicht live geprueft.\n## Getroffene Entscheidungen", "text_hash": "2ad4094568875d960ab8473d1872153837bc9e3d800e244fa2020183868a9661"}, {"chunk_key": "588b4658d696faa583be38592b89ae4b136cf77a60e213e9f8c879a46088258a", "chunk_index": 5, "heading": "Gateway-Key-Trennung", "text": "## Getroffene Entscheidungen\n### Gateway-Key-Trennung\n- Jeder externe LLM-Aufrufer (Agent, Dienst, Modul) erhaelt einen separaten Gateway-Key\n- Key-zu-Agent-Mapping wird gefuehrt: welcher Key gehoert welchem Aufrufer\n- Zweck: Audit-Logs sind pro Aufrufer auswertbar — kein gemischter Traffic\n  unter einem Root-Key\n- Root-Key des Gateways wird nicht an Aufrufer weitergegeben\n- Key-Uebergabe an Container: als explizite Container-Umgebungsvariable —\n  nicht aus lokaler Konfigurationsdatei ableiten (wird nicht weitergereicht)", "text_hash": "ae2dd8888edfe11c3f3061156cc8eebe49ee0c831f0b3f499d1e2fc9bb551238"}, {"chunk_key": "dcfbfd64f20a7690bccd7a7c81ca4700217d78e707d548c3eefb818e7bad0f85", "chunk_index": 6, "heading": "Externe LLM-Aufrufer: Eingeschraenkte Rechte", "text": "- Key-Uebergabe an Container: als explizite Container-Umgebungsvariable —\n  nicht aus lokaler Konfigurationsdatei ableiten (wird nicht weitergereicht)\n### Externe LLM-Aufrufer: Eingeschraenkte Rechte\n- Externe LLM-Aufrufer erhalten keine Root-Ausfuehrungsrechte auf dem System\n- Tool-Zugriff fuer externe Aufrufer: ausschliesslich READ-only\n- Kein Schreibzugriff, kein Shell-Ausfuehrungsrecht ueber den Gateway-Pfad\n- Rationale: Externe LLMs werden als nicht vertrauenswuerdig behandelt,\n  auch wenn sie ueber einen bekannten Gateway-Anbieter geroutet werden", "text_hash": "d213b51cea60c3dbfbf4a5deba64ba224ee1f9b0d86eb8d4e41321cd9ec522b1"}, {"chunk_key": "067d329931f5ebf91c0a9df774556c7b6d61efc7aae52412ba5014e7bb6b24f6", "chunk_index": 7, "heading": "Kein oeffentlicher Gateway-Zugang", "text": "ay-Pfad\n- Rationale: Externe LLMs werden als nicht vertrauenswuerdig behandelt,\n  auch wenn sie ueber einen bekannten Gateway-Anbieter geroutet werden\n### Kein oeffentlicher Gateway-Zugang\n- Gateway-Endpunkt ist nicht oeffentlich exponiert\n- Zugriff nur innerhalb des VPS-Netzwerks oder ueber authentifizierte Verbindungen\n- Oeffentlicher Gateway-Zugang wurde explizit nicht umgesetzt (Stand Mai 2026)", "text_hash": "4f1fede6cbdd4db5e0b4f385e5cf7acdad521d73de13faa46f01036a6cd85cb6"}, {"chunk_key": "095b2c6e3d0741d173927ff65b2f73345d2ef74c9c3254e9dccf3547c5cf4a02", "chunk_index": 8, "heading": "Funktionierende Loesungen (aus Session)", "text": "ur innerhalb des VPS-Netzwerks oder ueber authentifizierte Verbindungen\n- Oeffentlicher Gateway-Zugang wurde explizit nicht umgesetzt (Stand Mai 2026)\n## Funktionierende Loesungen (aus Session)\n- Heartbeat-Test mit separatem Gateway-Key erfolgreich:\n  Aufrufer-Dienst → Gateway → externes LLM → Antwort (run succeeded)\n- Container-Umgebungsvariable als korrekter Uebergabepfad bestaetigt", "text_hash": "de982a48e1f08e218e0a09ec37ac5517c2b47eda70d0f7f21682f0addcf33fac"}, {"chunk_key": "63a4e8d30b249a5552210c54c42a6e9e91042e2c588470d0fed0d33c8e9bbc0b", "chunk_index": 9, "heading": "Bekannte Probleme / Sackgassen", "text": "erfolgreich:\n  Aufrufer-Dienst → Gateway → externes LLM → Antwort (run succeeded)\n- Container-Umgebungsvariable als korrekter Uebergabepfad bestaetigt\n## Bekannte Probleme / Sackgassen\n- Key nur in lokaler Konfigurationsdatei ohne explizite Container-Uebergabe:\n  Gateway-Key wird nicht in den Container weitergereicht → Auxiliary-Funktion fehlt\n- Folge: Dienst startet, aber Kontextkomprimierung und Hilfsfunktionen schlagen fehl", "text_hash": "0c73dc3ac6b7de3036111a3ed0817133592ac0da368fb63bbb44c0a5b7796642"}, {"chunk_key": "0ad53a2a26fa7d16aca7677eb286d29c5517b6d3168fba633ff49e97c90f78c9", "chunk_index": 10, "heading": "Ueberholte Inhalte", "text": " nicht in den Container weitergereicht → Auxiliary-Funktion fehlt\n- Folge: Dienst startet, aber Kontextkomprimierung und Hilfsfunktionen schlagen fehl\n## Ueberholte Inhalte\n- OpenClaw ist geloescht — war als moeglicher Gateway-Aufrufer erwaehnt worden", "text_hash": "b64b5768b2c06e7f18167d9072dc2e6c9b937f27092189234e8625f60191d309"}, {"chunk_key": "8f9a21921baf514265dec03159983042a6759b8d96bc1ba519529fbca94ae1fb", "chunk_index": 11, "heading": "Offene Pruefaufgaben", "text": "## Ueberholte Inhalte\n- OpenClaw ist geloescht — war als moeglicher Gateway-Aufrufer erwaehnt worden\n## Offene Pruefaufgaben\n- [ ] Ist das Key-zu-Agent-Mapping dokumentiert (ausserhalb dieser Session)?\n- [ ] Sind alle aktiven Gateway-Keys als Container-Umgebungsvariablen uebergeben?\n- [ ] Gibt es inzwischen einen oeffentlichen Gateway-Endpunkt? (war Mai 2026 nicht umgesetzt)", "text_hash": "06c1d7f33e503620d10aa012cb9fa19b86372484592483e6ff511d5969d8a202"}, {"chunk_key": "70c29b1ada1621c443c79996a0ebdea205cbbcb88c302287f02d80e60cc9d8d7", "chunk_index": 12, "heading": "Relevante Referenzen (ohne operative Zugangsdaten)", "text": "ateway-Keys als Container-Umgebungsvariablen uebergeben?\n- [ ] Gibt es inzwischen einen oeffentlichen Gateway-Endpunkt? (war Mai 2026 nicht umgesetzt)\n## Relevante Referenzen (ohne operative Zugangsdaten)\n- LLM-Gateway: externer Routing-Dienst fuer Modellaufrufe\n- Container-Umgebungsvariablen: environment-Block in docker-compose.override.yml\n- Audit-Trennung: ein Key pro Aufrufer — kein Shared-Key", "text_hash": "27fbab981cf819e378d96e7cd499246755d7a37e41f1a76c4fc406357963a66e"}, {"chunk_key": "d1fb7a9d34b3002690dbaeecdb3035ff3a8ea5e4f97fa11282297853ba90caea", "chunk_index": 13, "heading": "Regeln fuer kuenftige Agenten", "text": "odellaufrufe\n- Container-Umgebungsvariablen: environment-Block in docker-compose.override.yml\n- Audit-Trennung: ein Key pro Aufrufer — kein Shared-Key\n## Regeln fuer kuenftige Agenten\n1. Keinen Root-Gateway-Key an externe Aufrufer weitergeben — immer separaten Key anlegen\n2. Key-zu-Agent-Mapping fuehren und aktuell halten\n3. Container-Umgebungsvariablen explizit setzen — lokale Konfigurationsdatei reicht nicht\n4. Externe LLM-Aufrufer: nur READ-only Tools erlauben, keine Ausfuehrungsrechte\n5. Gateway-Endpunkt nicht oeffentlich exponieren ohne explizite Nutzerfreigabe", "text_hash": "80b75d0ec0aeaa26b35cbf4d5d685a4390e30e5db908ac73887d36c3523cd1ea"}, {"chunk_key": "1121c5b4d0b0318a57b54c351f175bc218ed8a2e378f6f58aea29fb5f636435a", "chunk_index": 14, "heading": "Quelle / Herkunft", "text": "ne LLM-Aufrufer: nur READ-only Tools erlauben, keine Ausfuehrungsrechte\n5. Gateway-Endpunkt nicht oeffentlich exponieren ohne explizite Nutzerfreigabe\n## Quelle / Herkunft\n- Session ec685aa4 (2026-05-11, 6958 KB): Subagent von 9e9fb4f3 (ARC-011)\n  Primaerinhalt: Gateway-Key-Placement, Audit-Trennung, Aufrufer-Einschraenkung", "text_hash": "d00e7b01e19b4e379cdb74a46352ff3feb6d5ee13d4f723afc937da9c35778b5"}, {"chunk_key": "0cb80efcf5cbfe29302d36ccbc773126894391fdaff37a0f14553c1337c44768", "chunk_index": 15, "heading": "Sicherheitsbereinigung", "text": "ession ec685aa4 (2026-05-11, 6958 KB): Subagent von 9e9fb4f3 (ARC-011)\n  Primaerinhalt: Gateway-Key-Placement, Audit-Trennung, Aufrufer-Einschraenkung\n## Sicherheitsbereinigung\n| Fund in Quellsessions | Massnahme |\n|----------------------|-----------|\n| API-Key im Klartext in Session (ec685aa4) | Nicht im Artefakt — Key sollte rotiert werden |\n| Keine weiteren Secrets im Artefakt | — |\n\nDieses Artefakt enthaelt keine Key-Werte, keine Key-Laengen, keine konkreten Secrets\nund keine operativen Zugangspfade.", "text_hash": "4511f1cdc655ca2f153573ef1d34e701ccd825bec1afe7b88f14035de73fff6a"}, {"chunk_key": "10abe18b3dd30c6840344c59336bfe93cfd1a8685c2684c58609b28b69f54a6f", "chunk_index": 16, "heading": "Verifikationsstatus", "text": "ren Secrets im Artefakt | — |\n\nDieses Artefakt enthaelt keine Key-Werte, keine Key-Laengen, keine konkreten Secrets\nund keine operativen Zugangspfade.\n## Verifikationsstatus\nENTWURF. Nicht live verifiziert. Stand: Mai 2026.\nZielpfad: /opt/obsidian-vault/Systemstruktur/Agenten-Wissen/Anthropic-Sonnet/", "text_hash": "718e5b18ab0139ef6a4cb264cc540bbec78a2cabc5080f2f5532d1ed18aa1127"}], "elapsed_s": 0.027}