用途:该技能用于检查 1Panel 面板中的 SSL 证书,并在已有 ACME 与 DNS 配置的前提下申请签发指定证书,适用于证书盘点以及经明确授权的签发操作。
主要能力:可通过 list_ssls(参数为 {})列出证书,并查看返回的实际域名与到期字段,未知信息保持未知。经授权后可执行 create_ssl 申请证书。
使用方式:先阅读操作契约。执行 create_ssl 前需确认确切域名、DNS 控制权及提供方(http 或 dnsAccount)。必须已有 ACME 账户,上游会选用其返回的第一个账户且不提供账户选择,用户需在面板中核验该账户;若该选择存在歧义或不可接受,应停止操作。DNS 签发需要已有确认的 DNS 账户 ID 或确切名称(dns_account_id/dnsAccount),不得猜测;HTTP 挑战需要实际的路由与端口前提。MCP 不支持创建 ACME/DNS 账户。提交一次后应重新列出以核对证书身份与签发状态;任务被接受或证书处于 pending 并不等于 TLS 已生效。
限制:绑定、续期与外部 TLS 检查属于单独的不支持或需明确授权的操作。切勿泄露私钥,遵守 ACME 速率限制,结果未知时须先核对再发起新请求。创建 ACME/DNS 账户不受支持。