SuperAPI AI 工具集

managing-api-tokens

编程与开发

查看项目

更新于 10-15 17:32

技能介绍

用途:API 令牌(accesstoken 资源,UI 显示为 API tokens)是 bearer 凭证,用于认证外部程序化调用进入 Celigo,包括原生 integrator.io REST API、账户内自定义 API 及 MCP 服务器。方向为入站,与认证 Celigo 对外调用的连接 OAuth 令牌相反。管理令牌是所有者/管理员能力。

主要能力:区分个人访问令牌(PAT,绑定用户,继承其权限,默认 90 天过期)与账户 API 令牌(所有者/管理员创建,支持 fullAccess 或按资源 ID 最小权限范围)。范围字段包括 fullAccess 及 _connectionIds、_exportIds、_importIds、_apiIds、_mcpServerIds,两者互斥。支持生成、撤销、删除(须先撤销,删除为软删除,30 天后清除)、设置 autoPurgeAt 自动过期(账户令牌 30 天内,PAT 最多 90 天)。

使用方式:通过 Celigo CLI 管理,如 celigo accesstokens list、get <id>、create < token.json、update <id> < token.json、delete <id>,并可用 celigo account search "<resource-name>" 将资源名解析为 ID。也可通过 UI 或 REST API(/v1/accesstokens)操作。令牌值仅在生成时完整显示一次,之后掩码为 ******,需立即存入密钥库;每个消费者应使用独立令牌。

适用场景:CI/CD 流水线、监控告警、调用自定义 API 与 MCP 服务器、Postman 或脚本临时访问等机器对机器认证。

限制:API 令牌为入站认证,不要与连接出站 OAuth 令牌混淆;fullAccess 与范围数组不可同时设置;APIM 令牌(apim: true)不可删除;自动管理令牌(连接器集成令牌、APIM 令牌)由平台创建,不应手工制作。绝不回显真实令牌,泄露即撤销并更换。具体收费与价格暂未提供。