АРХИВА 26 Help

Сертификаты

АРХИВА управляет цифровыми сертификатами и ключами X.509. Они защищают STARTTLS/SSL-соединения веб-консоли (HTTPS), слушающие порты SMTP-слушателей и исходящие подключения (SMTP/IMAP/POP), а также используются для взаимной аутентификации. Защиту консоли настраивайте обязательно: без HTTPS главный пароль администратора уязвим к подбору.

Раздел — Конфигурация → Сертификаты.

cfg_certificates.png

Бесплатный сертификат Let's Encrypt

Для веб-консоли можно получить бесплатный сертификат Let's Encrypt — его принимают все современные браузеры. Let's Encrypt должен подтвердить, что домен ваш. Методы подтверждения:

  • HTTP — Let's Encrypt проверяет HTTP-запрос к АРХИВА на порту 80 из внешней сети. Пока доступ сохранён, система может запрашивать и обновлять сертификат автоматически.

  • DNS — Let's Encrypt проверяет TXT-запись в DNS домена. Сертификаты живут три месяца, и каждый раз править DNS-записи неудобно.

Адрес ACME-сервера (по умолчанию Let's Encrypt) меняется в разделе — для других ACME-провайдеров.

Метод HTTP

Сервер АРХИВА должен быть доступен по HTTP (порт 80) из внешней сети:

  1. Переключите АРХИВА на порт 80 в server.xml:

    /var/opt/archiva/tomcat/conf/server.xml

    C:\ProgramData\Archiva\Tomcat\conf\server.xml

    Замените <Connector port="8090" ... на port="80" и перезапустите АРХИВА.

  2. Разрешите внешний доступ к IP АРХИВА на брандмауэре.

  3. Пробросьте порты 80 и 443 с внешнего адреса на сервер АРХИВА.

  4. Создайте A-запись домена на IP сервера (например, archiva.company.ru).

  5. Убедитесь, что http://archiva.company.ru открывается извне.

  6. В Конфигурация → Сертификаты нажмите «Получить сертификат Let's Encrypt», метод проверки — HTTP.

    Получение сертификата
  7. Укажите алиас хранилища (рекомендуется tomcat) и домен сервера — FQDN из шага 4.

  8. Нажмите «Получить бесплатный сертификат».

  9. Обновите страницу раздела и проверьте установленный сертификат.

  10. С алиасом tomcat хранилище получит имя letsencrypt.org-server-tomcat — укажите его в server.xml при настройке HTTPS.

    /var/opt/archiva/tomcat/logs/catalina.out

    C:\ProgramData\Archiva\Tomcat\logs\catalina.out

    {collapsible="true" collapsed-title="server.xml"}

Метод DNS

  1. Нажмите «Получить сертификат Let's Encrypt», метод проверки — DNS.

  2. Укажите алиас хранилища (например, tomcat) и домен сервера.

  3. Нажмите «Получить бесплатный сертификат».

  4. В окне процесса появятся данные DNS-записи:

    Создайте запись вида TXT _acme-challenge.company.ru. OJ_D9JF-3ctIsL1c8FLgHU-xmgyv62eJFTqcY0zXC3Q

    Запрос сохраняется и в файл dns_challenge.txt.

  5. Добавьте TXT-запись в DNS домена: ключ _acme-challenge.company.ru., значение из окна.

  6. Нажмите «Получить бесплатный сертификат».

  7. Обновите страницу раздела и проверьте сертификат.

  8. С алиасом tomcat хранилище получит имя letsencrypt.org-server-tomcat — укажите его в server.xml при настройке HTTPS.

Ручной выпуск сертификата через ЦС

Можно получить сертификат у стороннего центра сертификации (ЦС) через стандартный запрос CSR.

1. Создание запроса (CSR)

  1. В разделе нажмите «Новый сертификат».

    Запрос сертификата
  2. Заполните алиас хранилища (произвольное имя-ссылка на сертификат; для HTTPS — tomcat), общее имя и данные организации.

  3. Нажмите «Создать запрос сертификата».

  4. Скопируйте запрос в буфер обмена и закройте диалог.

  5. Запись появится в таблице «Серверные сертификаты».

2. Получение сертификатов у ЦС

Обратитесь к любому доверенному ЦС за сертификатом сервера и сертификатами ЦС (альтернативы — бесплатный cacert.org или самоподписанный сертификат через тот же CSR). Сохраните файлы: сертификат сервера — server.cert, промежуточный — intermediate.cert, корневой — root.cert.

3. Импорт сертификатов

АРХИВА импортирует сертификаты в форматах PKCS#12 (*.p12, *.pfx), PKCS#7 (*.p7b), JKS (*.jks), PEM (*.pem) и DER (*.cert). Пример — импорт DER.

  1. «Импорт CA сертификата» → файл root.cert, формат DER, алиас root → «Импортировать».

    Импорт CA сертификата
  2. Тем же диалогом импортируйте intermediate.cert с алиасом intermediatecert (для нескольких промежуточных — intermediate2, intermediate3, …).

  3. «Импорт серверного сертификата» → server.cert, формат DER, тот же алиас, что при создании CSR (например, tomcat).

    Импорт серверного сертификата
  4. Сохраните изменения, чтобы применить их к хранилищу ключей.

Секрет хранилища ключей

Закрытые ключи и сертификаты лежат в хранилище ключей Java (JKS) — защищённом файле mailarchivacerts:

/etc/opt/archiva/ROOT/mailarchivacerts

C:\ProgramData\Archiva\ROOT\conf\mailarchivacerts

Особенности безопасности:

  • хранилище ключей и приватный ключ сервера защищены разными паролями — даже если изначально пароль был один;

  • пароль хранилища выводится из пароля шифрования тома.

Секрет нужен для настройки HTTPS в server.xml (keystorePass) и для работы keytool. Чтобы получить его:

  1. В разделе нажмите «Поиск секрета хранилища ключей».

  2. Введите пароль шифрования тома, заданный в мастере первичной настройки (Мастер первичной настройки).

  3. Скопируйте показанный секрет хранилища ключей.

    Секрет хранилища ключей
17 November 2026