跳轉至

界面和操作 / 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 編程