Anfragen authentifizieren
Viele Endpoints erfordern eine Anmeldeinformation. Ein Linked Service kann einen Anfrage-Header anhängen, dessen Wert als Geheimnis gespeichert ist:
- Header name – der zu sendende Header, z. B.
AuthorizationoderX-Api-Key. - Secret value – der Wert, z. B. ein Bearer-Token oder API-Schlüssel.
Seekdown fügt diesen Header der Anfrage auf dem Server hinzu. Das Geheimnis wird sicher gespeichert und nie an den Browser zurückgegeben, in die öffentliche Assistenten-Konfiguration aufgenommen oder in ein Konfigurations-Backup geschrieben – der Editor zeigt immer nur an, ob ein Geheimnis gesetzt ist, nicht dessen Wert.
Statisches Geheimnis oder weitergeleitetes Token
Verwenden Sie ein gespeichertes Geheimnis, wenn die Anmeldeinformation für jeden Besucher gleich ist (ein API-Schlüssel für einen Service). Um stattdessen eine Anmeldeinformation pro Nutzer zu übergeben, speichern Sie kein Geheimnis – fügen Sie einen Header mit dem Wert Bearer {{params.token}} hinzu, wie unter Dynamische Werte übergeben beschrieben, und liefern Sie das Token beim Start des Assistenten.
Geheimnis festlegen, ersetzen oder entfernen
- Festlegen / ersetzen – geben Sie einen Wert in Secret value ein und speichern Sie. Ein neuer Wert ersetzt den
gespeicherten.
- Behalten – lassen Sie das Feld beim Bearbeiten eines bestehenden Services leer; das gespeicherte Geheimnis bleibt
erhalten (das Feld zeigt einen Platzhalter „leave blank to keep“).
- Entfernen – löschen Sie es mit Remove stored secret. Der Header wird dann ohne
Anmeldeinformation gesendet (oder gar nicht, wenn Sie auch den Header-Namen leeren).
Die Anmeldeinformation gehört in den Header, nicht in die URL
Hängen Sie Geheimnisse als Authentifizierungs-Header an, statt sie in die URL einzubetten. Der Header-Wert bleibt auf dem Server; ein Token in der URL kann leichter über Logs und Referrer durchsickern.
Verwandte Dokumentation
- Einen Assistenten bereitstellen – Schlüssel und Origins für den Assistenten selbst.