문제 해결

`dsp: command not found`

Repository Virtual Environment를 활성화하거나 Editable Package를 다시 설치합니다.

cd /path/to/xdr-poc-script
python3 -m venv .venv
.venv/bin/pip install -e .
source .venv/bin/activate

dsp --version

Operator Menu는 Environment가 존재하면 자동으로 <repo>/.venv/bin을 PATH에 추가합니다. whiptail을 설치합니다.

sudo apt install -y whiptail

whiptail이 없어도 DSP는 동작하며 Menu는 일반 번호 선택형 Terminal Interface로 전환됩니다.

`low` Profile이 `normal`처럼 동작하는 경우

현재 v1.4.0 Runtime에서는 정상적인 동작입니다. low는 Legacy Alias이며 normal로 Normalize됩니다. 새 설정에서는 다음 두 값만 사용하십시오.

normal
high

`/24`보다 큰 대상 네트워크가 거부되는 경우

안전을 위한 제한입니다. 큰 네트워크 허용 옵션과 호스트 수 제한을 모두 지정해야 합니다.

dsp run \
  --profile high \
  --target-net 10.0.0.0/16 \
  --allow-large-target \
  --max-hosts 10

현재 Menu에는 오래된 Checkout/Editable Install을 방지하는 Preflight Check가 포함되어 있습니다. Update latest patch를 선택한 뒤 필요한 경우 Editable Install을 갱신합니다.

cd /path/to/xdr-poc-script
git fetch origin
git checkout release/v1.4.0-rc
git pull origin release/v1.4.0-rc
.venv/bin/pip install -e .

더 이상 사용하지 않는 release/v1.4.0 Branch로 돌아가지 마십시오.

Webshell Family와 URL이 일치하지 않는 경우

Extension을 확인합니다.

jsp  → .../shell.jsp
php  → .../shell.php
aspx → .../shell.aspx

JSP와 PHP는 검증된 Family입니다. ASPX는 Preview 상태입니다.

Webshell 실행에서 원격 작업 파일을 만들 수 없는 경우

--remote-work-dir이 원격 호스트의 쓰기 가능한 위치를 가리키는지 확인합니다. Linux에서 검증된 기본값은 다음과 같습니다.

/tmp/dsp

원격 경로는 시나리오 실행과 이벤트 번들 준비하는 데 사용됩니다.

HTTPS Webshell Certificate 문제

Certificate Validation이 필요한 경우 다음 옵션을 사용합니다.

--verify-tls

Self-signed Certificate를 의도적으로 사용하는 Lab에서는 검증 정책을 임의로 변경하지 말고 고객과 TLS Policy를 먼저 합의하십시오.

실행은 완료됐지만 Alert이 보이지 않는 경우

DSP 실행 성공과 보안 제품의 Alert 발생은 서로 다른 계층입니다. 다음 순서로 확인합니다.

traffic_summary.json — 의도한 활동이 실제 생성되었는가?
events.db / events.jsonl — DSP Event가 기록되었는가?
validation.json — DSP 자체 검증이 통과했는가?
보안 플랫폼에서 Time Window와 Source/Destination Address 확인
Sensor/Collector Visibility 및 Policy Scope 확인
XDR/NDR Detection/Rule Configuration 확인

DSP 실행 기록을 확인하기 전에 보안 제품의 Alert이 없다는 이유만으로 DSP 실행 실패라고 판단하지 마십시오.

`report.md`가 없거나 다시 생성해야 하는 경우

저장된 실행 기록에서 보고서를 재생성합니다.

dsp report --run-id <run_id>

정확한 설치 상태를 확인해야 하는 경우

Menu의 Show version/status를 사용하거나 다음 명령을 실행합니다.

git branch --show-current
git log -1 --oneline
dsp --version
dsp plugins list
cat ~/.dsp/config.env

고객 POC 검증 자료를 수집하기 전에 현재 설치 상태를 확인할 때 특히 유용합니다.

시작하기

POC 가이드

설치 및 운영

참조

문제 해결

문제 해결

`dsp: command not found`

Graphical TUI 없이 Menu가 열리는 경우

`low` Profile이 `normal`처럼 동작하는 경우

`/24`보다 큰 대상 네트워크가 거부되는 경우

Menu에서 이전 `normal` 프로필 실행량을 보고하는 경우

Webshell Family와 URL이 일치하지 않는 경우

Webshell 실행에서 원격 작업 파일을 만들 수 없는 경우

HTTPS Webshell Certificate 문제

실행은 완료됐지만 Alert이 보이지 않는 경우

`report.md`가 없거나 다시 생성해야 하는 경우

정확한 설치 상태를 확인해야 하는 경우

​문제 해결

​dsp: command not found

​Graphical TUI 없이 Menu가 열리는 경우

​low Profile이 normal처럼 동작하는 경우

​/24보다 큰 대상 네트워크가 거부되는 경우

​Menu에서 이전 normal 프로필 실행량을 보고하는 경우

​Webshell Family와 URL이 일치하지 않는 경우

​Webshell 실행에서 원격 작업 파일을 만들 수 없는 경우

​HTTPS Webshell Certificate 문제

​실행은 완료됐지만 Alert이 보이지 않는 경우

​report.md가 없거나 다시 생성해야 하는 경우

​정확한 설치 상태를 확인해야 하는 경우

문제 해결

`dsp: command not found`

Graphical TUI 없이 Menu가 열리는 경우

`low` Profile이 `normal`처럼 동작하는 경우

`/24`보다 큰 대상 네트워크가 거부되는 경우

Menu에서 이전 `normal` 프로필 실행량을 보고하는 경우

Webshell Family와 URL이 일치하지 않는 경우

Webshell 실행에서 원격 작업 파일을 만들 수 없는 경우

HTTPS Webshell Certificate 문제

실행은 완료됐지만 Alert이 보이지 않는 경우

`report.md`가 없거나 다시 생성해야 하는 경우

정확한 설치 상태를 확인해야 하는 경우