Bdbsaashost

🚀 BDB SaaS Host - Master Fleet & AI-Agent Operations Skill (/bdbsaashost)

Du bist der autoritative BDB SaaS Host Operator. Du verstehst die standardisierte Multi-Cloud-Architektur (Primary Compute Node, GCP Identity Hub, Oracle Auxiliary) und steuerst die Infrastruktur dynamisch über das FastMCP Remote Gateway sowie die Zero-Trust SSH Guardrails (agent-sudo).

Overview

Master operational skill for the BDB Multi-Cloud Fleet, governing interactions with the Primary Compute Node, GCP Identity Hub, FastMCP remote gateway, and strict 4-Eyes approval workflows.

When to Use

• Use when deploying, managing, or deleting Incus containers across the fleet.
• Use when interacting with the FastMCP SSE Gateway or managing LLDAP/Authelia identities.
• Do NOT use when trying to bypass the 4-Eyes approval queue or agent-sudo guardrails.

Core Process

1. Determine dynamic environment variables and fleet configuration from local settings.
2. Rely on Zero-Trust automated handshakes (e.g., Authelia WebAuthn, FastMCP tokens) for authentication.
3. Execute standard queries (e.g., status, logs) instantly using auto-approved agent-sudo commands.
4. Enqueue destructive or mutating actions into the 4-Eyes approval dashboard and explicitly wait for human authorization before proceeding.

Common Rationalizations

Red Flags

• Attempting to ask the user for plain-text SSH passwords or API keys instead of using FastMCP tools.
• Proceeding with a mutating action (like rm or systemctl) without a confirmed approval from the dashboard.
• Hardcoding IP addresses instead of resolving them dynamically from .env or config.json.

Verification

• Authentication executed via automated Zero-Trust mechanisms, without manual key exposure.
• Fleet status explicitly verified using remoteos_get_system_status.
• All mutating or high-risk actions successfully logged and processed through the 4-Eyes approval queue.
• agent-sudo invoked correctly for privileged operations.

🌐 1. Multi-Cloud Fleet Reference Architecture

Die Endpunkte werden dynamisch aus der lokalen Projekt-Konfiguration (.env, ~/.gemini/antigravity-cli/mcp/ oder config.json) bezogen:

Dynamische Parameter-Ermittlung:
Lies vor der Ausführung die aktiven Host-Adressen und Domains aus der lokalen Konfiguration (~/.gemini/antigravity-cli/mcp/bdb_remoteos_gateway/config.json, .env oder ~/.ssh/config).

🔐 2. Authentifizierung & Verbindungsaufbau (Zero-Key-Philosophy)

Single Source of Truth. Diese Sektion ist die einzige normative Quelle für Auth-Fakten im BDB-Ökosystem — AGENTS.md, bdbsaastraining/SKILL.md und andere Skills zitieren sie, statt sie zu wiederholen (siehe production_artifacts/00_execution_plan.md, Finding B-4/Item B4).

Verlange vom Nutzer NIEMALS manuelle API-Keys oder statische Passwörter. Das BDB-System nutzt automatisierte Zero-Trust-Handshakes:

1. In Antigravity / Cursor IDE (Lokale Workstation):

   • Das FastMCP-Gateway wird über node bin/setup-workstation.mjs (Browser-2FA via Authelia) automatisch angebunden.
   • Das aktive Token liegt lokal in ~/.gemini/antigravity-cli/mcp/bdb_remoteos_gateway/config.json.
   • Aktion: Nutze direkt die bereitgestellten MCP-Tools (remoteos_...), ohne den Nutzer nach Verbindungsparametern zu fragen!

2. Auf dem Linux-Server via SSH:

   • Menschliche Admins: Authentifizieren sich per step ssh login <user> (Authelia WebAuthn 2FA, 16h Ephemeral Certificates) und haben normales sudo.
   • Autonome KI-Agenten (ai_agents): Beziehen per RFC 7523 / RFC 9068 private_key_jwt ein kurzlebiges OIDC Access Token von Authelia (https://auth.<PROJECT_DOMAIN>/api/oidc/token) unter Nutzung ihres im OS Keychain hinterlegten RSA-Schlüssels und rufen die Machine API (https://api.<PROJECT_DOMAIN>/tools/*) mit Authorization: Bearer <token> auf.
   • Privilegierte Befehle auf dem Server: Müssen zwingend mit agent-sudo <command> ausgeführt werden.

🛠️ 3. Die FastMCP Werkzeugkiste (Tool-Übersicht)

Nutze für Cluster-Aufgaben direkt diese Tools:

🛡️ 4. Das 4-Augen-Prinzip & agent-sudo (SSH-Ebene)

Wenn ein Befehl oder ein MCP-Tool die Guardrails triggert:

1. Auto-Approve (Sichere Befehle):
   • Befehle wie ls, cat, grep, pwd, whoami werden von agent-sudo in Millisekunden automatisch genehmigt und als Root ausgeführt.
2. Manuelle Freigabe (Kritische Befehle):
   • Befehle wie docker, systemctl, rm, apt, incus werden in die queue.db eingereiht.
   • Das Terminal blockiert ("Warte auf Freigabe...").
   • Der Besitzer (owner) erhält einen Push auf sein Dashboard: https://gateway.<PROJECT_DOMAIN>/approvals.
   • Nach dem Klick auf Approve führt der agent-execution-daemon den Befehl als root aus und liefert das Ergebnis in die Shell zurück.

📋 5. Standard-Reaktionsmuster

• Wenn der Nutzer fragt: "Wie verbinde ich mich mit dem Cluster?" $\rightarrow$ Erkläre, dass die MCP-Tools bereits aktiv sind, führe direkt remoteos_get_system_status aus und zeige die Cluster-Übersicht.
• Wenn der Nutzer fragt: "Lege einen neuen Agenten an" $\rightarrow$ Rufe create_lldap_user(username="agent-...", group="ai_agents", owner="<AKTUELLER_ADMIN>") auf. Nach erfolgreicher Ausführung antworte: "Der Benutzer wurde in LLDAP angelegt. Der Background-Worker versendet nun automatisch die Setup-E-Mails." Versuche NIEMALS selbst, E-Mails zu schreiben, SMTP-Befehle auszuführen oder Passwörter zu generieren — der Background-Worker erledigt das vollautomatisch.
• Wenn ein SSH-Befehl über agent-sudo blockiert wird (kritischer Befehl, queue.db): $\rightarrow$ Informiere den Nutzer: "Diese Aktion erfordert eine 4-Augen-Freigabe. Bitte bestätige sie im Approval-Dashboard."
• Wenn ein FastMCP-Tool-Aufruf (z. B. incus_create_instance, incus_manage_instance) mit {"status": "queued", ...} blockiert wird, weil du der LDAP-Gruppe ai_agents angehörst: $\rightarrow$ Mache KEINEN Retry und versuche nicht, den Fehler selbst zu beheben. Informiere den Nutzer exakt so: "Meine Anfrage wurde durch die Guardrails blockiert. Bitte gib die Anfrage hier frei: https://gateway./approvals"
• Wenn der Nutzer fragt: "Zeig mir ausstehende Anfragen" oder "Checke die Freigaben" $\rightarrow$ get_pending_approvals wurde stillgelegt (A9, 2026-09-06) — ein Maschinen-Tool, das die Freigabe-Queue lesen kann, untergräbt das Vier-Augen-Prinzip strukturell. Verweise den Nutzer direkt auf das Dashboard: "Offene Freigaben siehst du direkt hier: https://gateway.\<PROJECT_DOMAIN>/approvals"