GovBridge einrichten
GovBridge einrichten: Endpunkt für die Behörde anlegen, Zugangsdaten zu DMS oder FIT-Connect hinterlegen und den Adapter in SovrGPT verbinden.
Drei Schritte: Ein Plattform-Admin legt den Endpunkt an, der einmal angezeigte Bridge-Token wird gesichert, und die Behörden-Organisation verbindet ihn im Marketplace.
Voraussetzungen
- Die Organisation hat die Berechtigung „Behörden-Konnektoren“ (sonst zeigt das Formular „⚠ ohne Behörden-Entitlement“).
GOVBRIDGE_ENCRYPTION_KEY(32 Byte, base64) ist auf dem Server gesetzt.- Ein erreichbares Backend mit Dienstkonto (OAuth2 Client Credentials oder Basic): bei CMIS ein CMIS-1.1-Browser-Binding-Endpunkt des DMS, bei FIT-Connect eine Submission-API-v2-Instanz (FITKO) mit den gewünschten Zustellpunkten (Destinations).
Schritt 1: Endpunkt provisionieren
Unter Plattform-Admin → GovBridge (/admin/govbridge) das Formular
„Neuen Endpoint provisionieren“ ausfüllen:
| Feld | Bedeutung |
|---|---|
| Organisation | Organisation, der der Endpunkt gehört. |
| Protokoll | CMIS (DMS/Akte) oder FIT-Connect (OZG). |
| Anzeigename | optional. |
| Backend-Basis-URL | CMIS: Browser-Binding-Endpunkt des DMS (Service-Dokument). FIT-Connect: die Submission-API-v2-Instanz. Nur https. |
| Backend-Authentifizierung | OAuth2 (Client Credentials) (Vorgabe) oder HTTP Basic (Legacy). |
| Schreib-Tools erlauben | Schaltet die Schreibwerkzeuge frei (allow_writes). Ab Werk aus. |
Dazu bei Basic Benutzername und Passwort des Dienstkontos, bei OAuth2 Token-URL
(https), Client-ID, Client-Secret und optional ein Scope (z. B. cmis.read cmis.write).
Die Plattform erzeugt daraus einen opaken Slug und einen Bridge-Token und speichert die Zugangsdaten verschlüsselt (AES-256-GCM).
Schritt 2: Bridge-Token sichern
Der Token erscheint genau einmal („Neuer GovBridge-Token – nur jetzt sichtbar.“). Kopieren Sie ihn sofort: Gespeichert wird nur sein SHA-256-Hash.
Schritt 3: In SovrGPT verbinden
In der Behörden-Organisation unter Marketplace die Vorlage
VIS / DMS-Akte (CMIS-Adapter) bzw. FIT-Connect (OZG-Antragszustellung) verbinden.
Als URL https://govbridge.sovrgpt.com/<slug>/<protocol> eintragen (z. B.
…/abcd1234/cmis), als Token den Bridge-Token. SovrGPT speichert ihn verschlüsselt und
sendet ihn als Authorization: Bearer <bridge-token>.
Nehmen Sie die Vorlage, nicht „Eigenen MCP-Server hinzufügen“: Nur die Vorlagen fragen vor
Schreibaktionen im Chat nach einer Freigabe (confirm_writes), und zwar vor jeder Aktion
einzeln, mit den angezeigten Angaben, eine Stunde gültig
(Freigaben im Chat). Danach stehen die
Werkzeuge des Protokolls im Composer bereit.
Test des Endpunkts
Ein MCP-initialize-Handshake prüft Erreichbarkeit und Token:
curl -s https://govbridge.sovrgpt.com/<slug>/<protocol> \
-H "Authorization: Bearer <bridge-token>" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18"}}'Die Antwort enthält serverInfo.name ("GovBridge CMIS" bzw. "GovBridge FIT-Connect").
Ein 401 heißt: Slug, Token oder <protocol> passen nicht.
Verwaltung & Widerruf
/admin/govbridge listet alle Endpunkte ohne Geheimnisse: Organisation, Protokoll, URL
mit Slug, Token-Präfix, Schreibzugriff und Status. Dort kann ein Plattform-Admin einen
Endpunkt jederzeit widerrufen; widerrufene oder deaktivierte Endpunkte löst der Adapter
nicht mehr auf. Bei verlorenem Token oder Verdacht auf ein Leck den Endpunkt widerrufen
und neu anlegen (neuer Slug, neuer Token). Anlegen und Widerrufen stehen im Audit-Log.