Сертификаты Национального удостоверяющего центра Минцифры России (Russian Trusted CA) — это российские TLS-сертификаты, которые обеспечивают защищенное HTTPS-соединение с ресурсами, перешедшими на отечественную инфраструктуру доверия.
В связи с отзывом зарубежных TLS-сертификатов у российских компаний, многие банки, государственные сервисы и другие организации переходят на сертификаты НУЦ Минцифры. Для корректной работы с такими ресурсами в доверенном хранилище операционной системы должны присутствовать 2 сертификата:
Russian Trusted Root CA — корневой сертификат, подтверждающий доверие к удостоверяющему центру;
Russian Trusted Sub CA — промежуточный (выпускающий) сертификат, которым подписываются сертификаты конечных ресурсов.
Для чего сертификаты нужны на сервере
Установка необходима для:
работы с API банков: например, при оплате через Сбербанк или T-Банк требуется установка сертификатов для корректного обращения к платежным шлюзам;
интеграции с государственными сервисами: доступ к информационным системам госорганов, использующим сертификаты НУЦ Минцифры;
взаимодействия с российскими онлайн-сервисами: маркетплейсами, системами маркировки, службами доставки и другими ресурсами.
Важно
Установка сертификатов на сервер позволяет вашим приложениям обращаться к российским ресурсам, но не обеспечивает доверие к сайту на устройствах его посетителей. Для конечных пользователей сертификаты должны быть установлены отдельно на их устройствах или в браузерах.
Как установить сертификат
Для установки сертификатов в системное хранилище выполните команды от имени пользователя с правами sudo или от root:
-
1
Скачайте файлы сертификатов:
wget https://gu-st.ru/content/lending/russian_trusted_sub_ca_pem.crt wget https://gu-st.ru/content/lending/russian_trusted_root_ca_pem.crtГде
wget — утилита для загрузки файлов по протоколу HTTP/HTTPS.
-
2
Скопируйте их в системное хранилище:
sudo cp russian_trusted_sub_ca_pem.crt /usr/local/share/ca-certificates/ sudo cp russian_trusted_root_ca_pem.crt /usr/local/share/ca-certificates/Где
/usr/local/share/ca-certificates/ — директория для пользовательских сертификатов, которые будут добавлены в системное хранилище.
-
3
Обновите хранилище сертификатов:
sudo update-ca-certificatesПри успешном выполнении в выводе появится строка:
2 added, 0 removed; done
-
1
Установите wget (если отсутствует):
sudo yum install wget -
2
Скачайте файлы сертификатов:
wget https://gu-st.ru/content/lending/russian_trusted_sub_ca_pem.crt wget https://gu-st.ru/content/lending/russian_trusted_root_ca_pem.crt -
3
Скопируйте в хранилище:
sudo cp russian_trusted_sub_ca_pem.crt /etc/pki/ca-trust/source/anchors/ sudo cp russian_trusted_root_ca_pem.crt /etc/pki/ca-trust/source/anchors/ -
4
Обновите хранилище:
sudo update-ca-trust
Для приложений, работающих в Docker, добавляйте сертификаты на этапе сборки образа.
Сертификаты будут доступны в контейнере по пути:
/usr/local/share/ca-certificates/russian-trusted/
Пример для Dockerfile:
# Создаем директорию для сертификатов Минцифры
RUN mkdir -p /usr/local/share/ca-certificates/russian-trusted/
# Копируем файлы сертификатов в образ
COPY russian_trusted_root_ca_pem.crt /usr/local/share/ca-certificates/russian-trusted/
COPY russian_trusted_sub_ca_pem.crt /usr/local/share/ca-certificates/russian-trusted/
# Обновляем хранилище сертификатов
RUN update-ca-certificates
Важно
Перед сборкой образа поместите скачанные сертификаты в ту же директорию, что и Dockerfile.
Настройка языков программирования после установки сертификатов
После установки сертификатов в системное хранилище некоторые языки и фреймворки не используют его по умолчанию. Они применяют собственные хранилища сертификатов, поэтому для корректной работы требуется дополнительная настройка. Ниже приведены инструкции для самых популярных языков.
Node.js
Задайте переменную окружения NODE_EXTRA_CA_CERTS с путем к файлу сертификата:
ENV NODE_EXTRA_CA_CERTS=/usr/local/share/ca-certificates/russian-trusted/russian_trusted_ca_bundle.crt
Python
Задайте переменные окружения для библиотек, использующих собственные хранилища:
REQUESTS_CA_BUNDLE=/usr/local/share/ca-certificates/russian-trusted/russian_trusted_ca_bundle.crt
SSL_CERT_FILE=/usr/local/share/ca-certificates/russian-trusted/russian_trusted_ca_bundle.crt
Java/JVM
Требуется импорт сертификатов в хранилище JVM через keytool. Рекомендуется создавать отдельный truststore, а не изменять системный cacerts:
keytool -importcert -noprompt -trustcacerts \
-alias russian_trusted_root \
-file /usr/local/share/ca-certificates/russian-trusted/russian_trusted_root_ca.crt \
-keystore "$JAVA_HOME/lib/security/cacerts" -storepass changeit
keytool -importcert -noprompt -trustcacerts \
-alias russian_trusted_sub \
-file /usr/local/share/ca-certificates/russian-trusted/russian_trusted_sub_ca.crt \
-keystore "$JAVA_HOME/lib/security/cacerts" -storepass changeit
Где
keytool — утилита для управления сертификатами в хранилище JVM;
-importcert — импортирует сертификат;
-alias — задает уникальное имя для сертификата в хранилище;
-keystore — путь к файлу хранилища сертификатов;
-storepass — пароль к хранилищу (по умолчанию changeit).
.NET
Использует системное хранилище Windows. Если приложение работает в Linux-контейнере, задайте переменную:
SSL_CERT_FILE=/usr/local/share/ca-certificates/russian-trusted/russian_trusted_ca_bundle.crt
Подробные инструкции для каждого языка доступны в документации T-Банка.
Как проверить правильность установки
Проверка системного хранилища
Выполните команду для просмотра доверенных сертификатов:
Для Ubuntu/Debian
trust list | grep Russian
Для CentOS/RHEL/AlmaLinux
rpm -qa ca-certificates
ls -la /etc/pki/ca-trust/extracted/pem/
В выводе должны отображаться:
Russian Trusted Root CA и Russian Trusted Sub CA
Проверка через OpenSSL
Для проверки доступа к конкретному ресурсу выполните:
openssl s_client -connect <домен>:443 2>/dev/null | grep 'Verify return code'
Ожидаемый корректный ответ:
Verify return code: 0 (ok)
Пример проверки доступа к Сбербанку:
openssl s_client -connect sberbank.ru:443 2>/dev/null | grep 'Verify return code'
Дополнительную информацию о сертификатах и требованиях к инфраструктуре можно получить в официальной документации Сбербанка.
Ограничения и замечания
-
1
Установка на сервер и устройства пользователей. Установка сертификата на сервер не заменяет установку на устройства пользователей. Ваши клиенты всё равно должны установить сертификаты на своих устройствах или использовать браузеры со встроенной поддержкой (Яндекс.Браузер, Atom).
-
2
Формат файлов. Утилиты
update-ca-certificatesиkeytoolпринимают только PEM-формат (текстовый, начинается с-----BEGIN CERTIFICATE-----). Если файл в формате DER, его необходимо сконвертировать:openssl x509 -inform DER -in cert.cer -out cert.pem -
3
Браузеры и системные сертификаты. Не все браузеры автоматически подхватывают системные сертификаты. Firefox может требовать ручного импорта или настройки использования системного хранилища.
-
4
Загрузка сертификатов. Загружайте сертификаты только из официальных источников. Актуальные файлы доступны на портале Госуслуг.
Как обновить сертификат
При выпуске новых версий сертификатов (обычно связано с продлением срока действия) повторите процедуру установки, заменив старые файлы новыми.
Как удалить сертификат
Удалите файлы сертификатов из соответствующего каталога:
Для Ubuntu/Debian
sudo rm /usr/local/share/ca-certificates/russian_trusted_*.crt
sudo update-ca-certificates
Для CentOS/RHEL/AlmaLinux
sudo rm /etc/pki/ca-trust/source/anchors/russian_trusted_*.crt
sudo update-ca-trust
Важно
После установки или обновления сертификатов очистите кэш браузера для корректной работы.
Была ли статья полезна?
Спасибо за оценку. Рады помочь 😊