Tutorial do Rocky Linux 10 / Configurar caminhos, portas e booleanos SELinux para Apache

Para permitir novos caminhos, portas e conexões para serviços enquanto mantém o SELinux ativo no Rocky Linux 10, defina o tipo padrão para caminhos de arquivos, o tipo para portas de recepção e as políticas condicionais necessárias respectivamente. Os mapeamentos de caminhos de arquivos são registrados com semanage fcontext e então aplicados com restorecon , as portas de recepção são gerenciadas com semanage port , e os booleanos de política são ajustados com setsebool após confirmar seu propósito.

Distinguir permissões de arquivo, porta de recebimento e conexão

A aula sobre modos, contextos e diagnóstico AVC do SELinux distingue permissões comuns de tipos SELinux. Desta vez, o conteúdo da web é colocado em /srv/lf-web18 , e o Apache está configurado para receber em 127.0.0.1:18081 . Posteriormente, algumas solicitações são encaminhadas para o backend 127.0.0.1:18082 na mesma VM.

Três ações separadas requerem permissão: vincular uma porta de escuta, ler arquivos de conteúdo e abrir uma conexão com o backend . Permitir uma ação não permite automaticamente as outras. As permissões de firewall também são separadas dessas configurações.

Configuração Alvo desta prática Resultados reais a verificar
Mapeamento de tipos de porta TCP 18081 que o Apache irá escutar Se o serviço inicia e escuta no endereço dado
Mapeamento de caminho de arquivo e etiquetas /srv/lf-web18 e seus subdiretórios e arquivos Verifique se 200 e a string de teste aparecem na solicitação do arquivo web
Booleano de política condicional httpd_can_network_connect Verifique se o Apache pode conectar a um backend normal

Um booleano é uma condição de política que pode ser ligada ou desligada, como verdadeiro ou falso. Não apenas o ative pelo nome; verifique quais ações e escopo ele afeta. O booleano de conexão neste artigo não é uma regra que permite apenas um endereço de back-end de teste, então, na operação real, você também deve considerar opções de política mais restritas de acordo com os propósitos do serviço.

Preparar ferramentas e recursos em uma VM dedicada

Prossiga apenas em uma VM de prática que não tenha um serviço web existente. Esta VM teve o Apache instalado na aula anterior, que foi parado e configurado para não iniciar automaticamente, e o SELinux estava em modo Enforcing. Todas as solicitações web são executadas dentro da VM sem adicionar portas de firewall externas ou redirecionamento de portas do host. Solicitar 127.0.0.1:18081 de um terminal Windows não é o mesmo teste.

getenforce
systemctl is-active httpd
systemctl is-enabled httpd
sudo ss -lntp
sudo dnf install policycoreutils-python-utils
rpm -q httpd policycoreutils-python-utils selinux-policy-targeted
sudo semanage port -l -C
sudo semanage fcontext -l -C
sudo semanage boolean -l -C
getsebool httpd_can_network_connect

O laboratório de origem utilizou Rocky Linux 10.2, Apache 2.4.63-13.el10_2.8, policycoreutils-python-utils-3.10-2.el10_2, selinux-policy-targeted-42.1.18-4.el10_2.4. A instalação de origem adicionou as ferramentas de gerenciamento e sete pacotes de dependência. -l -C só recupera itens que foram adicionados ou modificados localmente. Não havia itens personalizados locais nesta VM no início, e o booleano de conexão era off.

Se já houver uma configuração ou serviço web ativo usando o mesmo caminho, porta e política, interrompa este procedimento e use um ambiente dedicado separado. O número da porta não deve apenas estar disponível, mas também não deve entrar em conflito com mapeamentos existentes do SELinux. Os caminhos de backup também não sobrescrevem itens existentes.

sudo bash <<'BASH'
set -eu
backup=/root/selinux-lab18-before
test ! -e "$backup"
test ! -e /srv/lf-web18
test ! -e /etc/httpd/conf.d/lf-course18.conf
mkdir -m 700 "$backup"
cp -a /etc/httpd "$backup/httpd"
semanage export > "$backup/local-policy.txt"
getsebool httpd_can_network_connect > "$backup/network-boolean.txt"
BASH

Este backup é para fins de comparação e restauração seletiva. Não importe cegamente todo o backup de política durante a recuperação, pois isso pode sobrescrever alterações feitas por outros administradores. Na verificação da origem, arquivos de configuração do SELinux, arquivos de firewall e políticas em execução também foram preservados separadamente, organizados e comparados.

