For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
기본 탐색 메뉴
Theme

Codex Security 워크벤치 사용하기

Codex 데스크톱 앱에서 보안 스캔을 시작하고, 보안 이슈를 검토하고, 리포지터리의 스캔 기록을 확인하세요.

보안 워크벤치에서 스캔을 시작하고, 저장된 보안 이슈를 검토하고, 리포지터리의 스캔 기록을 확인할 수 있습니다. 각 스캔은 Codex 작업으로 실행되며, 해당 작업을 열면 활동 내역을 확인할 수 있습니다.

ChatGPT 데스크톱 앱에서 ChatGPT 드롭다운 메뉴를 열고 Codex를 선택하세요. Codex Security 플러그인을 설치하고 활성화한 다음 사이드바에서 보안을 선택하세요.

보안 항목이 보이지 않으면 Codex가 선택되어 있는지, 플러그인이 설치되고 활성화되어 있는지 확인하세요. 필요한 경우 데스크톱 앱과 플러그인을 업데이트하세요. 워크스페이스 관리자가 플러그인 사용을 허용하는지도 확인하세요.

스캔 시작하기

최상의 스캔 결과를 얻으려면 gpt-5.6-sol 모델을 사용하고 추론 수준을 xhigh로 설정하세요.

  1. 스캔을 열고 + 스캔을 선택하세요.
  2. 기존 리포지터리나 다른 폴더를 선택하세요.
  3. 리포지터리를 스캔하려면 코드베이스를, Git으로 관리하는 변경 사항을 검토하려면 변경 사항을 선택하세요.
  4. 스캔 범위를 설정하세요. 코드베이스에서는 리포지터리 전체 또는 특정 폴더를 선택하세요. 선택한 코드베이스를 여러 차례 검토하려면 심층 스캔을 켜세요. 변경 사항에서는 커밋하지 않은 변경 사항, 특정 커밋 또는 리비전 범위를 선택하세요. 변경 사항에는 심층 스캔을 사용할 수 없습니다.
  5. 모델과 추론 수준을 선택하세요. 위협 모델이나 배포 환경에 관한 세부 정보가 있으면 추가 컨텍스트에 입력하세요.
  6. 스캔 시작을 선택하세요.

보안 워크벤치에서 리포지터리를 선택하고 스캔을 설정하세요.

각 스캔 유형에 대한 자세한 내용은 보안 스캔 실행하기, 심층 보안 스캔 실행하기 또는 코드 변경 사항의 보안 검토하기를 참고하세요.

스캔 진행 상황 확인하기

스캔 페이지에는 현재 단계와 플러그인이 보고하는 진행 상황이 표시됩니다.

활동 보기를 선택하면 스캔을 실행하는 Codex 작업이 열립니다. 워크벤치를 나갔다가 스캔으로 돌아와도 저장된 스캔은 그대로 유지됩니다. 진행 중인 작업을 중지하려면 해당 스캔을 열고 스캔 중지를 선택하세요.

스캔이 완료되면 결과를 열어 스캔 대상과 리비전, 보안 이슈, 실제로 검사한 범위, 제공되는 보고서 산출물을 확인하세요.

스캔이 완료되면 보안 이슈와 심각도, 검사한 범위, 산출물을 확인하세요.

여러 스캔의 보안 이슈 검토하기

보안 이슈를 열면 여러 리포지터리의 스캔에서 저장된 보안 이슈를 살펴볼 수 있습니다. 목록을 검색하거나 필터링한 다음 이슈를 선택해 요약, 소스 코드에서 찾은 근거, 검증 내용, 영향을 확인하세요.

요약에서 보안 이슈의 세부 정보를 확인하세요. 수정안을 생성, 검토, 적용 또는 검증하려면 패치를 선택하세요. 보안 이슈를 해결하는 워크플로우는 보안 이슈 수정 및 검증하기를 참고하세요.

보안 이슈 탭에는 저장된 Codex Security 스캔에서 발견한 보안 이슈가 표시됩니다. 가져온 티켓과 그 밖의 기존 보안 이슈는 별도의 백로그 분류 워크플로우에서 다룹니다.

리포지터리 기록 확인하기

리포지터리를 열어 사용 가능한 리포지터리와 폴더를 살펴보세요. 리포지터리를 선택하면 스캔 기록, 가장 최근에 스캔한 리비전, 아직 해결되지 않은 보안 이슈를 확인할 수 있습니다. 리포지터리 상세 화면에서 이전 스캔을 열거나 해당 리포지터리의 보안 이슈를 확인하세요.

스캔 기록이 없는 리포지터리라면 상세 화면에서 스캔을 시작하거나 워크벤치에서 + 스캔을 선택하세요.

대화에서 스캔 시작하기

일반 대화에서도 Codex에 설치된 Codex Security 플러그인을 실행해 달라고 요청할 수 있습니다. 공유 플러그인 워크벤치를 사용하는 스캔은 스캔에 표시되므로 보안 워크벤치로 돌아와 진행 상황과 결과를 확인할 수 있습니다.

터미널에서 스캔을 실행하거나 자동화하는 방법은 Codex Security CLI 빠른 시작을 참고하세요.