コンテンツにスキップ

インターフェースと操作 / Access Token

バージョン 7.5.0 で追加されました

Access Token はプログラムで使用できる認証方式です。Access Token を使用すると、プログラムから DataFlux Func へ簡単にアクセスできます。

Access Token 一覧

「管理 / Access Token」から Access Token 一覧を開けます。このページでは Access Token を管理できます。

access-token-list.png

ページ上部の検索ボックスで Access Token を絞り込んだり、【新規作成】をクリックして Access Token を作成したりできます。

一覧には、Access Token のタイトル、有効化されている機能、有効期限、状態、作成日時、所属ユーザーが表示されます。スーパー管理者はすべての Access Token を管理できますが、その他のユーザーは自分が作成した Access Token のみ管理できます。

【認証】をクリックすると、MCP サービスの転送方式、サービス URL、HTTP リクエストヘッダーを確認できます。リストでは、Access Token の有効化、無効化、設定、削除も行えます。

Access Token の設定

各 Access Token では、個別の機能を有効にするかどうかを設定でき、各機能の詳細設定も行えます。

Access Token を新規作成するときはタイトルの入力が必要で、作成後に変更することはできません。また、Access Token の有効期限を設定できます。API、MCP 関数、MCP プログラミングのアクセスルールは、手動で編集することも、対応する【API をクイック選択】、【MCP 関数をクイック選択】、【MCP プログラミング範囲をクイック選択】で設定することもできます。

アプリケーションは、HTTP リクエストヘッダーに X-Dff-Access-Token を追加することで認証できます:

Text Only
1
X-Dff-Access-Token: atk-xxxxx:xxxxx

access-token-setup.png

API アクセス

「API アクセス」機能を有効にすると、この Access Token を保持する HTTP リクエストが指定された API にアクセスできるようになります。

この機能ではルールリストを設定でき、システムは最初に一致したルールに基づいて、現在の API へのアクセスを許可するかどうかを判断します。

* を使用すると、任意の API にマッチさせることができます。

例:特定の API のみアクセスを許可
1
GET /api/v1/func/overview
例:特定の API へのアクセスを禁止し、その他はすべて許可
1
2
!GET /api/v1/func/overview
*

ルールに一致しない API はデフォルトで禁止

どのルールにも一致しない場合、デフォルトで禁止されます。

したがって、ルールの最後に「その他すべての API を禁止」のようなルールを追加する必要はありません

MCP 関数

「MCP 関数」機能を有効にすると、MCP クライアント / AI Agent はこの Access Token を使用して DataFlux Func 内の関数を呼び出すことができ、アクセスを許可する関数の範囲を設定できます。

参考ドキュメント

MCP 関数の導入方法と権限設定方法の詳細については、ドキュメント MCP サービス / MCP 関数 を参照してください。

MCP プログラミング

「MCP プログラミング」機能を有効にすると、MCP クライアント / AI Agent はこの Access Token を使用して DataFlux Func 内のスクリプトを作成・管理できるようになり、アクセスを許可する範囲とアクセスモードを設定できます。

参考ドキュメント

MCP プログラミングの導入方法と権限設定方法の詳細については、ドキュメント MCP サービス / MCP プログラミング を参照してください。