Данная статья применима к:

Astra Linux Special Edition РУСБ.10015-01 (очередное обновление 1.7)
Astra Linux Special Edition РУСБ.10015-01 (очередное обновление 1.6)
Astra Linux Special Edition РУСБ.10015-16 исп. 1 и исп. 2
Astra Linux Special Edition РУСБ.10265-01 (очередное обновление 8.1)
Astra Linux Common Edition 2.12

Аннотация

В статье описывается настройка аутентификации Kerberos для web-сервера apache2 в доменах FreeIPA или ALD. В качестве примера создается одностраничный тестовый web-сайт, требующий для просмотра аутентификации Kerberos. Параметры стенда:

Имя домена: ipadomain0.ru;
Контроллер домена:
1. Имя сервера контроллера: ipa0.ipadomain0.ru;
Web-сервер:
1. Имя сервера: web.ipadomain0.ru

Компьютер с web-сервером зарегистрирован в домене как компьютер домена, и далее служба web-сервера разворачивается на этом компьютере. Доступ к содержимому web-сайтов может осуществляться с помощью разных браузеров, требующих отдельных настроек аутентификации. Настройка web-браузеров в данной статье не рассматривается, а тестирование работы созданной web-службы выпоняется с помощью команды curl.

Установка пакетов

Служба web-сервера apache2 представлена в Astra Linux пакетом apache2. При установке ОС пакет apache2 по умолчанию не устанавливается, но может быть выбран для установки на этапе выбора программного обеспечения во время установки ОС.

Только для Astra Linux Special Edition:

Службы, устанавливаемые при установке ОС (кроме службы SSH), по умолчанию не запускаются, так как запуск ненастроенных служб может создавать угрозу безопасности.
Если пакет apache2 устанавливался при установке ОС, то после запуска ОС и выполнения настройки службы следует вручную запустить службу и разрешить автоматический запуск службы после перезагрузки:

systemctl start apache2
systemctl enable apache2

Если пакет apache2 не был установлен ранее, то установить его можно с помощью графического менеджера пакетов или командой:

sudo apt install apache2

Для использования аутентификации Kerberos дополнительно установить пакет libapache2-mod-auth-kerb, содержащий модуль аутентификации auth_kerb:

sudo apt install libapache2-mod-auth-kerb

При установке контроллера (реплики контроллера) домена FreeIPA служба apache2 будет установлена и настроена автоматически, однако настройка аутентификации Kerberos при этом не производится.

Настройка конфигурации apache2

В конфигурационных файлах web-сайтов, доступ к которым предоставляется службой apache2, должны быть заданы параметры авторизации. Например, создадим файл /etc/apache2/sites-available/auth-kerberos.conf со следующим содержимым:

<VirtualHost *:81>
    ServerAdmin webmaster@localhost
    DocumentRoot /var/www
    ErrorLog ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined
    <Directory /var/www>
        AuthType Kerberos
        # Имя области (realm) Керберос - имя домена ЗАГЛАВНЫМИ буквами
        KrbAuthRealms <РЕАЛМ_КЕРБЕРОС>
        # Имя доменной службы, предоставляемой сервером
        KrbServiceName HTTP/<полное_доменное_имя_сервера>сай
        # Имя файла, в котором сохранены ключи доменной службы
        Krb5Keytab /etc/apache2/keytab
        KrbMethodNegotiate on
        KrbMethodK5Passwd off
        require valid-user
        KrbSaveCredentials on
    </Directory>
</VirtualHost>

Особо можно выделить параметр KrbMethodK5Passwd: если его значение изменить на on, то при входе на web-сайт будут интерактивно запрашиваться имя и пароль для выполнения аутентификации Kerberos. Использование интерактивного ввода может быть удобно для проверки доступности сайта с помощью web-браузеров (настройка web-браузеров для работы с Kerberos в данной статье не рассматривается). Полное описание параметров настройки web-сайтов доступно в документации apache2.

Запретить использование web-сайта, устанавливаемого по умолчанию при установке apache2:

sudo a2dissite 000-default.conf

Разрешить использование созданного конфигурационного файла для предоставления доступа к web-сайту:

sudo a2ensite auth-kerberos

Создать каталог для документов web-сайта:

sudo mkdir /var/www/html/auth-kerberos

И создать в этом каталоге файл /var/www/html/auth-kerberos/index.html со страницей web-сайта:

<html>
<body>
<div style="width: 100%; font-size: 40px; font-weight: bold; text-align: center;">
Тестовая страница для проверки аутентификации Kerberos.
Если вы видите этот текст, то аутентификация выполнена успешно.
</div>
</body>
</html>

Для того чтобы кириллица отображалась корректно добавить в файл /etc/apache2/apache2.conf параметр:

AddDefaultCharset UTF-8

Только для Astra Linux Special Edition:

