스캔 예약

예약 방식 비교

예약은 브라우저에 설정된 시간대를 기준으로 실행됩니다.

프로젝트별 스캔 예약

메뉴 경로: Projects > Overview > 프로젝트 행 > 더보기 > Schedule

프로젝트마다 예약을 따로 설정합니다.

1. 예약할 프로젝트 행 오른쪽의 더보기 메뉴를 엽니다.
2. Schedule을 선택합니다.
3. Cron Expression에 실행 주기를 초, 분, 시, 일, 월, 요일 순서로 입력합니다.
4. 스캔 종류를 한 개 이상 선택합니다.
5. 잠긴 항목이 있다면 해당 기능을 사용할 권한이 있는지 확인합니다.
6. Schedule을 선택합니다.
7. 예약 완료 메시지를 확인합니다.

예약 가능한 스캔

• SECRET
• SAST
• SCA
• IAC
• LICENSE

ROUTE, MCP, Skill, Repository는 프로젝트별 예약 창에서 선택할 수 없습니다.

스캔 종류를 여러 개 선택하면 종류별로 예약이 따로 생성됩니다. 예약명은 프로젝트와 브랜치 정보를 바탕으로 자동 생성됩니다.

프로젝트별 예약은 소스 변경 여부와 관계없이 실행을 요청합니다. 다만 같은 프로젝트와 스캔 종류의 작업이 이미 Pending(대기 중) 또는 Running(실행 중)이면 중복 작업을 만들지 않습니다.

실행 주기 직접 입력

Cron Expression에는 공백으로 구분한 6개의 값을 다음 순서로 입력합니다.

초 분 시 일 월 요일

기본 예시 0 0 0 * * 0은 매주 일요일 00:00 실행을 뜻합니다. 입력란 아래에 표시되는 설명이 원하는 주기와 맞는지 확인합니다. 입력 형식이 맞지 않으면 저장할 수 없습니다.

프로젝트별 예약 확인

Projects에서 확인

Projects 표의 Schedule 열은 기본적으로 숨겨져 있습니다. 열 표시 설정에서 켜면 다음을 확인할 수 있습니다.

• Scheduled 상태
• 예약된 스캔 종류
• 실행 주기 설명
• 저장된 시간대

Schedule 메뉴에서 확인하고 삭제하기

메뉴 경로: Schedule

Admin 또는 Super Admin은 다음 정보를 확인할 수 있습니다.

• 예약명
• 프로젝트와 브랜치
• 작업 종류
• 입력한 실행 주기와 화면에 표시되는 설명
• 생성일

예약명, 프로젝트, 작업 종류로 필터링할 수 있으며 단일 또는 여러 예약을 선택해 삭제할 수 있습니다.

전체 프로젝트 자동 스캔

메뉴 경로: Integrations > Settings > Scan Scheduling

전체 프로젝트 자동 스캔은 프로젝트별 예약과 별도로 동작하며, 등록된 모든 프로젝트를 대상으로 합니다.

1. Super Admin으로 Integrations를 엽니다.
2. Settings 카드의 Configure를 선택해 Scan Scheduling 화면을 엽니다.
3. Enable Scheduling을 켭니다.
4. Daily, Weekly, Custom 중 하나를 선택합니다.
5. 실행 시간 또는 직접 입력할 실행 주기를 설정합니다.
6. 화면에 표시되는 실행 주기를 확인합니다.
7. Save를 선택합니다.
8. 예약 활성화 완료 메시지를 확인합니다.

주기 선택

• Daily: 지정한 시각에 매일 한 번 실행합니다.
• Weekly: 지정한 요일과 시각에 매주 한 번 실행합니다.
• Custom: 실행 주기를 6개의 값으로 직접 입력합니다.

직접 입력 예시:

0 0 0 * * *      매일 00:00
0 */10 * * * *   10분마다
0 0 12 * * MON   매주 월요일 12:00

예약 시간이 되면 모든 프로젝트에 SECRET, SAST, SCA, IAC, LICENSE 스캔을 요청합니다. 이 화면에서는 스캔 종류를 바꿀 수 없습니다.

다음 경우에는 새 작업이 생성되지 않을 수 있습니다.

• 소스가 이전 스캔 이후 변경되지 않음
• 소스 변경 여부를 확인할 수 없음
• 같은 프로젝트와 스캔 종류의 작업이 이미 Pending(대기 중) 또는 Running(실행 중)임

Enable Scheduling을 끄고 저장하면 전체 프로젝트 자동 스캔 예약이 제거됩니다.

프로젝트별 예약을 삭제하거나 전체 프로젝트 자동 스캔을 비활성화하면 향후 실행만 중지됩니다. 이미 생성된 작업은 자동으로 취소되거나 삭제되지 않습니다.

시간대 확인

두 예약 방식 모두 브라우저에 설정된 시간대를 저장합니다.

• 예약을 생성하기 전에 운영 기준 시간대와 브라우저 시간대가 같은지 확인합니다.
• 다른 지역의 관리자가 예약을 다시 만들면 저장 시간대가 달라질 수 있습니다.
• 프로젝트별 예약은 Projects의 Schedule 열에서 저장된 시간대를 확인할 수 있습니다.

문제 해결

Schedule 메뉴나 버튼이 보이지 않음

Admin 또는 Super Admin 역할인지 확인합니다. 전체 프로젝트 자동 스캔 설정은 Super Admin만 접근할 수 있습니다.

예약할 스캔이 잠겨 있음

해당 기능을 사용할 권한이 있는지 확인합니다. 프로젝트별 예약에서 지원하지 않는 Route와 내부자 위협 스캔은 목록에 나타나지 않습니다.

직접 입력한 실행 주기를 저장할 수 없음

• 공백으로 구분한 값이 6개인지 확인합니다.
• 순서가 초 분 시 일 월 요일인지 확인합니다.
• Custom 입력에서는 화면의 예시와 오류 메시지를 참고합니다.

예상한 시각에 실행되지 않음

• 저장된 시간대를 확인합니다.
• 직접 입력한 요일, 시간, 분 값을 확인합니다.
• Jobs에서 해당 시간대에 작업이 생성되었는지 확인합니다.