문제 해결

`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됩니다. 새 Configuration에서는 다음 두 값만 사용하십시오.

normal
high

`/24`보다 큰 Target Network가 거부되는 경우

Safety Guardrail입니다. Large Target Override와 Host Cap을 모두 지정해야 합니다.

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 .

Retired 상태인 release/v1.4.0 Branch로 돌아가지 마십시오.

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

Extension을 확인합니다.

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

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

Webshell Run에서 Remote Artifact를 쓸 수 없는 경우

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

/tmp/dsp

Remote Path는 Scenario Execution 및 Event Bundle을 Staging하는 데 사용됩니다.

HTTPS Webshell Certificate 문제

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

--verify-tls

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

Run은 완료되었지만 Alert이 보이지 않는 경우

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

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

DSP Evidence 자체를 확인하기 전에 Vendor Alert이 없다는 이유만으로 DSP Execution Failure로 판단하지 마십시오.

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

저장된 Run에서 Report를 재생성합니다.

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 Evidence를 수집하기 전에 현재 설치 상태를 확인할 때 특히 유용합니다.

시작하기

POC 가이드

설치 및 운영

참조

문제 해결

문제 해결

`dsp: command not found`

Graphical TUI 없이 Menu가 열리는 경우

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

`/24`보다 큰 Target Network가 거부되는 경우

Menu에서 오래된 `normal` Profile Volume을 보고하는 경우

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

Webshell Run에서 Remote Artifact를 쓸 수 없는 경우

HTTPS Webshell Certificate 문제

Run은 완료되었지만 Alert이 보이지 않는 경우

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

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

​문제 해결

​dsp: command not found

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

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

​/24보다 큰 Target Network가 거부되는 경우

​Menu에서 오래된 normal Profile Volume을 보고하는 경우

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

​Webshell Run에서 Remote Artifact를 쓸 수 없는 경우

​HTTPS Webshell Certificate 문제

​Run은 완료되었지만 Alert이 보이지 않는 경우

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

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

문제 해결

`dsp: command not found`

Graphical TUI 없이 Menu가 열리는 경우

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

`/24`보다 큰 Target Network가 거부되는 경우

Menu에서 오래된 `normal` Profile Volume을 보고하는 경우

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

Webshell Run에서 Remote Artifact를 쓸 수 없는 경우

HTTPS Webshell Certificate 문제

Run은 완료되었지만 Alert이 보이지 않는 경우

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

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