跳轉到

介面和操作 / 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 程式設計