メインコンテンツにスキップ

認証トークンと API トークンの作成

外部システムとFinを統合するための認証およびAPIトークンの設定方法。

外部システム(例:Stripe)とFinを統合するには、Finワークスペースで認証トークンを設定し、正しく構成されていることを確認する必要があります。以下は詳細な手順です👇


Finで認証トークンを作成する

  1. 設定 > 認証 に移動します。

  2. New token をクリックします。

  3. トークンの項目に次の値を入力します:

    1. token title を入力します。

    2. 説明を入力します。

    3. タイプを選択します(例:Text、HTTP request、user)。

    4. トークンの値の欄にAPIキーを入力します。これはテスト用のシークレットキー(例:sk_test_...)または本番用キー(例:sk_live_...)のいずれかです。

    5. トークンのプレフィックスを Bearer に設定します。

    6. リクエストヘッダーのキーを Authorization に設定します。

この手順を完了すると、リクエストで送信されるときに次の形式に従う認可トークンが作成されます。例えば:

Authorization: Bearer <your_stripe_api_key>

データコネクタでトークンを構成する

  1. 設定 > Data connectors に移動します。

  2. 既存のデータコネクタを選択するか、新しいものを作成します。

  3. 認証トークンを選択できるセクションを探します。

  4. 先ほどFinで作成したトークンを選択します。

  5. 設定を保存または確認して統合を完了します。

これでAPIキーはFinサポートに正常にリンクされます。この設定により、外部システムとFin間の通信がシームレスかつ安全になり、Fin内で外部データに直接アクセスできるようになります。


複数トークンのサポート

複数のトークンを単一のData connectorに添付できます。添付される各トークンはunique header key(例:AuthorizationX-API-Key)で構成する必要があります。添付されたすべてのトークンはリクエストと共に送信されます。

この設定により、そのトークンを使用してData connectorをトリガーできます — WorkflowsまたはFinを通じて。トークン値が更新されてもData connectorは動作し続け、認証が途切れないようリアルタイムで更新されます。

Data connectorでユーザーごとのJWTを使用するには、’User’認証トークンを作成し、その現在の値をMessengerのintercom_user_jwtに頼るのではなく、auth_tokens(例:Intercom('setAuthTokens'))経由で提供してください。


FinでAPIトークンを作成する(OAuthトークン)

APIトークンは、個々のチームメンバーがFinのデータにAPI経由でアクセスできるように作成できます。

  1. 設定 > Personal > API tokens に移動します。

  2. Create API token. をクリックします。

  3. APIトークンのnameを入力し、Create. をクリックします。

OAuthトークンを使用してFin APIに対して認証することができます。例:

GET https://api.intercom.io/conversations/123
Authorization: Bearer <your_oauth_token>

Note:

  • これらのトークンは、App Packagesを通じて作成されたトークンと同様に機能します。Finはワークスペース用にプライベートなApp Packageを自動的に作成します。

  • PersonalセクションのCreate API tokenボタンは、Fin for Platforms(Standalone)ワークスペースでのみサポートされています。Intercom Suiteでは、APIアクセスは代わりにアプリ統合接続を介して管理されます。

こちらの回答で解決しましたか?