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. |
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ü Anmelden, solange der Connector nicht authentifiziert ist, und danach Windows-Konto verbinden.
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.