Alpha.Community

В разделе Документация вы найдете все для уверенного старта и работы с Альфа платформой: от пошаговых инструкций по установке и конфигурированию до подробного описания работы компонентов и подсистем. Для поиска необходимых тем и вопросов в документации, воспользуйтесь поиском и фильтрацией результатов.

Настройка SSL / TLS (для ОС Linux)

Если вам необходимо установить безопасное соединение при подключении к LDAP-серверу, установленному в ОС Linux, предварительно нужно выполнить настройку SSL / TLS для этого сервера – так, как описано в данном разделе. Подробнее о самом безопасном подключении – в разделе Подключение к LDAP-серверу из SecurityConfigurator.

Инструкция ниже описана для Ubuntu 16.04. Настройка для Astra Linux и РЕД ОС может отличаться. Инструкция для ОС семейства "Альт" приведена в разделе Настройка OpenLDAP для пользователей ОС семейства "Альт", в подразделе Настройка резервирования без указания пароля администратора (см. первые два пункта).

Для начала создайте собственный сертификат CA, сертификат LDAP-сервера и ключ LDAP-сервера. Для этого выполните следующие действия:

  1. Удалите имеющиеся папки с сертификатами с помощью команд:

    sudo rm -rf /etc/ssl/ldap
    rm -rf ./demoCA
  2. Создайте новую папку для хранения сертификатов с помощью команд:

    mkdir -p demoCA
    mkdir -p demoCA/private
    mkdir -p demoCA/certs
    mkdir -p demoCA/newcerts

    По умолчанию в /usr/lib/ssl/openssl.cnf есть такое определение:

    # [ CA_default ]:
    # dir            = ./demoCA              # Where everything is kept

    Отсюда и берется название папки demoCA. Его можно изменить здесь, и далее работать со своим названием папки, везде указывая его вместо demoCA.

  3. Выполните команду, которая создаст файл и запишет в него номер создаваемого сертификата CA:

    echo "1001" > demoCA/serial

    и затем создайте еще один файл с помощью команды:

    touch demoCA/index.txt
  4. Создайте ключ-пароль RSA в специальном файле с помощью команды:

    /usr/bin/openssl genrsa -aes256 -out demoCA/private/cakey.pem 4096

    Будет предложено придумать пароль, введите, например, admin, затем еще раз admin.

    Теперь удалите парольную фразу из файла с помощью команды:

    /usr/bin/openssl rsa -in demoCA/private/cakey.pem -out demoCA/private/cakey.pem

    Будет запрошен пароль, введите значение, заданное выше (например, admin).

  5. Создайте сертификат CA с помощью указанной ниже команды. Убедитесь, что common совпадает с FQDN вашего сервера.

    /usr/bin/openssl req -new -x509 -days 3650 -key demoCA/private/cakey.pem 
    -out demoCA/certs/cacert.pem

    В команде выше можно использовать значения по умолчанию (например, 3650 – количество дней действия сертификата), но при запросе FQDN (полное доменное имя) нужно указать ваше значение вместо значения host-100.local:

    Common Name (e.g. server FQDN or YOUR name) []:host-100.local
  6. Сгенерируйте ключ LDAP-сервера с помощью команды:

    /usr/bin/openssl genrsa -aes256 -out demoCA/private/ldapserver-key.key 4096

    Будет предложено придумать пароль, введите, например, admin, затем еще раз admin.

    Теперь удалите заданную парольную фразу ключа с помощью команды:

    /usr/bin/openssl rsa -in demoCA/private/ldapserver-key.key -out demoCA/private/ldapserver-key.key

    Будет запрошен пароль, введите значение, заданное выше (например, admin).

  7. Сгенерируйте certificate signing request (CSR) с помощью указанной ниже команды. Нужно использовать те же значения настроек, которые использовали ранее, при создании файла сертификата:

    /usr/bin/openssl req -new -key demoCA/private/ldapserver-key.key 
    -out demoCA/certs/ldapserver-cert.csr

    В команде выше можно использовать значения по умолчанию, но при запросе FQDN (полное доменное имя) нужно указать ваше значение вместо значения host-100.local:

    Common Name (e.g. server FQDN or YOUR name) []:host-100.local
  8. Сгенерируйте сертификат LDAP-сервера и подпишите его ключом и ранее сгенерированным сертификатом с помощью команды:

    /usr/bin/openssl ca -keyfile demoCA/private/cakey.pem -cert demoCA/certs/cacert.pem 
    -in demoCA/certs/ldapserver-cert.csr -out demoCA/certs/ldapserver-cert.crt -days 3649

    Обратите внимание, что если файл demoCA/certs/ldapserver-cert.crt пустой – это ошибка. Ожидаемый вывод команды:

    #Using configuration from /usr/lib/ssl/openssl.cnf
    #Check that the request matches the signature
    #Signature ok
    #Certificate Details:
    #        Serial Number: 4097 (0x1001)
    #        Validity
    #            Not Before: Jan 16 19:44:46 2021 GMT
    #            Not After : Jan 16 19:44:46 2022 GMT
    #        Subject:
    #            countryName               = AU
    #            stateOrProvinceName       = Some-State
    #            organizationName          = Internet Widgits Pty Ltd
    #            commonName                = 192.168.56.101
    #        X509v3 extensions:
    #            X509v3 Basic Constraints:
    #                CA:FALSE
    #            Netscape Comment:
    #                OpenSSL Generated Certificate
    #            X509v3 Subject Key Identifier:
    #                EE:84:4A:13:61:69:26:8C:89:DE:C6:92:7D:CA:DC:1B:07:DC:95:EF
    #            X509v3 Authority Key Identifier:
    #                keyid:B5:28:6B:AF:8B:6D:F3:1F:3C:BB:A2:13:11:16:AE:69:72:0B:F3:ED
    #
    #Certificate is to be certified until Jan 16 19:44:46 2022 GMT (3650 days)

    Потребуется подтверждение подписи и сертификации, на этих шагах ответьте y:

    #Sign the certificate? [y/n]:y
    #1 out of 1 certificate requests certified, commit? [y/n]y

    Выполнение команды завершится выводом:

    #Write out database with 1 new entries
    #Data Base Updated
  9. Проверьте наличие у LDAP-сервера сертификата CA с помощью команды:

    /usr/bin/openssl verify -CAfile demoCA/certs/cacert.pem demoCA/certs/ldapserver-cert.crt

    Ожидаемый вывод:

    #demoCA/certs/ldapserver-cert.crt: OK
  10. Переместите папку для хранения сертификатов в папку LDAP-сервера:

    sudo mv demoCA /etc/ssl/ldap

