Enabling ASM for Nginx

이 페이지는 아직 한국어로 제공되지 않으며 번역 작업 중입니다. 번역에 관한 질문이나 의견이 있으시면 언제든지 저희에게 연락해 주십시오.

The Datadog nginx tracing module has experimental support for threat detection and blocking.

Enabling threat detection

Verify that your nginx build was compiled with the flag --with-threads. Most distributions ship with this flag enabled by default. To check if your nginx installation was built with thread support, run nginx -V and check the configure arguments line. If you cannot find --with-threads in the output, you will need to rebuild nginx with this flag enabled. For more information on how to build nginx from sources, see the nginx documentation.
Update your nginx tracing library module to at least version 1.2.0. Visit the GitHub releases page and select the artifact named according to the pattern “ngx_http_datadog_module-appsec-<amd64/arm64>-<nginx version>.so.tgz”. Note that this artifact includes “appsec” in the name.
Enable ASM in the nginx configuration. You need to:
- define one or more thread pools with the thread_pool directive,
- explicitly enable AppSec with datadog_appsec_enabled, and
- map requests to a thread pool or pools that you defined with the directive datadog_waf_thread_pool_name.
For example:
```
load_module /path/to/ngx_http_datadog_module.so;
thread_pool waf_thread_pool threads=4 max_queue=128;
http {
  datadog_appsec_enabled on;
  datadog_waf_thread_pool_name waf_thread_pool;
}
```
For more information, see the reference documentation.

이 구성을 완료하면 라이브러리가 애플리케이션에서 보안 데이터를 수집해 에이전트로 전송하고, 이 데이터는 다시 Datadog로 전송됩니다. 그러면 기본 감지 규칙에 기반해 공격자 기술과 잠재 구성 오류가 플래그되며, 이를 기반으로 문제 해결 단계를 진행할 수 있습니다.

애플리케이션 보안 관리에서 감지 활동을 잘 하고 있는지 확인하려면 알려진 공격 패턴을 애플리케이션으로 보내세요. 예를 들어 다음 curl 스크립트가 포함된 파일을 실행해 보안 스캐너 감지됨 규칙을 트리거할 수 있습니다.
```
for ((i=1;i<=250;i++)); 
do
# Target existing service’s routes
curl https://your-application-url/existing-route -A dd-test-scanner-log;
# Target non existing service’s routes
curl https://your-application-url/non-existing-route -A dd-test-scanner-log;
done
```
참고: dd-test-scanner-log 값은 최신 릴리스에서 지원됩니다.
애플리케이션을 활성화하고 실행한 몇 분 후 Application Signals Explorer에서 위협 정보가 표시되고 Vulnerability Explorer에 취약 정보가 표시됩니다.

As of version 1.3.0, the available functionality has the following important limitations:

The request body is not inspected, regardless of its content type.
It’s not possible to block the request based on characteristics of the response, such as its status code, headers, or body.