Konfiguration & Authentifizierung
Konfigurationsdatei
Abschnitt betitelt „Konfigurationsdatei“Der Connector liest <installDir>/config.json. Das Installationsverzeichnis ist NARA_INSTALL_DIRECTORY, falls gesetzt, andernfalls das aktuelle Arbeitsverzeichnis. Beim ersten Start wird die Datei aus config.default.json erzeugt.
| Schlüssel | Beschreibung |
|---|---|
toolRpcUrl | WebSocket-URL des Tool-RPC-Servers. |
authTokenPath | Pfad zur Auth-Token-Datei (Standard ./auth-token.json). |
customImplementationsPath | Pfad zu eigenen Tool-Implementierungen (Standard ./custom-implementations/index.js). |
connectorType | Connector-Typ (EDGE). |
platformApiUrl | Basis-URL der Plattform-API. |
deploymentId | Deployment, zu dem dieser Connector gehört. |
currentBundleId | Aktuell aktives Tool-Bundle. |
Umgebungsvariablen
Abschnitt betitelt „Umgebungsvariablen“| Variable | Beschreibung |
|---|---|
TOOL_RPC_URL | Überschreibt toolRpcUrl. |
PLATFORM_API_URL | Überschreibt platformApiUrl. |
AUTH_TOKEN_PATH | Überschreibt authTokenPath. |
DEPLOYMENT_ID / DEPLOYMENT_SECRET | Cloud-Deployment-Zugangsdaten (headless, keine Browser-Anmeldung). |
HEALTH_PORT | Port des Health-Servers (Standard 8080). |
EC_DISABLE_TRAY | Deaktiviert das Tray-Symbol. |
EC_DISABLE_AUTOSTART | Deaktiviert die Autostart-Registrierung. |
Authentifizierung
Abschnitt betitelt „Authentifizierung“Die Runtime wählt den Authentifizierungsmodus automatisch: Sind DEPLOYMENT_ID und DEPLOYMENT_SECRET gesetzt, läuft sie im Cloud-Deployment-Modus ohne Browser-Interaktion; andernfalls verwendet sie ein gespeichertes Token oder startet den Browser-Geräteflow. Fehlgeschlagene Authentifizierung wird mit Backoff von 30 bis 300 Sekunden erneut versucht.
Browser-Geräteflow
Abschnitt betitelt „Browser-Geräteflow“Der Connector fordert einen Verifizierungscode an und öffnet den Browser auf der Autorisierungsseite (/edge/desktop/verify), die den Code anzeigt. Klicken Sie in der Webapp auf Approve, um das Gerät zu autorisieren. Der Connector fragt das Session-Token ab und bricht nach 2 Minuten mit Timeout ab. Unter Windows zeigt das Tray-Menü einen Login-Eintrag, solange der Connector nicht authentifiziert ist.
Token-Flow
Abschnitt betitelt „Token-Flow“Übergeben Sie ein vorhandenes JWT (oder einen Pfad zu einer Token-Datei) direkt:
edge-connector auth -t <token>Das Token muss gültig sein und Organisationsinformationen enthalten. Es wird unter dem authTokenPath mit Dateimodus 0600 gespeichert.
Runtime-Verhalten
Abschnitt betitelt „Runtime-Verhalten“- Verbindung und Wiederholungen — Verbindungsversuche starten mit 5 Sekunden Backoff, verdoppeln sich bis maximal 60 Sekunden, bei höchstens 10 Versuchen. Ein Heartbeat-/Reconnect-Check läuft alle 30 Sekunden.
- Bundle-Synchronisierung — die Runtime prüft alle 10 Minuten sowie bei Push-Benachrichtigungen auf Bundle-Updates. Updates vergleichen Prüfsummen, laden herunter, tauschen das
dist-Verzeichnis atomar aus und registrieren die Tools anschließend neu. - Integrierte Diagnose —
getSystemInfo,getResourceUsageundgetTopProcessessind immer verfügbar und können nicht überschrieben werden. - Health-Endpunkte — ein HTTP-Server auf
HEALTH_PORT(Standard 8080) stellt/livez,/healthz(503 während des Starts) und/statusz(Verbindungsstatus, letzter Verbindungsfehler, Webhook-Relay-Status) bereit.