Configure o caminho do Apache e o endereço de recepção em loopback.

Abra as configurações padrão com sudoedit /etc/httpd/conf/httpd.conf e altere a linha ativa Listen 80 para o seguinte valor. Configurações existentes com várias diretivas Listen ou outros hosts virtuais não são o alvo deste exemplo.

Listen 127.0.0.1:18081

O seguinte é o conteúdo completo do novo arquivo /etc/httpd/conf.d/lf-course18.conf. Abra o novo arquivo com sudoedit /etc/httpd/conf.d/lf-course18.conf e salve todo o conteúdo abaixo. Além disso, pré-defina o proxy reverso que encaminha solicitações para o backend, mas até a prática com o backend, apenas solicite o caminho padrão /.

ServerName localhost
DocumentRoot "/srv/lf-web18"
<Directory "/srv/lf-web18">
    AllowOverride None
    Require all granted
</Directory>
ProxyRequests Off
ProxyPass "/backend/" "http://127.0.0.1:18082/" retry=0
ProxyPassReverse "/backend/" "http://127.0.0.1:18082/"

Require all granted é a configuração de acesso do Apache para esse caminho; ela não ignora SELinux nem permissões comuns. Em um proxy reverso, Apache encaminha requisições a um backend definido. Como explica a documentação oficial do Apache mod_proxy, não é necessário ativar ProxyRequests On apenas para essa função. retry=0 evita adiar novas tentativas de conexão ao backend nesta comparação.

sudo bash <<'BASH'
set -eu
test ! -e /srv/lf-web18
mkdir -m 755 /srv/lf-web18
printf 'selinux-path18-ok\n' > /srv/lf-web18/index.html
chmod 644 /srv/lf-web18/index.html
restorecon -v /etc/httpd/conf.d/lf-course18.conf
BASH
sudo httpd -t
sudo httpd -M | grep -E 'proxy(_http)?_module'
ls -ldZ /srv/lf-web18 /srv/lf-web18/index.html

Verifique se a sintaxe da configuração Syntax OK e os módulos necessários para proxy proxy_module e proxy_http_module estão carregados. Se algum módulo estiver ausente ou houver um erro de sintaxe, resolva-o antes de alterar a política. As permissões gerais para o novo caminho e arquivo são 755 e 644, mas o tipo inicial neste ambiente era var_t.

Mapeie o tipo de porta de entrada e compare os resultados de inicialização.

Primeiro, leia a lista de portas permitidas pelo Apache e o status atual de recepção. A lista TCP http_port_t desta VM era 80, 81, 443, 488, 8008, 8009, 8443, 9000 , e 18081 não estava incluída. Não altere números que já pertencem a outros tipos de portas, pois eles não devem ser modificados.

sudo semanage port -l | grep '^http_port_t'
sudo systemctl start httpd
sudo systemctl status httpd --no-pager
sudo journalctl -u httpd --since '5 minutes ago' --no-pager
sudo ausearch --input-logs -m AVC,USER_AVC -ts recent -c httpd -i

A inicialização real antes do mapeamento falhou. O journal mostrou could not bind to address 127.0.0.1:18081 , e o AVC registrou name_bind de negação, serviço de origem httpd_t , destino unreserved_port_t , e porta 18081 . Mesmo que a verificação da sintaxe da configuração seja bem-sucedida, isso não significa que o uso da porta seja permitido durante a execução.

Adicione um número que não tinha um mapeamento de serviço separado usado nesta prática ao http_port_t. semanage port manual oficial explica o mapeamento de números de porta para tipos de porta do SELinux.

sudo semanage port -a -t http_port_t -p tcp 18081
sudo semanage port -l -C
sudo systemctl start httpd
sudo ss -lntp '( sport = :18081 )'
curl --noproxy '*' --max-time 5 -sS -o /dev/null \
  -w 'HTTP %{http_code}\n' http://127.0.0.1:18081/

Agora o serviço foi iniciado e recebido em 127.0.0.1:18081. No entanto, a resposta web ainda é 403. Isso ocorre porque apenas o problema de vinculação da porta foi resolvido, e o tipo de caminho do arquivo ainda não corresponde. semanage port não é um comando para abrir portas do firewall e não altera a configuração de recepção do programa do servidor.

Se aparecer um erro de que já está definido ao adicioná-lo, primeiro verifique outros mapeamentos. Para eliminar o erro, não mude imediatamente -a para -m nem reassigne a porta para o serviço existente.

