Навигация
clmBot — это легковесный клиент, развертываемый на вашем внутреннем сервере и предназначенный для автоматического развертывания и обновления SSL-сертификатов: он получает актуальные сертификаты из облака, записывает их в точки установки сертификатов на сервере и выполняет скрипты согласно конфигурации для перезагрузки служб промежуточного ПО.
Принцип работы
Процесс обновления сертификатов clmBot выглядит следующим образом:
- До истечения срока действия сертификата облако автоматически перевыпускает сертификат и создает новый.
- clmBot получает актуальный сертификат через облачный push-канал или периодическое извлечение.
- clmBot пытается создать резервную копию и заменить локальные файлы сертификатов на сервере; ошибка резервного копирования регистрируется, но не препятствует дальнейшему обновлению.
- clmBot выполняет скрипт перезагрузки в соответствии с конфигурацией (
after_script); вступит ли изменение в силу, зависит от результата выполнения скрипта и состояния промежуточного ПО.
Весь процесс не требует ручного входа на сервер для замены сертификата и не открывает внешним сторонам доступ к административному интерфейсу сервера.
Поддерживаемые способы обновления
clmBot поддерживает два способа обновления сертификатов, которые можно выбирать независимо на разных серверах:
| Способ обновления | Режим работы | Требования к портам | Подходящие сценарии |
|---|---|---|---|
| Облачный push | В административной панели инициируется push, серверная часть clmBot на сервере принимает и обновляет сертификат | Требуется открыть входящий порт 8862/tcp | Сетевая политика допускает открытие входящих портов, требуется немедленное вступление обновления в силу |
| Периодическое извлечение | Через crontab или планировщик Windows периодически запускается clmBot, проверяет и извлекает актуальный сертификат | Открывать входящий порт не требуется, нужен только исходящий доступ к облаку | Серверы, на которых невозможно открыть входящий порт (рекомендуемый способ по умолчанию) |
Подробные инструкции по настройке см. в разделе Способы обновления сертификатов.
Поддерживаемые платформы и промежуточное ПО
Поддерживаемые операционные системы:
- Linux (amd64, arm64)
- macOS (amd64, arm64)
- Windows (amd64; для старых версий Windows используется legacy-пакет совместимости)
Поддерживаемое промежуточное ПО и форматы сертификатов:
| Промежуточное ПО | Формат сертификата | Описание |
|---|---|---|
| nginx | PEM | Раздельное развертывание сертификата, цепочки CA и закрытого ключа |
| Apache HTTP Server | PEM | Раздельное развертывание сертификата, цепочки CA и закрытого ключа |
| Tomcat | PEM / JKS | Поддержка PEM-сертификата или JKS keystore |
| IIS | IIS | Импорт PFX встроенным скриптом и обновление привязок сайтов, требуются права администратора |
| Exchange | Exchange | Поддерживается только обновление; обнаружение, запросы и sync-server не поддерживаются, требуются права администратора |
| Другое (пользовательский скрипт) | PFX и др. | Поддержка любых сценариев через пользовательский after_script |
Как выбрать документацию
| Сценарий использования | Рекомендуемая страница |
|---|---|
| Первое использование, требуется быстрое развертывание и выполнение одного обновления сертификата | Быстрый старт |
| Изучение подробной настройки двух способов обновления | Способы обновления сертификатов |
| Ручное добавление точки установки, синхронизация точки установки из административной панели, использование локальной веб-страницы конфигурации | Управление точками установки |
| Просмотр значений полей в config.yaml и переменных шаблона скрипта | Справочник по конфигурации |
| Просмотр полных примеров установки и перезагрузки сертификатов для nginx, Apache, Tomcat и других промежуточных серверов | Примеры конфигурации |
| Ограничение прав запуска clmBot в производственной среде, настройка sudoers | Требования к правам запуска |
| Регистрация clmBot как системной службы, обновление версии, просмотр журналов | Развёртывание как службы и обновление |
Быстрый старт
Если вы впервые используете clmBot, рекомендуется действовать по следующему пути:
- Создайте AccessKey / AccessSecret в панели администратора.
- Скачайте clmBot и загрузите его на сервер.
- Выполните
loginдля завершения подключения и активируйте узел в панели. - Выполните
discover-certificateдля автоматического обнаружения сертификатов на сервере. - Настройте способ обновления (push или периодическое получение по расписанию).
Полные шаги см. в разделе Быстрый старт.