
Un serveur simple pour héberger les certificats valides, révoqués et expirés requis par la Section 2.2 des Baseline Requirements du CA/Browser Forum.
Il s'agit d'un serveur web conçu spécifiquement pour héberger les pages de test requises par les Exigences de Base du forum CA/Browser. Elles contiennent l'exigence suivante :
L'AC DOIT héberger des pages Web de test qui permettent aux Fournisseurs de Logiciels Applicatifs de tester leur logiciel avec des Certificats d'Abonné qui remontent à chaque Certificat Racine publiquement approuvé. Au minimum, l'AC DOIT héberger des pages Web distinctes utilisant des Certificats d'Abonné qui sont valides, révoqués et expirés.
Il utilise le protocole ACME pour obtenir des certificats. Il sert un site web simple avec quelques informations expliquant à quoi sert le site de test.
Bien qu'il ait été conçu pour Let's Encrypt, il devrait être utilisable par d'autres AC ACME.
Pour plus d'informations, consultez le billet de blog de Let's Encrypt.
Il s'agit d'un programme Go autonome.
go run main.go -config [path/to/config.json]
Consultez config/config.go pour le schéma de configuration et
config/testdata/test.json pour un exemple de configuration valide. La
configuration du test d'intégration est générée à l'exécution par integration/configgen.
Nous fournissons un fichier docker-compose.yml pour les tests locaux. Il déploiera automatiquement
Pebble, une AC de test. Exécutez :
docker compose up --build
Ensuite, accédez à l'un des sites de test.
Ils sont disponibles sur :
Ces URL peuvent fonctionner immédiatement, mais si elles ne se résolvent pas sur votre système, vous pouvez demander à curl de les résoudre :
curl -k --resolve revoked.localhost:5001:127.0.0.1 'https://revoked.localhost:5001/'
Si vous souhaitez accéder aux sites depuis votre navigateur, modifiez votre fichier /etc/hosts pour
y inclure les adresses des certificats de test.
127.0.0.1 valid.localhost revoked.localhost expired.localhost
Ce logiciel a été inspiré par plusieurs incidents que nous avons observés chez d'autres AC, ainsi que par la complexité de notre solution existante utilisant des outils standards.
Voici quelques catégories d'incidents que nous avons observés :
Un serveur avec intégration ACME est le moyen le plus fiable de garantir que les certificats restent à jour, mais les exigences inhabituelles de servir des certificats révoqués et expirés ne sont pas une fonctionnalité typique des autres systèmes. Les systèmes de surveillance ne prennent généralement pas non plus en charge la vérification que les certificats sont révoqués ou expirés.
Actuellement, test-certs-site ne prend en charge que la méthode de validation TLS-ALPN-01. Pour relever ce défi, et pour servir les sites de test, ce programme écoute sur un port configurable, qui doit être exposé comme port TLS, :443.
Notez que dans la configuration de test, il écoute sur :5001 par défaut, ce qui correspond au port de validation par défaut de Pebble.
Actuellement, test-certs-site stocke tout le matériel de clé sous forme de chemins sur disque. Pour faciliter l'exécution de cert-test-program dans des environnements cloud ou éphémères, nous souhaiterons prendre en charge un mécanisme de persistance des clés vers la gestion des secrets.
Outre le stockage des clés et des certificats, ce programme est sans état.
Il existe un écouteur de débogage configurable qui expose /debug/pprof et /metrics. Les journaux sont imprimés en JSON sur stderr.