Registre o caminho padrão e aplique-o ao rótulo real.

Registre apenas /srv/lf-web18 e seus subcaminhos como tipos de conteúdo web somente leitura. A expressão regular (/.*)? inclui o próprio diretório e os caminhos abaixo dele. Coloque-a entre aspas simples para que o shell não interprete o padrão.

sudo semanage fcontext -a -t httpd_sys_content_t '/srv/lf-web18(/.*)?'
sudo semanage fcontext -l -C
matchpathcon /srv/lf-web18/index.html
ls -ldZ /srv/lf-web18 /srv/lf-web18/index.html
curl --noproxy '*' --max-time 5 -sS -o /dev/null \
  -w 'HTTP %{http_code}\n' http://127.0.0.1:18081/

Esta etapa apenas registra o mapeamento padrão para o caminho. Não altera automaticamente os rótulos de arquivos existentes. No teste de origem, matchpathcon mostrou o novo tipo esperado, mas o arquivo ainda tinha var_t e as solicitações continuaram a retornar 403.

sudo restorecon -Rv /srv/lf-web18
ls -ldZ /srv/lf-web18 /srv/lf-web18/index.html
curl --noproxy '*' --max-time 5 -sS -w 'HTTP %{http_code}\n' \
  http://127.0.0.1:18081/

Após aplicar o rótulo, o tipo se tornou httpd_sys_content_t, e as respostas incluíram selinux-path18-ok e HTTP 200. Como as regras de caminho registradas ainda permanecem, os subsequentes restorecon também usarão esse padrão. Na prática, quando apenas o arquivo de teste foi alterado de volta para var_t e restorecon foi executado, ele retornou ao novo tipo da web e uma resposta 200 foi confirmada.

O manual oficial de semanage fcontext explica que os mapeamentos locais têm precedência sobre os mapeamentos de módulo de política, e as entradas locais são avaliadas da mais recente para a mais antiga. Adicionar um padrão desnecessariamente amplo, como /srv(/.*)?, pode afetar outros serviços. Não conceda um tipo gravável a conteúdo que só precisa ser lido.

Verifique o status do backend e compare o booleano de conexão.

Abra outro terminal para um usuário comum na mesma VM e execute o seguinte exemplo. Se a pasta de prática no diretório home já existir, pare. Mantenha este terminal aberto enquanto o servidor backend estiver em execução e pressione Ctrl+C para sair. O servidor HTTP padrão do Python 3.12 é para este teste local e não está configurado para ser implantado como um servidor web de produção.

bash <<'BASH'
set -eu
dir="$HOME/lf-web18-backend"
test ! -e "$dir"
mkdir -m 755 "$dir"
printf 'backend18-ok\n' > "$dir/index.html"
chmod 644 "$dir/index.html"
python3 -m http.server 18082 --bind 127.0.0.1 --directory "$dir"
BASH

De outro terminal da VM, faça uma requisição direta ao backend. Se o resultado não for 200, verifique o processo, endereço, porta e arquivos antes de alterar o booleano.

curl --noproxy '*' --max-time 5 -sS -w 'HTTP %{http_code}\n' \
  http://127.0.0.1:18082/
getsebool httpd_can_network_connect
curl --noproxy '*' --max-time 5 -sS -o /dev/null \
  -w 'HTTP %{http_code}\n' http://127.0.0.1:18081/backend/
sudo ausearch --input-logs -m AVC,USER_AVC -ts recent -c httpd -i

Na verificação, uma solicitação direta retornou backend18-ok e 200, mas a solicitação passada pelo Apache com o booleano off foi 503. O AVC registrou uma negação name_connect para a porta de destino 18082. Esse comportamento é diferente da negação na porta de recebimento name_bind.

Nesta prática privada, onde o valor original está desligado, o booleano atual é ligado para comparação e então imediatamente desligado. Este valor expande o alcance das conexões de rede permitidas pelo Apache, portanto, não é usado como um interruptor universal para corrigir erros 403 de arquivos estáticos.

sudo setsebool httpd_can_network_connect on
getsebool httpd_can_network_connect
curl --noproxy '*' --max-time 5 -sS -w 'HTTP %{http_code}\n' \
  http://127.0.0.1:18081/backend/
sudo setsebool httpd_can_network_connect off
getsebool httpd_can_network_connect
curl --noproxy '*' --max-time 5 -sS -o /dev/null \
  -w 'HTTP %{http_code}\n' http://127.0.0.1:18081/backend/