В файл /etc/apache2/apache2.conf установить параметр AstraMode в значение off:

AstraMode off

После изменения конфигурации перезапустить службу apache2:

sudo systemctl restart apache2

Настройка аутентификации Kerberos в домене FreeIPA

На контроллере домена:
1. Получить права администратора домена:
  kinit admin
2. Зарегистрировать доменную службу
  ipa service-add HTTP/<полное_доменное_имя_web-сервера>
На web-сервере:
1. Получить права администратора домена от имени суперпользователя:
  sudo kinit admin
2. Действуя от имени суперпользователя с правами администратора домена получить и сохранить таблицу ключей новой службы:
  sudo ipa-getkeytab -s ipa0.ipadomain0.ru -k /etc/apache2/keytab -p HTTP/`hostname`
3. Установить права доступа на файл с таблицей ключей:
  sudo chown www-data:www-data /etc/apache2/keytab

Настройка аутентификации Kerberos в домене ALD

Для домена ALD сценарий настройки состоит таких же операций, как сценарий для FreeIPA, и отличается только синтаксисом команд. Сценарий настройки для ALD может выглядеть так:

На контроллере домена команды:

ald-admin service-add HTTP/<полное_доменное_имя_web-сервера>
ald-admin sgroup-svc-add HTTP/<полное_доменное_имя_web-сервера> --sgroup=mac

На web-сервере команды:

keytab="/etc/apache2/keytab"
ald-client update-svc-keytab HTTP/`hostname` --ktfile="$keytab"
chown www-data "$keytab"
chmod 644 "$keytab"

После изменения конфигурации перезапустить сервер:

systemctl restart apache2

Проверка работы аутентификации

Созданный на этапе настройки apache2 тестовый сайт должен быть доступен по адресу http://<полное_доменное_имя_web-сервера>. Далее для получения содержимого сайта используется команда curl. Особенностью работы этой команды является то, что для выполнения аутентификации Kerberos она использует имя таблицы билетов Kerberos, хранящейся в переменной окружения KRB5CCNAME. Если тестирование выполняется не от имени доменного пользователя, значение переменной окружения KRB5CCNAME должно быть установлено вручную.

Проверка отказа в доступе:
1. Попытаться прочитать содержимое web-сайта без авторизации:
  curl http://`hostname`
  <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 2.0//EN">
  <html><head>
  <title>401 Unauthorized</title>
  </head><body>
  <h1>Unauthorized</h1>
  <p>This server could not verify that you
  are authorized to access the document
  requested. Either you supplied the wrong
  credentials (e.g., bad password), or your
  browser doesn't understand how to supply
  the credentials required.</p>
  <hr>
  <address>Apache/2.4.46 (Debian) Server at web.ipadomain0.ru Port 80</address>
  </body></html>
  Получен отказ в доступе.
2. Удалить билеты Kerberos:
  kdestroy
3. Попытаться прочитать содержимое сайта использую авторизацию Kerberos:
  
  curl --negotiate -u : http://`hostname`
  <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 2.0//EN">
  <html><head>
  <title>401 Unauthorized</title>
  </head><body>
  <h1>Unauthorized</h1>
  <p>This server could not verify that you
  are authorized to access the document
  requested. Either you supplied the wrong
  credentials (e.g., bad password), or your
  browser doesn't understand how to supply
  the credentials required.</p>
  <hr>
  <address>Apache/2.4.46 (Debian) Server at web.ipadomain0.ru Port 80</address>
  </body></html>
  Получен отказ в доступе.
Проверка предоставления доступа;
1. Получить билет Kerberos:
  kinit admin
2. Убедиться, что переменная окружения KRB5CCNAME содержит верное указание на таблицу ключей:
  echo $KRB5CCNAME
  KEYRING:persistent:67200
  Если значение переменной не задано (например, тестирование выполняется от имени локального а не доменного пользователя), то получить имя таблицы ключей с помощью команды klist и задать правильное значение переменной, например:
  klist
  Ticket cache: KEYRING:persistent:1000:1000
  Default principal: admin@IPADOMAIN0.RU
  Valid starting Expires Service principal
  03.11.2021 11:26:24 04.11.2021 11:26:22 krbtgt/IPADOMAIN0.RU@IPADOMAIN0.RU
  
  export KRB5CCNAME=KEYRING:persistent:1000:1000
3. Прочитать содержимое сайта использую авторизацию Kerberos:
  
  curl --negotiate -u : http://`hostname`
  <html>
  <body>
  <div style="width: 100%; font-size: 40px; font-weight: bold; text-align: center;">
  Тестовая страница для проверки аутентификации Kerberos.
  Если вы видите этот текст, то аутентификация выполнена успешно.
  </div>
  </body>
  </html>
  Команда должна завершиться успехом.

Дерево страниц

Настройка авторизации Kerberos для службы apache2 в Astra Linux