	    Краткое описание применения httpd-mls-setup.

Программа предназначена для подготовки окружения к запуску web-сервиса (Apache2) с уровнем допуска, отличным 
от s0 (Неклассифицировано). Результатом работы являются конфигурационные файлы, а так же необходимые каталоги. 
Собствненно запуск веб-сервисов производится посредством использования доп. аргумента и стартового файла 
httpd2-mls@.service. Например systemctl start httpd2-mls@s2. Для каждого уровня формируется "свой" конфигурационный 
файл, для приведенного случая /etc/httpd2/conf/httpd-mls-s2.conf. Каждый создаваемый конфигурационный файл в самой 
малой степени зависит от других файлов (имеются ввиду файлы в каталоге /etc/httpd2/conf), соответственно (в отличие 
от сервера уровня s0, который по умолчанию), нельзя и не нужно использовать утилиты типа a2ena... Для понимания работы 
рекомендуется изучить полученный конфигурационный файл. В нем оставлены большинство оригинальных комментариев. 
Полученный конф. файл не является однозначно пригодным для всех случаев. Это скорее минимальный набор, который 
необходимо довести до конечного варианта в соответствии с назначением сервера. Программа не сохраняет предыдущий конф. 
файл, если он уже существует, просто переписывает. Соответственно, с одной стороны, можно легко экспериментировать, с 
другой - следует проявить заботу о сохранении полезных файлов. Каталоги для размещения документов создаются, но не 
очищаются (если уже присутствуют). Они не "заселяются" каким-либо содержимым. Для начала настройки сервера (или 
серверов) уровня !=s0 нужно выполнить некоторые предварительные действия, которые описаны в следующем разделе. Эти 
действия направлены на создание ключей и сертификатов SSL для всех серверов. Если нужно снабдить серверы 
уникальными ключами, это не сложно сделать, просто создавая нужное количество ключей в различных каталогах и изменяя настройки 
в соотв. конфиг-файлах. Программа по умолчанию настраивает только https протокол, можно настроить и http, не 
рекомендуется.

	    Предварительные действия.

Сервер (компьютер на котором будет развернут и настроен web-сервер с уровнем доуска отличным от s0) должен быть настроен 
для доменной авторизации в IPA-домене (см. соотв. раздел РА). Если в дальнейшем предполагается использовать иной тип 
авторизации, многие действия можно опустить. Конфигурационные файлы настраиваются на авторизацию посредством GSSAPI и в 
них нужно будет внести изменения. Здесь описывается только настройка для работы  в IPA-домене. Более подробно:
1. Выполнено подключение к домену в качестве клиента (ipa-clien-install)
2. На IPA-сервере заведен новый сервис с именем HTTP и именем "нашего" сервера (ipa service-add ...)
3. На веб-сервере создан файл keytab для доменной авторизации пользователей и он доступен для чтения пользователю apache2.
    Рекомендуется chown apache2:root и маска доступа 600
4. На веб-сервере установлена поддержка ssl (mod_ssl) и были созданы ключи и сертификаты.

Сам веб-сервер уровня s0 настраивать не обязательно, общими для всех серверов разных уровней являются сертификаты и 
ключи, файл keytab и файлы конфигурации модулей, но настроить его всячески рекомендуется для проверки 
доменной авторизации. Это самый простой способ убедиться в отсутствии ошибок. См. соотве. раздел РА по настройке совместной 
работы веб-сервера и FreeIPA. При необходимости обновите документацию.

	    Ключи и значения по умолчанию.

-l, --level=[123] MLS level, уровень допуска, обязательный параметр
-k, --keytab, путь к файлу keytab, по умолчанию /etc/http.keytab
-n, --name ServerName, по умрлчанию $HOSTNAME, это же имя будет использовано как NickName для авторизации
-s, --https, порт https, по умолчанию 8080+$MLS (8081-8083)
-p, --http, порт http, по умолчанию отключен
-w, --www, DocumentRoot, по умолчанию /var/www-s${MLS}/html
-c, --cgi, cgi-bin directory, по умолчанию /var/www-s${MLS}/cgi-bin
-h, --help справка
-i, --info при использовании ключа -i программа только показывает параметы, но не производит никаких других действий.

	    Предварительные действия, часть 2.

Настройка контекста интерфейсов. Для примера, при наличии единственного сетевого интерфейса enp0s3

semanage user -a system_u -R generic_r
semanage interface -a lo -t netif -r s0-s3:c0.c15
semanage interface -a enp0s3 -t netif -r s0-s3:c0.c15

	    Рекомендуемый порядок применения.
Перед началом следует определиться с назначением портов и каталогов. Рекомендуется указать минимальный набор параметров
и запустить программу с ключем -i и сравнить вывод со своими требованиями. Если какой-либо параметр не устраивает, указать 
его явно.

