
CA/Browser Forum Baseline Requirements의 섹션 2.2에서 요구하는 유효, 폐기, 만료된 인증서를 호스팅하는 간단한 서버입니다.
이것은 CA/브라우저 포럼 기본 요구사항(Baseline Requirements)에서 요구하는 테스트 페이지를 호스팅하기 위해 특별히 제작된 웹서버입니다. 해당 요구사항에는 다음 내용이 포함되어 있습니다:
CA는 애플리케이션 소프트웨어 공급자가 각각의 공개적으로 신뢰되는 루트 인증서에 체인되는 구독자 인증서(Subscriber Certificate)로 자신의 소프트웨어를 테스트할 수 있도록 테스트 웹 페이지를 호스팅해야 합니다(SHALL). 최소한 CA는 유효한, 폐기된, 만료된 구독자 인증서를 사용하는 별도의 웹 페이지를 호스팅해야 합니다(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을 쉽게 실행할 수 있도록, 키를 시크릿 관리에 영구 저장하는 메커니즘을 지원할 예정입니다.
키 및 인증서 저장 외에 이 프로그램은 상태를 유지하지 않습니다(stateless).
/debug/pprof와 /metrics를 노출하는 구성 가능한 디버그 리스너가 있습니다. 로그는 JSON 형식으로 stderr에 출력됩니다.