Zum Inhalt springen
nara Dokumentation

Deployments & Credentials

Deployments Connector-Identität

Was ist ein Deployment?

Abschnitt betitelt „Was ist ein Deployment?“

Ein Deployment repräsentiert eine logische Edge‑Connector‑Instanz (z. B. „Berlin DC Router“ oder „Kunde A – SAP Connector“). Deployments ermöglichen dir:

  • zu sehen, wo Connectoren laufen,
  • Last‑Seen‑Zeitpunkte und Status zu überwachen,
  • bestimmte Tool‑Bundles gezielt bestimmten Umgebungen zuzuordnen.

Deployment-Credentials

Abschnitt betitelt „Deployment-Credentials“

Jedes Deployment hat:

  • deploymentId – stabile Kennung der Connector‑Instanz
  • deploymentSecret – Shared Secret für die Verbindung zu Tool RPC

Diese werden auf dem Host des Connectors in deployment-credentials.json gespeichert (Pfad via deploymentCredentialsPath oder DEPLOYMENT_CREDENTIALS_PATH konfigurierbar).

Desktop-Modus

Abschnitt betitelt „Desktop-Modus“

Im Desktop‑Modus erledigt die Runtime:

  1. Authentifizierung über den Desktop‑Browser‑Flow,
  2. Aufruf eines Plattform‑Endpoints zur Auto‑Registrierung eines Deployments,
  3. Speichern von deploymentId und deploymentSecret lokal,
  4. Wiederverwendung desselben Deployments bei späteren Läufen.

Die Verwaltung erfolgt überwiegend in der nara Webapp (Admin → Deployments).

Server-Modus

Abschnitt betitelt „Server-Modus“

Im Server‑Modus verwaltest du Deployment‑Credentials explizit:

  • setze deploymentId und deploymentSecret in config.json, oder
  • setze DEPLOYMENT_ID und DEPLOYMENT_SECRET als Environment, oder
  • lege eine deployment-credentials.json dort ab, wo die Runtime sie erwartet.

Die Runtime lädt die Credentials beim Start und nutzt sie für die Authentifizierung beim Tool‑RPC‑Server.