命名空间 (Namespaces)

Cloudflare Key Transparency API 组织在命名空间中，每一个命名空间代表一个由 Cloudflare Auditor 监控的 Log。如果你想要注册一个命名空间，请联系我们。

创建命名空间

发出 POST 请求时需要以下字段：

name
public
root
signature_version：
- 0x0001 用于来自 Auditor 的 Protobuf 序列化 ↗ Ed25519 签名
- 0x0002 用于来自 Auditor 的 bincode 序列化 ↗ E25519 序列化

log_directory 字段是可选的。如果设置了该字段，Cloudflare 将使用它来拉取审计证明并进行验证。

此 API 通过 mTLS ↗ 进行身份验证。

curl 'https://plexi.key-transparency.cloudflare.com/namespaces' \
        	--header 'Content-Type: application/json' \
        	--data '{
 	"name": "your.new.log.com",
 	"root": "1/1111111111111111111111111111111111111111111111111111111111111111",
 	"log_directory": "https://your.new.log.com/path/to/proofs",
 	"signature_version": 1
  }'
{
  "name": "your.new.log.com",
  "log_directory": "https://your.new.log.com/path/to/proofs",
  "root": "1/1111111111111111111111111111111111111111111111111111111111111111",
  "status": "Initialization",
  "reports_uri": "/namespaces/your.new.log.com/reports",
  "audits_uri": "/namespaces/your.new.log.com/audits",
  "signature_version": 1
}

发布第一个 Epoch 后，status 将显示为 Online。可能的状态包括：

Online
Initialization
Disabled

列出所有命名空间

参阅下面的示例以获取有关所有公共命名空间的信息。

curl 'https://plexi.key-transparency.cloudflare.com/namespaces'
{
   "namespaces": [
       { "name": "your.new.log.com", "root": "1/abc", "reports_uri": "/namespaces/your.new.log.com/reports", "audits_uri": "/namespaces/your.new.log.com/audits", "log_directory": "https://your.new.log.com/path/to/proofs", "status": "online" },
       { "name": "my.new.log.com", "reports_uri": "/namespaces/meta-bt-2024/reports", "audits_uri": "/namespaces/meta-bt-2024/audits", "status": "initialization" }
   ]
}

禁用命名空间

如果 Log 状态已被损坏、丢失或需要分片以保持可维护，Auditor 允许 Log 运营者将命名空间标记为 Disabled。

此 API 通过 mTLS ↗ 进行身份验证。

curl -X PATCH 'https://plexi.key-transparency.cloudflare.com/namespaces/{namespace}' \
        	-H 'Content-Type: application/json' \
        	-d '{
 	"status": "Disabled"
  }'
{
  "name": "your.new.log.com",
  "log_directory": "https://your.new.log.com/path/to/proofs",
  "root": "1/1111111111111111111111111111111111111111111111111111111111111111",
  "status": "Disabled",
  "reports_uri": "/namespaces/your.new.log.com/reports",
  "audits_uri": "/namespaces/your.new.log.com/audits",
  "signature_version": 1
}