Verbindungen & Authentifizierung

Eine Verbindung ist ein gespeicherter Satz von Zugangsdaten für eine Drittanbieter-App, zugeordnet zu Ihrer Organisation. Jede Zugangsdaten wird im Ruhezustand verschlüsselt und nur im Arbeitsspeicher entschlüsselt, um einen echten API-Aufruf zu tätigen – Einzelheiten siehe Sicherheit. Workflow-Schritte referenzieren eine Verbindung, nicht die rohen Zugangsdaten.

Authentifizierungstypen

Jeder Connector verwendet einen von vier Authentifizierungstypen, passend zu dem, was der jeweilige Anbieter tatsächlich erfordert:

• API-Schlüssel (die meisten Connectoren) — ein oder wenige direkt eingegebene Felder, z. B. ein API-Token oder ein Schlüssel-/Geheimnis-Paar. Wird sofort gespeichert und validiert.
• OAuth2 (Google Sheets, Slack, LinkedIn, X, Instagram) — Sie werden zum Anbieter weitergeleitet, um sich anzumelden und zu autorisieren; Gate97 sieht Ihr Passwort niemals.
• Basic (WordPress) — ein Benutzername und Passwort (bei WordPress speziell ein Anwendungspasswort statt Ihres echten).
• Keine (der manuelle Trigger) — nichts zu verbinden; dient ausschließlich dazu, einen Workflow bei Bedarf über das Dashboard zu starten.

OAuth-Apps sind organisationsspezifisch

Für die fünf OAuth2-Connectoren bringt Ihre Organisation ihre eigene registrierte OAuth-App mit, statt eine zu teilen, die Gate97 bei jedem Anbieter registriert. Gehen Sie vor dem Verbinden zur Karte dieses Connectors auf der Seite Verbindungen und wählen Sie OAuth-App einrichten — Sie benötigen eine Client-ID und ein Client-Secret aus der Entwicklerkonsole des Anbieters, und die Seite zeigt Ihnen die genaue dort zu registrierende Callback-URL. Solange keine OAuth-App konfiguriert ist, wird die Schaltfläche Verbinden dieses Connectors durch die Einrichtungsaufforderung ersetzt.

Verbindungsstatus

Eine Verbindung kann aktiv sein oder als Reautorisierung erforderlich markiert werden. Sie wechselt automatisch in den Status „Reautorisierung erforderlich“, sobald eine echte Trigger-Abfrage oder ein Aktionsaufruf mit einem Authentifizierungsfehler fehlschlägt – ein abgelaufenes OAuth-Token, ein widerrufener API-Schlüssel usw. Verbinden Sie sie mit neuen Zugangsdaten über die Seite Verbindungen neu, um die Markierung zu entfernen; an den Workflows, die sie verwenden, wird währenddessen nichts gelöscht.

Verbindungen verwalten

Jede Verbindung kann umbenannt (um zwei Verbindungen zur selben App zu unterscheiden) oder von der Seite Verbindungen gelöscht werden. Eine von einem Workflow-Schritt referenzierte Verbindung funktioniert weiter, bis Sie sie ändern oder entfernen. Das Löschen einer noch genutzten Verbindung leert die Verbindung dieses Schritts, statt den Schritt selbst zu löschen — sein nächster Durchlauf schlägt mit einem klaren Fehler „Schritt hat keine Verbindung konfiguriert“ fehl, bis Sie ihm eine neue Verbindung zuweisen.