这是一个专门构建的 Web 服务器,用于托管 CA/Browser 论坛基线要求(Baseline Requirements)所要求的测试页面。这些要求包含以下规定:
CA 应托管测试 Web 页面,允许应用程序软件供应商使用能够链至每个公开信任根证书的订阅者证书(Subscriber Certificates)来测试其软件。至少,CA 应使用有效、已吊销和已过期的订阅者证书托管独立的 Web 页面。
它使用 ACME 协议获取证书。它提供一个简单的网站,其中包含一些说明测试站点用途的信息。
虽然它是为 Let's Encrypt 构建的,但也应可供其他 ACME CA 使用。
更多信息,请参阅 Let's Encrypt 博客文章。
这是一个独立的 Go 程序。
go run main.go -config [path/to/config.json]
配置模式请参阅 config/config.go,有效配置示例请参阅
config/testdata/test.json。集成测试配置在运行时由 integration/configgen 生成。
我们提供了一个 docker-compose.yml 文件用于本地测试。它会自动部署
Pebble,一个测试 CA。执行:
docker compose up --build
然后,访问其中一个测试站点。
它们可通过以下地址访问:
这些 URL 可能立即可用,但如果它们在你的系统上无法解析,你可以让 curl 解析它们:
curl -k --resolve revoked.localhost:5001:127.0.0.1 'https://revoked.localhost:5001/'
如果你想从浏览器访问这些站点,请编辑你的 /etc/hosts 文件,加入测试证书地址。
127.0.0.1 valid.localhost revoked.localhost expired.localhost
本软件的灵感来源于我们从其他 CA 观察到的一些事故,以及我们现有使用现成工具的解决方案的复杂性。
我们观察到的一些事故类别包括:
具有 ACME 集成的服务器是确保证书保持最新的最可靠方式,但提供已吊销和已过期证书的特殊需求并非其他系统的典型功能。监控系统通常也不支持确保证书已被吊销或已过期。
目前,test-certs-site 仅支持 TLS-ALPN-01 验证方法。 为完成此挑战并提供测试站点,本程序监听一个可配置端口,该端口应作为 TLS 端口 :443 暴露。
请注意,在测试配置中默认监听 :5001,这与 Pebble 的默认验证端口一致。
目前,test-certs-site 将所有密钥材料存储为磁盘上的路径。 为了便于在云或临时环境中运行 cert-test-program,我们希望支持某种将密钥持久化到密钥管理系统的机制。
除密钥和证书存储外,本程序是无状态的。
有一个可配置的调试监听器,暴露 /debug/pprof 和 /metrics。 日志以 JSON 格式打印到 stderr。