Um Fin mit externen Systemen (z. B. Stripe) zu integrieren, müssen Sie in Ihrem Fin-Arbeitsbereich ein Authentifizierungs-Token einrichten und sicherstellen, dass es korrekt konfiguriert ist. Nachfolgend finden Sie die detaillierten Schritte 👇
Erstellen Sie ein Authentifizierungs-Token in Fin
Navigieren Sie zu Einstellungen > Authentifizierung.
Klicken Sie auf Neues Token.
Füllen Sie die Token-Felder mit den folgenden Werten aus:
Geben Sie einen Token-Titel ein.
Geben Sie eine Beschreibung ein.
Wählen Sie einen Typ, z. B. Text, HTTP-Anfrage, Benutzer.
Geben Sie unter dem Token-Wert Ihren API-Schlüssel ein. Dies ist entweder Ihr geheimer Testschlüssel (z. B.
sk_test_...) oder Ihr Live-Schlüssel (z. B.sk_live_...).Setzen Sie das Token-Präfix auf Bearer.
Setzen Sie den Schlüssel für den Anforderungsheader auf Authorization.
Nach Abschluss dieses Schritts haben Sie ein Autorisierungstoken erstellt, das beim Senden von Anfragen folgendes Format hat. Zum Beispiel:
Authorization: Bearer <your_stripe_api_key>
Konfigurieren Sie das Token im Datenconnector
Navigieren Sie zu Einstellungen > Datenconnectoren.
Wählen Sie einen vorhandenen Datenconnector aus oder erstellen Sie einen neuen.
Suchen Sie den Abschnitt, in dem Sie ein Authentifizierungs-Token auswählen können.
Wählen Sie das Token aus, das Sie gerade in Fin erstellt haben.
Speichern oder bestätigen Sie die Einstellungen, um die Integration abzuschließen.
An diesem Punkt ist Ihr API-Schlüssel erfolgreich mit Ihrem Fin-Support verknüpft. Diese Einrichtung gewährleistet eine nahtlose, sichere Kommunikation zwischen externen Systemen und Fin, sodass Sie externe Daten direkt in Ihren Fin workflows abrufen können.
Multi-Token-Unterstützung
Sie können mehrere Tokens an einen einzelnen Datenconnector anhängen. Jedes angehängte Token muss mit einem einzigartigen Header-Schlüssel konfiguriert sein (z. B. Authorization, X-API-Key). Alle angehängten Tokens werden mit der Anfrage gesendet.
Diese Einrichtung ermöglicht es Ihnen, Datenconnectoren mit diesem Token auszulösen – entweder über Workflows oder Fin. Der Datenconnector funktioniert weiterhin, auch wenn der Token-Wert aktualisiert wird, da er in Echtzeit aktualisiert wird, um eine unterbrechungsfreie Authentifizierung zu gewährleisten.
Um ein benutzerspezifisches JWT mit einem Datenconnector zu verwenden, erstellen Sie ein ‚User‘-Authentifizierungs-Token und übergeben dessen aktuellen Wert über auth_tokens (z. B. Intercom('setAuthTokens')), anstatt sich auf das Messenger intercom_user_jwt zu verlassen.
Erstellen Sie ein API-Token in Fin (OAuth-Token)
API-Token können von einzelnen Teammitgliedern erstellt werden, um externen Apps den Zugriff auf Fin-Daten über die API zu ermöglichen.
Gehen Sie zu Einstellungen > Persönlich > API-Token.
Klicken Sie auf API-Token erstellen.
Geben Sie einen Namen für Ihr API-Token ein und klicken Sie auf Erstellen.
Sie können Ihr OAuth-Token verwenden, um sich bei der Fin API zu authentifizieren, zum Beispiel:
GET https://api.intercom.io/conversations/123
Authorization: Bearer <your_oauth_token>
Hinweis: Diese Tokens funktionieren genauso wie Tokens, die über App Packages erstellt wurden. Fin erstellt automatisch ein privates App Package für Ihren Arbeitsbereich.