None

Übersicht

Ein Konnektor speichert, wie RUNOS einen Dienst erreicht: Adresse und Zugangsdaten. Workflows verweisen über den Namen darauf, so stehen keine Geheimnisse im Workflow-JSON, und ein geändertes Passwort pflegen Sie an einer Stelle.

Auth-Typ	Für	Seite
None	Dienste ohne Anmeldung, oder nur gemeinsame Werte	diese Seite
ApiKey	API-Schlüssel, z. B. OpenAI, GitHub, Odoo, Wetterdienste	ApiKey
Basic	Benutzername und Passwort, z. B. SMTP-Server, interne APIs, FTP	Basic
OAuth2	Anmeldung im Browser, z. B. Microsoft 365, Gmail	OAuth2

Ein Konnektor vom Typ None hat keine Zugangsdaten. Er speichert nur die Basis-URL und unter Erweitert → Extra JSON beliebige eigene Werte, etwa eine Mandantennummer oder eine Region. Nützlich für öffentliche APIs und für Werte, die mehrere Workflows teilen.

Extra JSON ist nicht verschlüsselt

Verschlüsselt gespeichert werden nur API-Schlüssel, Passwort, Client Secret und Tokens. Ein Passwort gehört deshalb nicht in Extra JSON, sondern in einen Konnektor vom Typ Basic.

Mit anderen Benutzern teilen

Verwenden mehrere Windows-Benutzer einen gemeinsamen Datenordner, kann dessen Besitzer jeden Konnektor mit Mit den anderen Benutzern dieses Datenordners teilen für die Workflows aller Benutzer freigeben. Ohne andere Benutzer erscheint das Kästchen nicht.

Konnektor anlegen

1. Öffnen Sie links Konnektoren und klicken Sie auf Neu.
2. Wählen Sie Leerer Konnektor oder eine Vorlage.
3. Vergeben Sie einen Namen ohne Leerzeichen, zum Beispiel Wetter. Über diesen Namen sprechen Workflows den Konnektor an.
4. Wählen Sie den Auth-Typ, füllen Sie die Felder aus und klicken Sie auf Speichern.

Testen sendet eine angemeldete Anfrage an die Basis-URL und zeigt die Antwort. Der Status oben zeigt Bereit, Token läuft bald ab, Token abgelaufen, Zugangsdaten fehlen oder Keine Authentifizierung. Duplizieren legt eine Kopie an, zum Beispiel für ein zweites Postfach.

Vorlage	Auth-Typ
Microsoft Outlook Mail, Outlook Contacts	OAuth2 (Microsoft Graph)
Azure Service Principal	OAuth2 Client Credentials
Gmail API	OAuth2 (Google)
GitHub, OpenAI, OpenWeatherMap	ApiKey
FTP Server, Internal REST API	Basic

Sicherheit

Mit Geheimnisse verschlüsseln (Standard) speichert RUNOS API-Schlüssel, Passwörter, Client Secret und Tokens verschlüsselt für den angemeldeten Windows-Benutzer. Ein anderer Benutzer oder ein anderer PC kann sie nicht lesen; auf einem neuen PC geben Sie sie neu ein.

Achtung

Löschen oder Umbenennen eines Konnektors bricht alle Workflows, die ihn verwenden.

Struktur

Unter In einem Workflow verwenden zeigt RUNOS den Platzhalter und kopiert ihn auf Klick:

{{connector.<Name>.<Feld>}}

Feld	Inhalt	Auth-Typ
BaseUrl	Basis-URL	alle
ExtraJson.<Schlüssel>	eigene Werte aus Extra JSON	alle
ApiKey	API-Schlüssel	ApiKey
Username, Password	Zugangsdaten	Basic
AccessToken	OAuth2-Zugriffstoken, wird bei Bedarf erneuert	OAuth2

Extra JSON ist ein JSON-Objekt:

{ "Mandant": "4711", "Region": "eu" }

Beispiel

Konnektor Wetter, Auth-Typ None, Basis-URL https://api.open-meteo.com/v1, Extra JSON { "Lat": "52.52", "Lon": "13.41" }:

{
  "Type": "HttpRequest",
  "Name": "WetterAbfragen",
  "Parameters": {
    "Connector": "Wetter",
    "Url": "/forecast",
    "QueryParameters": {
      "latitude": "{{connector.Wetter.ExtraJson.Lat}}",
      "longitude": "{{connector.Wetter.ExtraJson.Lon}}",
      "current_weather": "true"
    }
  }
}

Ändert sich der Standort, passen Sie nur den Konnektor an; alle Workflows übernehmen den neuen Wert beim nächsten Lauf.