Теперь у вас есть файлы собственного сертификата CA, сертификата LDAP-сервера и ключа LDAP-сервера, расположенные в папках:

  • /etc/ssl/ldap/certs/cacert.pem
  • /etc/ssl/ldap/certs/ldapserver-cert.crt
  • /etc/ssl/ldap/private/ldapserver-key.key

Примените созданный сертификат. Для этого выполните следующее:

  1. Укажите в качестве владельца папки с сертификатами OpenLDAP пользователя openldap:

    sudo chown -R openldap: /etc/ssl/ldap/

    Задайте права доступа:

    sudo chmod 0400 /etc/ssl/ldap/private/ldapserver-key.key
  2. Этот шаг выполняется только для Ubuntu. Если у вас другая ОС, перейдите к шагу 3.

    Перейдите к редактированию usr.sbin.slapd командой:

    sudo vi /etc/apparmor.d/usr.sbin.slapd

    Добавьте в него следующие строки:

    /etc/ssl/ldap/ r,
    /etc/ssl/ldap/* r,
    /etc/ssl/ldap/certs r,
    /etc/ssl/ldap/certs/* r,
    /etc/ssl/ldap/newcerts r,
    /etc/ssl/ldap/newcerts/* r,
    /etc/ssl/ldap/private r,
    /etc/ssl/ldap/private/* r,

    Затем переинициализируйте AppArmor командой:

    sudo /etc/init.d/apparmor restart

    или перезагрузите систему командой:

    sudo reboot
  3. Обновите сертификаты TLS сервера OpenLDAP.

    1. Создайте файл-схему для определения атрибутов TLS с помощью команды:

      nano openldap-tls.ldif
    2. Добавьте в файл следующее:

      dn: cn=config
      changetype: modify
      add: olcTLSCACertificateFile
      olcTLSCACertificateFile: /etc/ssl/ldap/certs/cacert.pem
      -
      replace: olcTLSCertificateFile
      olcTLSCertificateFile: /etc/ssl/ldap/certs/ldapserver-cert.crt
      -
      replace: olcTLSCertificateKeyFile
      olcTLSCertificateKeyFile: /etc/ssl/ldap/private/ldapserver-key.key
    3. Примените созданную схему с помощью команды:

      sudo ldapmodify -Y EXTERNAL -H ldapi:/// -f openldap-tls.ldif

      Ожидаемый вывод:

      #SASL/EXTERNAL authentication started
      #SASL username: gidNumber=0+uidNumber=0,cn=peercred,cn=external,cn=auth
      #SASL SSF: 0
      #modifying entry "cn=config"
    4. Убедиться, что схема применена, можно с помощью команды:

      sudo slapcat -b "cn=config" | grep -E "olcTLS"

      Ожидаемый вывод:

      #olcTLSCACertificateFile: /etc/ssl/ldap/certs/cacert.pem
      #olcTLSCertificateFile: /etc/ssl/ldap/certs/ldapserver-cert.crt
      #olcTLSCertificateKeyFile: /etc/ssl/ldap/private/ldapserver-key.key
  4. Проверьте что у пользователя openldap есть доступ к сертификату CA, сертификату сервера и ключу сервера. При выполнении команд не должно быть ошибок. Если ошибки возникают, для ОС Astra Linux можно выполнить действия, указанные ниже в этом же пункте инструкции.

    • Команда:

      sudo -u openldap file /etc/ssl/ldap/certs/cacert.pem

      Ожидаемый вывод:

      #/etc/ssl/ldap/certs/cacert.pem: PEM certificate
    • Команда:

      sudo -u openldap file /etc/ssl/ldap/certs/ldapserver-cert.crt

      Ожидаемый вывод:

      #/etc/ssl/ldap/certs/ldapserver-cert.crt: ASCII text
    • Команда:

      sudo -u openldap file /etc/ssl/ldap/private/ldapserver-key.key

      Ожидаемый вывод:

      #/etc/ssl/ldap/private/ldapserver-key.key: PEM RSA private key

    Если при выполнении этих команд возникают ошибки, для ОС Astra Linux можно выполнить следующее:

    1. Перейдите к параметрам системы в меню Пуск → Параметры → Безопасность → Управление доступом → Мандатный контроль целостности.
    2. В нижней части открывшегося окна параметров слева от поля ввода Фильтр переключите режим отображения списка пользователей – вместо Обычные выберите значение Системные.
    3. Найдите системного пользователя openldap в обновившемся списке пользователей, выделите его нажатием левой кнопкой мыши. Затем нажмите кнопку, открывающую настройки для конкретного пользователя, справа от поля ввода Фильтр и выберите Уровень целостности → Максимальная целостность → Высокий.
    4. Нажмите кнопку Применить.

    Если не проделать эти шаги, сертификат всё равно будет работать, однако вывод в указанных командах не будет соответствовать ожидаемому.

  5. Для проверки корректности конфигурации LDAP запустите команду:

    sudo slaptest -u

    Ожидаемый вывод:

    #config file testing succeeded
  6. Все директивы TLS для клиентов должны располагаться в файле ldap.conf. Если не выполнить этого условия, клиенты (например, конфигуратор или агент безопасности) не смогут устанавливать безопасное соединение с сервером. Чтобы избежать этого, скопируйте содержимое файла /etc/ssl/ldap/certs/cacert.pem и вставьте его в конец файла /etc/ssl/certs/ca-certificates.crt, а затем перезапустите сервер slapd с помощью команды:

    sudo systemctl restart slapd

    Затем выполните следующую команду (здесь нужно указать ваш FQDN (полное доменное имя) вместо значения host-100.local):

    gnutls-cli --starttls-proto=ldap --print-cert -p 389 host-100.local

    Ожидаемый вывод:

    #- Status: The certificate is trusted.
    #- Description: (TLS1.3-X.509)-(ECDHE-SECP256R1)-(RSA-PSS-RSAE-SHA256)-(AES-256-GCM)
    #- Options:
    #- Handshake was completed

    Если вы резервируете сервер OpenLDAP, это условие также нужно учесть:

    • При однонаправленном резервировании на стороне резервирующих серверов должен быть установлен сертификат резервируемого сервера (так, содержимое файла cacert.pem резервируемого сервера должно попасть в файлы ca-certificates.crt всех резервирующих серверов).
    • При разнонаправленном (зеркальном) резервировании на каждом сервере должны быть установлены сертификаты всех остальных серверов (так, содержимое файла cacert.pem каждого резервируемого сервера должно попасть в файлы ca-certificates.crt всех остальных серверов).
  7. Необязательный шаг: включите поддержку ldaps:///. Для этого перейдите к редактированию файла slapd командой:

    sudo nano /etc/default/slapd

    Измените строку SLAPD_SERVICES так, чтобы получилось следующее:

    SLAPD_SERVICES="ldap:/// ldaps:/// ldapi:///"
  8. Перезапустите сервис slapd:

    sudo systemctl restart slapd

Сертификаты будут применены, и с LDAP-сервером можно будет установить безопасное соединение. Протокол безопасного соединения выбирается при подключении, подробнее об этом – в разделе Подключение к LDAP-серверу из SecurityConfigurator.