curl --noproxy '*' --max-time 5 -sS -w 'HTTP %{http_code}\n' \
  http://127.0.0.1:18082/

Quando ligado, a resposta do proxy mudou para backend18-ok e 200, e quando restaurado para desligado, retornou para 503. A última solicitação direta ainda foi 200, o que nos permitiu diferenciá-la de uma falha no backend. Na verificação automatizada de origem, o mesmo servidor Python foi executado e parado usando uma unidade systemd de uso único dedicada à prática, em vez do terminal em primeiro plano.

O manual setsebool explica que sem -P, a mudança afeta o valor atual e não é salva para a inicialização. Considere a persistência apenas após revisar o escopo necessário. Por exemplo, sudo setsebool -P httpd_can_network_connect on salva a configuração, mas a comparação de origem não executou essa alteração permanente. Preserve o valor original e as personalizações locais em um sistema existente.

Remova apenas as políticas que foram alteradas e compare com o estado original.

Pare o servidor backend com Ctrl+C em seu terminal, depois pare o Apache. O ambiente de origem originalmente não tinha mapeamentos de caminho local ou de portas e seu booleano de conexão estava desligado. Os comandos abaixo removem apenas as entradas adicionadas por este exercício . Não use --deleteall para excluir todas as personalizações locais.

sudo systemctl stop httpd
getsebool httpd_can_network_connect
sudo semanage fcontext -d '/srv/lf-web18(/.*)?'
sudo restorecon -Rv /srv/lf-web18
sudo semanage port -d -p tcp 18081
sudo semanage port -l -C
sudo semanage fcontext -l -C
sudo semanage boolean -l -C

Após remover as regras de caminho, você também precisa restaurar os rótulos reais para que os arquivos existentes se alinhem com os novos padrões. Este caminho agora retornou para var_t. Para exclusão de porta, remova apenas o mapeamento local que você adicionou em 18081. Se o ambiente tiver modificações em itens existentes, você deve restaurar o mapeamento original que registrou, em vez de apenas excluí-lo.

Verifique o conteúdo e os caminhos dos arquivos antes de removê-los. Certifique-se de que o novo arquivo de configuração do Apache corresponda ao conteúdo de prática descrito acima antes de excluir, e verifique se as diferenças na configuração principal são apenas uma única linha em Listen.

cat /srv/lf-web18/index.html
cat "$HOME/lf-web18-backend/index.html"
sudo cat /etc/httpd/conf.d/lf-course18.conf
sudo diff -u /root/selinux-lab18-before/httpd/conf/httpd.conf /etc/httpd/conf/httpd.conf

Execute a limpeza a seguir apenas depois de confirmar que todos os novos arquivos são para esta prática e que não há outras alterações na configuração principal. rmdir deve ter um diretório vazio para ter sucesso; se houver outros arquivos inesperados, pare como está e verifique.

sudo cp -a /root/selinux-lab18-before/httpd/conf/httpd.conf /etc/httpd/conf/httpd.conf
sudo rm -- /etc/httpd/conf.d/lf-course18.conf
sudo rm -- /srv/lf-web18/index.html
sudo rmdir /srv/lf-web18
rm -- "$HOME/lf-web18-backend/index.html"
rmdir "$HOME/lf-web18-backend"
sudo diff -r --no-dereference /root/selinux-lab18-before/httpd /etc/httpd
sudo semanage export | sudo cmp - /root/selinux-lab18-before/local-policy.txt
sudo ss -lntp '( sport = :18081 or sport = :18082 )'
systemctl is-active httpd
systemctl is-enabled httpd
getenforce

Após a limpeza no laboratório de origem, a configuração do Apache coincidiu com seu backup, incluindo os destinos de links simbólicos, e a exportação completa da política local coincidiu com o original. As portas 18081·18082 e os arquivos da prática desapareceram, e o Apache foi parado com a inicialização automática desativada. Os pacotes de ferramenta de gerenciamento adicionados foram mantidos, e o SELinux estava no modo Enforcing, com SSH, serviços de auditoria e o firewall original mantidos. --no-dereference foi usado para comparar sem seguir os links simbólicos relativos no backup até seus destinos reais.

Use etiquetas de arquivos para o caminho do conteúdo personalizado, tipos de porta para permissão de escuta e a política de conexão relevante para o backend. Relacione a operação falhada à sua ação AVC, altere apenas a política necessária e repita a mesma solicitação para estabelecer o que resolveu a falha.