심층 보안 스캔 실행
저장소나 폴더의 보안을 반복해서 검토하고 동시 실행 수와 실행 시간을 제한합니다.
심층 스캔은 동일한 저장소나 폴더에서 여러 개의 독립적인 표준 스캔을 실행하고 발견 사항을 통합합니다. 반복 검토가 필요하고 추가 실행 시간과 토큰 사용량을 감당할 수 있을 때 사용하세요.
먼저 표준 스캔을 실행하여 범위와 보안 컨텍스트가 목표에 맞는지 확인하세요. 반복 검토는 이전 검토에서 놓친 문제를 찾을 수 있지만, 모든 문제의 탐지나 실행 간 동일한 결과를 보장하지는 않습니다.
표준 스캔과 심층 스캔 중 선택
| 표준 스캔 | 심층 스캔 | |
|---|---|---|
| 검토 | 표준 스캔 1회 | 여러 표준 스캔의 발견 사항 통합 |
| 용도 | 첫 스캔 또는 정해진 범위의 검토 | 해당 범위에 대한 추가 독립 검토 |
| 범위 | 저장소 또는 폴더 | 저장소 또는 폴더 |
| 변경 사항 | 변경 사항 검토 워크플로 사용 | 지원되지 않음 |
심층 스캔 시작
최상의 스캔 품질을 얻으려면 gpt-5.6-sol을 사용하고
추론 수준을 xhigh로 설정하세요.
- Security > 스캔 을 열고 + 스캔 을 선택하세요.
- 저장소나 폴더를 선택하고 코드베이스 를 선택한 다음 심층 스캔 을 켜세요. 스캔은 선택한 저장소나 폴더 전체를 검토합니다.
- 모델과 추론 수준을 선택하세요. 추가 컨텍스트 에 위협 모델이나 배포 컨텍스트를 추가하세요.
- 스캔 시작 을 선택하세요.
Codex 대화에서도 시작할 수 있습니다.
Use $codex-security:deep-security-scan to run a deep security scan of this repository.컴포넌트 하나를 대상으로 하려면 "this repository"를 해당 폴더의 경로로 바꾸세요.
심층 스캔 작업자는 선택한 모델과 추론 설정을 상속합니다. 각 작업자는 전체 표준 스캔을 실행하고, Codex Security는 완료된 결과를 취합합니다. 스캔 에서 저장된 스캔의 진행 상황을 확인하거나 활동 보기 를 선택해 해당 Codex 작업을 살펴보세요. 동시 실행 수나 실행 시간을 제한해야 한다면 시작 전에 런타임 제한을 설정하세요.
결과 검토
심층 스캔은 표준 스캔과 동일한 저장된 스캔 세부 정보와 전체 스캔 디렉터리를
사용합니다. 스캔 에서 완료된 스캔을 열거나 발견 사항 에서
발견 사항을 검토하세요. 해당 출력을 요청하면 생성된 report.md에서 상세 취약점 보고서
또는 구조적 보안 강화 지침으로 연결됩니다.
결과를 공유하거나 보관할 때는 연결된 findings/ 및 hardening/ 디렉터리를
보고서와 함께 보관하세요.
발견 사항을 검토하기 전에 검사 범위 요약을 확인하세요. 심층 스캔에도 한계가 있으므로, 결론을 내리기 전에 검토가 보류된 영역과 아직 입증되지 않은 부분을 확인하세요. 수용한 발견 사항은 발견 사항 수정 및 검증으로 진행하세요.
풀 리퀘스트, 커밋, 브랜치 범위 또는 로컬 패치를 검토하려면 코드 변경 사항 검토를 사용하세요. 심층 스캔은 diff 대상을 지원하지 않습니다.
심층 스캔 실행 시간 구성
심층 스캔의 동시 실행 수와 지속 시간을 제어하려면
~/.codex/codex-security/config.toml을 생성하거나 편집하세요. CODEX_HOME을 설정하는 경우에는
대신 $CODEX_HOME/codex-security/config.toml을 사용하세요.
예를 들어 다음 프로필은 제한된 동시 실행 수로 더 짧은 스캔을 실행합니다.
[deep_scan]
workers = 2
subagents = 0
stop_after_no_new = 3
max_discovery_runs = 10
max_time_hours = 1.5| 설정 | 기본값 | 설명 |
|---|---|---|
workers |
4 |
동시에 실행할 수 있는 독립적인 표준 스캔 워커의 수입니다. 레거시 "auto"도 4로 해석됩니다. |
subagents |
3 |
각 워커가 시작할 수 있는 하위 에이전트의 수입니다. 비활성화하려면 0으로 설정하세요. |
stop_after_no_new |
4 |
완료된 워커 스캔에서 새로운 발견 사항이 나오지 않는 상태가 이 횟수만큼 연속되면 중지합니다. |
stop_after_consecutive_errors |
3 |
워커 오류가 이 횟수만큼 연속되면 중지합니다. |
max_discovery_runs |
40 |
집계 전에 실행할 독립적인 표준 스캔 횟수를 제한합니다. |
max_time_hours |
96 |
워커 실행 시간을 96 이하의 양수 시간으로 제한합니다. 필요에 따라 소수를 사용할 수 있습니다. |
값을 낮추면 스캔 시간과 토큰 사용량을 줄일 수 있지만 발견 사항을 놓칠 수 있습니다. 구성 변경 사항은 새 심층 스캔에 적용되며 이미 진행 중인 스캔에는 적용되지 않습니다.
시간 제한이 만료되면 Codex Security는 완료되지 않은 워커를 중지하고 완료된 스캔 결과를 보존한 뒤 최종 보고서에 집계합니다. 기한 전에 소스 검토를 마친 워커가 없으면 보고서에 부분적인 검사 범위가 기록됩니다.
max_time_hours 설정을 사용하려면 플러그인 버전 0.1.19 이상이 필요합니다. 릴리스 세부 정보는
플러그인 변경 로그를 참조하세요.