Agenteninstanz-Identität

Eine Instanz-ID ist kein Berechtigungsnachweis

XMEMO_AGENT_INSTANCE_ID identifiziert eine lokale Client- oder Runner-Instanz; sie autorisiert keine Anfrage. Der API-Schlüssel oder die OAuth-Autorisierung ist der Zugriffsberechtigungsnachweis. Der Server leitet aus dem Instanzwert einen agent_instance_id_hash ab und meldet die Grenzautorität als attribution_only.

• Berechtigungsnachweis: X-API-Key oder die akzeptierte OAuth-Bearer-Autorisierung steuert den Zugriff.
• Instanzbezeichnung: X-Memory-OS-Agent-Instance-ID ermöglicht es dem Server, den schreibenden Runner mit einem späteren Aufrufer zu vergleichen.
• Agentenbezeichnung: X-Memory-OS-Agent-ID identifiziert den logischen Agenten getrennt von einer einzelnen Installation.

Normalisieren, danach hashen

Die Laufzeitumgebung bereinigt eine Instanz-ID, lehnt leere Werte ab und akzeptiert maximal 256 Zeichen, bevor sie mittels SHA-256 gehasht wird. Ein gespeicherter Hash wird als sha256:<64 Hexadezimalzeichen> normalisiert; fehlerhafte vorab gehashte Werte werden ignoriert und nicht als Berechtigungsnachweise behandelt.

from memory_manager.auth.agent_identity import agent_instance_id_hash

instance_hash = agent_instance_id_hash("codex-local-install")
# sha256:<64 hexadecimal characters>

Einen Wert pro lokaler Installation beibehalten

Speichern Sie einen einzelnen nicht-geheimen Instanzwert außerhalb des Repositoriums dauerhaft und senden Sie ihn mit dem Zugriffsberechtigungsnachweis. Verwenden Sie ihn nach einem Neustart für dieselbe Installation wieder; wählen Sie einen anderen Wert für ein separates lokales Profil.

X-API-Key: <your-assigned-api-key>
X-Memory-OS-Agent-ID: codex
X-Memory-OS-Agent-Instance-ID: <stable-local-instance-id>

Grenzsemantiken sind explizit

memory_agent_boundary vergleicht agent_id und Instanz-Hash des Aufrufers mit den Werten des Datensatzes. Stimmen beide überein, gilt dies als self; eine übereinstimmende agent_id mit einem anderen Hash ergibt same_agent_other_instance; eine fehlende vergleichbare Identität wird als unverified oder unknown gemeldet. Diese Bezeichnungen erläutern die Herkunftszuordnung und ersetzen keine Token-Autorisierung.

{
  "relation": "self",
  "ownership": "current_agent",
  "boundary_authority": "attribution_only",
  "current_agent_trust": "client_asserted"
}