CERTBOTX / HUMAN + AGENT

人类在控制台，Agent 在 API。

两类客户共享组织、套餐、额度、域名、证书、部署目标和审计日志。Agent 拥有独立身份与细粒度权限，人类继续使用熟悉的网页流程。

打开机器版完整教程 创建 Agent 客户身份
独立客户身份Secret 一次展示，Token 15 分钟
细粒度权限域名、证书、部署分别授权
最终状态可验证API 状态 + 公网 TLS 双确认
STATE MACHINE

标准工作流

每一步都有继续条件；条件不满足就停止并报告，而不是无限重试。

  1. 01

    创建 Agent 客户身份

    人类在账号与安全中创建独立身份，按域名、证书、部署等业务范围分配最小权限。

  2. 02

    换取短期 Token

    Agent 使用 client_credentials 换取 15 分钟 access_token，再读取概览和现有资产。

  3. 03

    添加域名并交接 DNS

    添加域名会自动生成 CNAME。没有单独 DNS 授权时，Agent 必须停下来请人类配置。

  4. 04

    验证并申请证书

    委托 verified 后创建 ACME 订单，使用稳定幂等键并轮询到 issued 或 failed。

  5. 05

    开启托管并部署

    证书 active 后开启自动托管，只选择人类已经验证过的部署目标。

  6. 06

    用公网结果收尾

    部署运行 success 之后再检查公网 TLS；两边均匹配才向用户报告完成。

AUTHORIZATION

人类与 Agent 的边界

人类客户
登录控制台，购买套餐，管理团队与 Agent 身份，处理退款和账号安全；也可继续使用旧 API Key。
Agent 客户
以独立 client_id 换取短期 Token，读取状态、提交幂等请求、轮询异步任务，并在终态后验证公网结果。
API MAP

一条主链路

POST /auth/agent/token↓GET /customer/overview↓POST /customer/domains↓POST /customer/dns/delegations/:id/verify↓POST /customer/acme/orders↓POST /customer/deployment-targets/:id/deploy↓POST /public/tools/tls-check
MACHINE READABLE

让 Agent 直接读完整协议

Markdown 教程、llms.txt 和 Agent Card 共同声明认证方式、scope、端点、人工接管边界与错误处理规则。

/ai-agent-guide.md /llms.txt /.well-known/agent-card.json
使用说明

如何使用

  1. 由人类用户创建独立 Agent 身份并配置业务权限。
  2. 使用短期 Token 读取资产，完成域名添加与 DNS 委托验证。
  3. 申请证书、部署到已授权目标，并用部署结果和公网检测确认完成。

如何理解结果

AI Agent 接入与服务器部署 Agent 是不同用途。支付、账户安全和凭据管理由人类处理；没有单独授权时，不应自动修改 DNS 或部署目标。

继续了解