
Простой сервер для размещения действительных, отозванных и просроченных сертификатов, требуемых Разделом 2.2 Базовых требований CA/Browser Forum.
Это специализированный веб-сервер для размещения тестовых страниц, требуемых Baseline Requirements форума CA/Browser. Они содержат следующее требование:
CA ДОЛЖЕН размещать тестовые веб-страницы, позволяющие поставщикам прикладного программного обеспечения тестировать своё ПО с помощью сертификатов подписчиков, цепочка которых восходит к каждому публично доверенному корневому сертификату. Как минимум, CA ДОЛЖЕН размещать отдельные веб-страницы с использованием сертификатов подписчиков, которые являются действительными, отозванными и истёкшими.
Он использует протокол ACME для получения сертификатов. Он обслуживает простой веб-сайт с информацией, объясняющей, для чего предназначен тестовый сайт.
Хотя он был создан для Let's Encrypt, он должен быть пригоден для использования другими ACME-удостоверяющими центрами.
Для получения дополнительной информации см. публикацию в блоге 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 —
тестовый удостоверяющий центр. Выполните:
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
Это программное обеспечение было вдохновлено несколькими инцидентами, которые мы наблюдали у других удостоверяющих центров, а также сложностью нашего существующего решения на основе готовых инструментов.
Некоторые категории наблюдавшихся нами инцидентов включают:
Сервер с интеграцией ACME — наиболее надёжный способ обеспечить актуальность сертификатов, но необычные требования по обслуживанию отозванных и истёкших сертификатов не являются типичной функцией других систем. Системы мониторинга также обычно не поддерживают проверку того, что сертификаты отозваны или истекли.
В настоящее время test-certs-site поддерживает только метод валидации TLS-ALPN-01. Для выполнения этой задачи и обслуживания тестовых сайтов эта программа прослушивает настраиваемый порт, который должен быть открыт как TLS-порт :443.
Обратите внимание, что в тестовой конфигурации по умолчанию используется порт :5001, что соответствует порту валидации по умолчанию Pebble.
В настоящее время test-certs-site хранит весь ключевой материал в виде путей на диске. Чтобы упростить запуск cert-test-program в облачных или эфемерных средах, нам потребуется поддержка некоторого механизма сохранения ключей в системе управления секретами.
Помимо хранения ключей и сертификатов, эта программа не хранит состояния.
Имеется настраиваемый отладочный слушатель, который предоставляет /debug/pprof и /metrics. Журналы выводятся в формате JSON в stderr.