Um Fin mit externen Systemen (z. B. Stripe) zu integrieren, müssen Sie ein Authentifizierungs-Token in Ihrem Fin-Arbeitsbereich erstellen 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 im 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 in Anfragen dieses Format hat. Zum Beispiel:
Authorization: Bearer <your_stripe_api_key>
Konfigurieren Sie das Token im Data Connector
Navigieren Sie zu Einstellungen > Data connectors.
Wählen Sie einen vorhandenen Data connector 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 stellt eine nahtlose, sichere Kommunikation zwischen externen Systemen und Fin sicher und ermöglicht Ihnen den direkten Zugriff auf externe Daten innerhalb Ihrer Fin workflows.
Mehrfach-Token-Unterstützung
Sie können mehreren Tokens einen einzelnen Data connector zuordnen. Jedes angehängte Token muss mit einem eindeutigen 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, Data connectors mit diesem Token auszulösen – entweder über Workflows oder Fin. Der Data connector funktioniert weiter, selbst wenn der Token-Wert aktualisiert wird, da er in Echtzeit aktualisiert wird, um eine unterbrechungsfreie Authentifizierung zu gewährleisten.
Um ein pro‑Benutzer-JWT mit einem Data connector zu verwenden, erstellen Sie ein „User“-Authentifizierungs-Token und übergeben Sie 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-Tokens)
API-Tokens können von einzelnen Teammitgliedern erstellt werden, damit externe Apps über die API auf Fin-Daten zugreifen können.
Gehen Sie zu Einstellungen > Persönlich > API tokens.
Klicken Sie auf Create API token.
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 auf die gleiche Weise wie Tokens, die über App Packages erstellt wurden. Fin erstellt automatisch ein privates App Package für Ihren Arbeitsbereich.
Die Schaltfläche "Create API token" im Bereich Persönlich wird nur in Fin for Platforms (Standalone)-Arbeitsbereichen unterstützt. Auf Intercom Suite wird der API-Zugriff stattdessen über App-Integrationsverbindungen verwaltet.