
CA/Browser Forum Baseline RequirementsのSection 2.2で要求される、有効、失効、および期限切れの証明書をホストするためのシンプルなサーバー。
これは、CA/Browser Forum の Baseline Requirements で要求されるテストページをホストするために専用に構築されたウェブサーバーです。これらの要件には以下が含まれます:
CA は、Application Software Suppliers が、各公開信頼ルート証明書にチェーンするサブスクライバ証明書を用いて自社ソフトウェアをテストできるようにするテスト Web ページをホストしなければならない (SHALL)。少なくとも、CA は有効、失効、および期限切れのサブスクライバ証明書を使用した個別の Web ページをホストしなければならない (SHALL)。
証明書の取得には 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 ファイルを提供しています。テスト用 CA である Pebble を自動的にデプロイします。次を実行してください:
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 に出力されます。