NGINX App Protect WAF 문제 해결 가이드

이 NGINX App Protect WAF 문제 해결 가이드는 사용자들이 NGINX App Protect WAF의 문제를 식별하고, 해결하는 데 도움을 주기 위해 작성되었습니다. 이 가이드는 NGINX App Protect WAF의 설치, 설정 과정의 문제 해결에 도움이 될 수도 있습니다.

NGINX App Protect WAF의 설치, 설정 관련 알려진 문제는 아래 표를 참고하세요.

목차

1. 알려진 NGINX App Protect WAF 문제 해결
2. SELinux
3. 기술 지원 접수하기

1. 알려진 NGINX App Protect WAF 문제 해결

{
    "policy": {
    ...
    }
}

2. SELinux

일부 운영 체제에서는 SELinux 또는 AppArmor 와 같은 보안 메커니즘이 기본적으로 활성화되어 nginx 프로세스와 waf-config-mgr, waf-enforcer 컨테이너의 필요한 파일 접근을 차단할 수 있습니다. NGINX App Protect WAF v5가 보안을 침해하지 않으면서 원활하게 작동하도록 하려면, 사용자 정의 SELinux 정책이나 AppArmor 프로필을 설정하는 것을 고려해 보세요. 단기적인 문제 해결을 위해 permissive(SELinux) 또는 complain(AppArmor) 모드를 사용하여 이러한 제한을 피할 수 있지만, 이는 보안을 약화하므로 장기간 사용하는 것은 권장되지 않습니다.

3. 기술 지원 접수하기

기술 지원 접수를 위해, NGINX App Protect WAF 문제 해결을 위한 정보를 하나의 디렉터리에 모으고 압축하여, 고객 지원 엔지니어에게 보내세요.

1. Docker compose 배포의 경우, 다음 명령어를 사용해 로그를 수집합니다

$ sudo docker compose logs > docker_compose_logs.txt

ELK stack과 같은 중앙 로깅 시스템을 사용 중이라면, 로그를 CSV 형식으로 수집합니다. (docker_compose_logs.csv)

2. Kubernetes 배포의 경우

아래 명령어/스크립트의 default를 사용자의 네임스페이스 이름으로 바꿔 사용합니다.

다음 명령어로 네임스페이스의 모든 pod 목록을 확인합니다.

$ kubectl get pods -n default

다음 스크립트를 사용하여 모든 pod로부터 로그를 수집합니다.

#!/bin/bash

set -x

# Define the namespace variable
NAMESPACE="default"

# Define a directory to store log files
log_dir="k8s_logs_$(date +%Y%m%d_%H%M%S)"
mkdir -p "$log_dir"

# Loop through all pods and containers, saving logs to the defined directory
for pod in $(kubectl get pods -n $NAMESPACE -o=name | sed 's|pod/||g'); do
    for container in $(kubectl get pod/$pod -n $NAMESPACE -o=jsonpath='{.spec.containers[*].name}'); do
        kubectl logs $pod -c $container -n $NAMESPACE > "${log_dir}/${pod}_${container}_logs.txt"
    done
done

echo "Logs collected and archived in ${log_dir}.tar.gz"

위 스크립트는 네임스페이스에 존재하는 각 pod 내부의 컨테이너별로 로그를 수집하여 별도의 파일로 저장합니다. 이 파일들의 이름은 pod와 컨테이너의 이름을 따서 설정되며, k8s_logs_<생성시간> 디렉터리에 저장됩니다.

3. NGINX가 호스트 머신에 직접 설치된 경우

• CentOS / RHEL / Amazon Linux / Oracle Linux

$ rpm -qa nginx* app-protect* > package_versions.txt

• Debian / Ubuntu

$ apt list --installed | grep -E 'nginx|app-protect' > package_versions.txt

• Alpine Linux

$ apk info -vv | grep -E 'nginx|app-protect' > package_versions.txt

• 다음 명령어를 사용하여 OS 정보를 수집합니다.

$ cat /etc/os-release > system_version.txt && uname -r >> system_version.txt && cat /proc/version >> system_version.txt

• /var/log/nginx/ 디렉터리의 NGINX 로그를 추가합니다

4. NGINX App Protect WAF 문제 식별을 위해 모든 정책과 로그 파일 설정을 추가합니다(JSON과 번들 파일들).

5. /etc/nginx/nginx.conf 파일을 포함한 모든 NGINX 설정 파일을 추가합니다.

6. 위 파일들을 모아놓은 디렉터리에서 다음 명령어를 사용하여 압축 파일을 생성합니다.

$ tar cvfz logs.tgz .

7. 기술 지원 문의에 logs.tgz 파일을 첨부합니다.