Пример. 
[root@app ~]# httpd-mls-setup -l 1 -p 81 -i
    MLS level=s1		keytab=/etc/http.keytab
    name=app.abc.loc	https port=8081
    http port=81
    DocumentRoot=/var/www-s1/html	cgi-bin directory=/var/www-s1/cgi-bin
[root@app ~]# 

Добиваемся нужного результата и по достижении, выполняем программу без ключа -i. При вызове программы (без -i) все файлы будут 
переписаны без сохранения каких-либо копий. При необходимости можно редактировать  файлы (в примере уровень s1 и, соответственно, 
файл /etc/httpd2/conf/httpd-mls-s1.conf). Можно использовать файлы настройки переменных аналогично тому, как это сделано для
сервера уровня s0 (файл /etc/sysconfig/httpd2). Для серверов с уровнем s1-s3 нужно создать файлы /etc/sysconfig/httpd2-mls-s[123] 
Эти файлы необязательны (в отличие от сервера s0) и не создаются автоматически..


	    Заключение (контрольный запуск)
До начала проверки работы следует уделить некоторое внимание FreeIPA серверу (или серверам). Следует выполнить следующие шаги
1. Проверить контекст файла /usr/sbin/krb5kdc. 
    ls -Z /usr/sbin/krb5kdc 
Должен быть тип trusted_exec_t. Если не соответствует, выполнить
    chcon -t trusted_exec_t /usr/sbin/krb5kdc
2. Проверить ято запущен и работает сервис синхронизации времени.

На рабочей станции, с которой будет проводиться проверка, нужно "проверить билеты" доменного пользователя (войти от его имени
с соответствующим контекстом) и выполнить

[petrov@w20 petrov]$ klist
Ticket cache: KEYRING:persistent:1497200003:krb_ccache_7dWoT7z
Default principal: petrov@ABC.LOC

Valid starting       Expires              Service principal
07.06.2024 03:58:28  08.06.2024 03:58:28  krbtgt/ABC.LOC@ABC.LOC

Сообщение про отсутствие соотв. KEYRING говорит о том, что авторизаци может проходить, но подтверждение полномочий пользователя
невозможно. Станцию проще всего перегрузить

Далее все про веб-сервер.

Не следует забывать выполнить systemctl daemon-reload после модификации каких-либо конфигурационных или стартовых файлов. 
Создаваемые корневые каталоги (DocumentRoot) ничем не заселяются, при подключении к такому серверу, будет выдана ошибка 403 (сервер
работает, отвечает на запросы, но содержимое отсутствует). 

Для тестов можно скопировать файл от сервера s0 (/var/www/html/index.html). Потребуется так же дать права на чтение и исполнение нв
каталог DocumentRoot. Рекомендуется создать файл .htaccess с разрешением всем-все. Пример выполнения перечисленных действий для 
DocumentRoot уровня s1, расположенного в /var/www-s1/html:

cp /var/www/html/index.html /var/www-s1/html
chown -R apache2 /var/www-s1/html
chmod a+rx /var/www-s1/html
echo "Require all granted" > /var/www-s1/html/.htaccess
url для проверки https://app.abc.loc:8081

Пример запуска серверов уровня s1 и s2.

[root@app system]# systemctl start httpd2-mls@s2
[root@app system]# systemctl start httpd2-mls@s1
[root@app system]# ps axZ|grep htt
generic_u:generic_r:generic_t:s0 2400 ?        Ssl    0:00 /usr/bin/guile18 -s /usr/sbin/ahttpd
generic_u:generic_r:generic_t:s2 6220 ?        Ssl    0:00 /usr/sbin/httpd2 -k start -f /etc/httpd2/conf/httpd-mls-s2.conf
generic_u:generic_r:generic_t:s2 6225 ?        S      0:00 /usr/sbin/httpd2 -k start -f /etc/httpd2/conf/httpd-mls-s2.conf
generic_u:generic_r:generic_t:s2 6226 ?        S      0:00 /usr/sbin/httpd2 -k start -f /etc/httpd2/conf/httpd-mls-s2.conf
generic_u:generic_r:generic_t:s2 6227 ?        S      0:00 /usr/sbin/httpd2 -k start -f /etc/httpd2/conf/httpd-mls-s2.conf
generic_u:generic_r:generic_t:s2 6228 ?        S      0:00 /usr/sbin/httpd2 -k start -f /etc/httpd2/conf/httpd-mls-s2.conf
generic_u:generic_r:generic_t:s2 6229 ?        S      0:00 /usr/sbin/httpd2 -k start -f /etc/httpd2/conf/httpd-mls-s2.conf
generic_u:generic_r:generic_t:s1 6306 ?        Ssl    0:00 /usr/sbin/httpd2 -k start -f /etc/httpd2/conf/httpd-mls-s1.conf
generic_u:generic_r:generic_t:s1 6311 ?        S      0:00 /usr/sbin/httpd2 -k start -f /etc/httpd2/conf/httpd-mls-s1.conf
generic_u:generic_r:generic_t:s1 6312 ?        S      0:00 /usr/sbin/httpd2 -k start -f /etc/httpd2/conf/httpd-mls-s1.conf
generic_u:generic_r:generic_t:s1 6313 ?        S      0:00 /usr/sbin/httpd2 -k start -f /etc/httpd2/conf/httpd-mls-s1.conf
generic_u:generic_r:generic_t:s1 6314 ?        S      0:00 /usr/sbin/httpd2 -k start -f /etc/httpd2/conf/httpd-mls-s1.conf
generic_u:generic_r:generic_t:s1 6315 ?        S      0:00 /usr/sbin/httpd2 -k start -f /etc/httpd2/conf/httpd-mls-s1.conf
officer_u:officer_r:officer_t:s0-s3:c0.c15 6317 pts/1 R+   0:00 grep htt
[root@app system]#

