External AI Ecosystem Gateway

Ein sicherheitsorientiertes Python-Gateway, das MCP-kompatiblen Assistenten-Clients Tools mit Berechtigungsumfang bereitstellt und dabei den Zugriff auf externe Systeme wie Slack vermittelt. Es demonstriert Mandantenisolierung, delegierte Autorisierung, menschliche Bestätigung für sensible Schreibvorgänge, idempotente Ausführung, signierte Webhook-Verifizierung, widerrufsfähige Grant-Speicherung und einen hash-verketteten Audit-Trail.

Dies ist eine Portfolio-/Referenzimplementierung, kein Produktions-Identitätsanbieter. Der header-basierte Entwicklungs-Auth-Adapter muss vor der Bereitstellung durch die in docs/security.md beschriebene OIDC-Validierungs-Middleware ersetzt werden.

Architektur

Assistant / Slack client
          |
          v
  FastAPI edge + auth adapter
          |
          v
 Policy + tenant boundary ----> confirmation tokens
          |
          v
 Sandboxed tool registry -----> Slack / OpenAI / Claude adapters
          |
          +--------------------> idempotency store
          +--------------------> append-only hash-chained audit log

Related MCP server: MCP Tool Manager

Schnellstart

python -m venv .venv
source .venv/bin/activate
pip install -e '.[dev]'
uvicorn ecosystem_gateway.app:app --reload

Tools auflisten:

curl localhost:8000/mcp/tools \
  -H 'X-Subject: user-1' -H 'X-Tenant-Id: tenant-a' -H 'X-Roles: operator'

Führen Sie die Testsuite mit pytest aus. Wenn kein Slack-Token konfiguriert ist, laufen die Connectors in einem sicheren Sandbox-Modus und geben die Anfrage zurück, die sie senden würden.

Sicherheitseigenschaften

• Jeder Principal und jeder Idempotenzschlüssel ist im Mandanten-Namespace angesiedelt.

• Tool-Richtlinien kombinieren Rollen mit geringsten Privilegien mit delegierten Scopes.

• Sensible Schreibvorgänge erfordern ein kurzlebiges Token, das an Subjekt, Mandant, Tool und Argumente gebunden ist.

• Webhook-Signaturen verwenden einen Konstantzeit-Vergleich und lehnen veraltete Anfragen ab.

• Audit-Datensätze bilden eine SHA-256-Kette, sodass Löschung oder Veränderung erkennbar ist.

• OAuth-Grants unterstützen den Widerruf und legen Refresh-Tokens niemals über Tool-Ergebnisse offen.

Siehe docs/security.md für die Checkliste zur Produktionshärtung und das Bedrohungsmodell.

Lizenz

MIT