
Um servidor simples para hospedar os certificados válidos, revogados e expirados exigidos pela Seção 2.2 dos Requisitos Base do Fórum CA/Browser.
Este é um servidor web criado especificamente para hospedar as páginas de teste exigidas pelos Requisitos de Linha de Base do fórum CA/Browser. Eles contêm o seguinte requisito:
A CA DEVE hospedar páginas Web de teste que permitam aos Fornecedores de Software de Aplicação testar o seu software com Certificados de Assinante que encadeiem até cada Certificado Raiz publicamente confiável. No mínimo, a CA DEVE hospedar páginas Web separadas usando Certificados de Assinante que sejam válidos, revogados e expirados.
Utiliza o protocolo ACME para obter certificados. Serve um website simples com algumas informações a explicar para que serve o site de teste.
Embora tenha sido criado para a Let's Encrypt, deverá ser utilizável por outras CAs ACME.
Para mais informações, consulte a publicação no blog da Let's Encrypt.
Este é um programa Go autónomo.
go run main.go -config [path/to/config.json]
Consulte config/config.go para o esquema de configuração e config/testdata/test.json para um exemplo de uma configuração válida. A configuração do teste de integração é gerada em tempo de execução por integration/configgen.
Fornecemos um ficheiro docker-compose.yml para testes locais. Irá implementar automaticamente o Pebble, uma CA de teste. Execute:
docker compose up --build
Em seguida, aceda a um dos sites de teste.
Estão disponíveis em:
Estes URLs podem funcionar imediatamente, mas se não resolverem no seu sistema, pode fazer com que o curl os resolva:
curl -k --resolve revoked.localhost:5001:127.0.0.1 'https://revoked.localhost:5001/'
Se quiser aceder aos sites a partir do seu navegador, edite o seu ficheiro /etc/hosts para incluir os endereços dos certificados de teste.
127.0.0.1 valid.localhost revoked.localhost expired.localhost
Este software foi inspirado em vários incidentes que observámos noutras CAs, bem como na complexidade da nossa solução existente que utiliza ferramentas prontas a usar.
Algumas categorias de incidentes que observámos incluem:
Um servidor com integração ACME é a forma mais fiável de garantir que os certificados se mantêm atualizados, mas os requisitos invulgares de servir certificados revogados e expirados não são uma funcionalidade típica de outros sistemas. Os sistemas de monitorização também não costumam suportar garantir que os certificados sejam revogados ou expirados.
Atualmente, o test-certs-site apenas suporta o método de validação TLS-ALPN-01. Para cumprir este desafio, e para servir os sites de teste, este programa escuta numa porta configurável, que deve ser exposta como a porta TLS, :443.
Note que na configuração de teste escuta em :5001 por predefinição, o que corresponde à porta de validação predefinida do Pebble.
Atualmente, o test-certs-site armazena todo o material de chaves como caminhos no disco. Para facilitar a execução do cert-test-program em ambientes cloud ou efémeros, quereremos suportar algum mecanismo para persistir chaves em gestão de segredos.
Para além do armazenamento de chaves e certificados, este programa é sem estado.
Existe um listener de depuração configurável que expõe /debug/pprof e /metrics. Os registos são impressos em JSON para stderr.
Descubra as ferramentas mais usadas pela nossa comunidade.
Sem dados de popularidade ainda.