Zugangsdaten für Integrationen verwalten

Unter Einstellungen → Zugangsdaten hinterlegst du Schlüssel und Anmeldedaten für externe Dienste. Danach kannst du sie in mehreren Tools oder Abfragen auswählen. Du brauchst die Berechtigung, Zugangsdaten zu verwalten.

Diese Zugangsdaten gehören zu externen Diensten. Schlüssel für den Zugriff einer Anwendung auf Nuvoca erstellst du separat unter API-Zugriff.

Authentifizierung auswählen

Typ	Geeignet, wenn	Konfiguration
API-Schlüssel	Der Service einen festen Schlüssel oder Token bereitstellt	Name und geheimer Wert. Wähle den erforderlichen Header und Präfix in der Integration.
Basic Auth	Der Service HTTP Basic erwartet	Benutzername, Passwort und erlaubte Ressourcen-URL.
HTTP Login	Eine Login-Anfrage einen Token zurückgibt	Login-Anfrage, Token-Extraktion, Gültigkeit und optionale Refresh-Anfrage.
OAuth	Der Service einen OAuth-Grant verwendet	Der OAuth-Anleitung folgen.

Nutze das vom externen Service dokumentierte Verfahren. Ein API-Schlüssel gehört nicht in die OAuth-Felder für Client-ID und Client-Secret.

Bei einem gespeicherten API-Schlüssel wird der Präfix exakt vor den Schlüssel gesetzt. Für einen Bearer-Header gibst du Bearer mit einem Leerzeichen am Ende ein; für einen reinen API-Key bleibt der Präfix leer. Nuvoca ergänzt keine Trennzeichen. Prüfe nach dem Ändern alle Verwendungen des Eintrags.

HTTP Login konfigurieren

1. Gib Login-URL sowie unterstützte Methode und Anfrageformat an.
2. Konfiguriere Login-Felder, Header oder Body-Vorlage. Kennzeichne geheime Werte entsprechend.
3. Lege den Pfad zum zurückgegebenen Zugriffstoken fest.
4. Konfiguriere den Ablauf anhand der Antwort oder der unterstützten Gültigkeitseinstellungen.
5. Ergänze bei Bedarf Refresh-Token-Pfad und Refresh-Anfrage.
6. Lege Ressourcen-URL, Token-Header und den von der Ziel-API erwarteten Präfix fest.
7. Teste die Authentifizierung, danach eine Anfrage an die tatsächliche Ressource.

Wenn die Login-Antwort etwa {"access_token":"example-token","expires_in":3600} enthält, wähle im Editor die Felder für den Zugriffstoken und seine Gültigkeitsdauer aus.

Zugangsdaten nutzen und austauschen

Wähle die Zugangsdaten im API-Tool, in der MCP-Verbindung oder im Verarbeitungseditor, soweit der Authentifizierungstyp dort unterstützt wird. Prüfe Ziel-URL und Authentifizierungsheader. Vermeide einen zweiten widersprüchlichen Authorization-Header.

Ändert sich ein Schlüssel, aktualisiere den gespeicherten Eintrag und teste die verbundenen Tools. Prüfe vor dem Löschen die angezeigten Verwendungen und wähle dort zuerst einen Ersatz.

Authentifizierungsfehler beheben

Prüfe bei einem Fehler die Ziel-URL, das Anmeldeverfahren und die Berechtigungen des verwendeten Kontos. Kontrolliere außerdem, ob der Token abgelaufen ist und der Header-Präfix zur API passt. Entferne geheime Werte aus Screenshots, bevor du sie an den Support sendest.