Для проверки доменной авторизации можно скопировать в cgi-bin скрипты (это симлинки) из директории сервера s0 (.htaccess не нужен), 
Кроме собственно копирования, скрипт test-cgi нужно отредактировать - самой первой строкой добавить #! /bin/sh, для printenv - первая 
строка должна быть #! /usr/bin/perl (на самом деле это написано в самих скрипах). И дать права на исполнение, нпример 755. 
эти скрипты показывают переменные окружения, если все правильно, в REMOTE_USER будет отображено доменное имя пользователя. 
Если авторизация не прошла - ошибка авторизации. Броузер должен быть настроен для использования доменной авторизации. Пример для s1:
cp -R /var/www/cgi-bin /var/www-s3
url для тестирования: https://app.abc.loc:8081/cgi-bin/test-cgi

Для собственно запуска серверов используется вариант всем знакомой утилиты apachectl с именем apachectl-mls. Она не 
предназначена для непосредственного использования (только через systemd). Несмотря на это при наличии определенного опыта 
и осторожности, такое ее применение возможно, хотя и является сложным, никакого выигрыша, по сравнению с "прямым" вызовом 
httpd2 не предполагается. Следует помнить, что настройке веб-сервера Apache(2) посвящены многие и многие тома...

Пример использования curl (нужен файл сертификата CA.pem, его поместили в /home)

[petrov@w20 petrov]$ curl -i --negotiate --cacert /home/CA.pem -u : https://app.abc.loc:8081/cgi-bin/test-cgi
HTTP/1.1 200 OK
Date: Fri, 07 Jun 2024 00:58:58 GMT
Server: Apache/2.4.43 (Unix) mod_auth_gssapi/1.4.1 mod_nss/1.0.17 NSS/3.45 PHP7/7.2.31
WWW-Authenticate: Negotiate oYG3MIG0oAMKAQChCwYJKoZIhvcSAQICooGfBIGcYIGZBgkqhkiG9xIBAgICAG+BiTCBhqADAgEFoQMCAQ+iejB4oAMCARKicQRvB1jalAQ2SrxrwnBzv6Clqt31HCDyJ7CdprzdPGH5w/9hJtGwrgIJ1nx+WvTwySySVa2mPD7VSJoH3fOG6fWzzmoD95Sgi/fO72+N4ktlvrpDzJ8THf5FwVh7MEKA/Vu0EU/llrKjx/8/SC5dKLz5
Content-Length: 493
Content-Type: text/plain; charset=iso-8859-1

CGI/1.0 test script report:

argc is 0. argv is .

SERVER_SOFTWARE = Apache/2.4.43 (Unix) mod_auth_gssapi/1.4.1 mod_nss/1.0.17 NSS/3.45 PHP7/7.2.31
SERVER_NAME = app.abc.loc
GATEWAY_INTERFACE = CGI/1.1
SERVER_PROTOCOL = HTTP/1.1
SERVER_PORT = 8081
REQUEST_METHOD = GET
HTTP_ACCEPT = */*
PATH_INFO = 
PATH_TRANSLATED = 
SCRIPT_NAME = /cgi-bin/test-cgi
QUERY_STRING = 
REMOTE_HOST =
REMOTE_ADDR = 192.168.113.20
REMOTE_USER = petrov@ABC.LOC
AUTH_TYPE = Negotiate
CONTENT_TYPE =
CONTENT_LENGTH =
[petrov@w20 petrov]$ 
