스캐너 활성화 마법사
GitLab v19.6Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
요약
이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 스캐너 활성화 마법사를 사용하여 그룹의 프로젝트에 보안 구성 프로파일을 적용합니다. 스캐너 커버리지를 보려면 그룹에 대한 Developer, Maintainer, 또는 Owner 권한이 필요합니다.
이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참조합니다.
스캐너 활성화 마법사를 사용하여 그룹의 프로젝트에 보안 구성 프로파일을 적용합니다. 마법사는 의존성 스캐닝, SAST, 시크릿 탐지를 구성하고, 보안 인벤토리에 표시된 커버리지를 업데이트합니다.
사전 요구 사항:
-
스캐너 커버리지를 보려면 그룹에 대한 Developer, Maintainer, 또는 Owner 권한이 필요합니다.
-
스캐너를 활성화하려면 그룹에 대한 Security Manager, Maintainer, 또는 Owner 권한이 필요합니다.
스캐너 커버리지 보기#
Scanners 탭에는 그룹 내 모든 프로젝트의 스캐너 커버리지가 표시됩니다.
스캐너 커버리지를 보려면:
-
상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
-
왼쪽 사이드바에서 Secure > Security configuration을 선택합니다.
-
Scanners 탭을 선택합니다.
탭에는 다음 카드가 표시됩니다:
| 카드 | 설명 |
|---|---|
| Unprotected projects | 스캐너가 활성화되지 않은 프로젝트 목록. |
| Scanners enabled | 그룹에서 활성화된 모든 스캐너 유형의 수. |
| Needs attention | 스캔 실패가 있는 프로젝트 목록. |
| Stale scans | 기본 브랜치 파이프라인 연속 세 개 이상에서 스캐너가 누락된 프로젝트 목록. |
카드 아래에는 각 스캐너 유형 목록이 표시되며, 해당 스캐너가 활성, 실패, 또는 미구성 상태인 프로젝트 수를 나타냅니다.
스캐너 세부 정보 보기#
그룹 내 프로젝트에 대한 스캐너 상태를 보려면:
-
상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
-
왼쪽 사이드바에서 Secure > Security configuration을 선택합니다.
-
Scanners 탭을 선택합니다.
-
스캐너 옆에서 View details를 선택합니다.
스캐너 세부 정보 페이지에는 스캐너에 대한 통계 카드(Enabled, Not enabled, Needs attention, Stale)와 그룹 내 모든 프로젝트 표가 표시됩니다.
표에는 다음 칼럼이 표시됩니다:
| 칼럼 | 설명 |
|---|---|
| Project | 프로젝트 이름 및 경로. |
| Source | 사용 가능한 경우, 적용된 구성 프로파일 이름. |
| Status | 프로젝트의 현재 스캐너 상태. |
| Last scan | 가장 최근 스캔 시간. |
| Security attributes | 프로젝트에 할당된 보안 속성. 보안 속성을 읽을 수 있는 경우에만 표시됨. |
프로젝트에 대한 스캐너 구성#
프로파일 기반 구성을 사용하는 스캐너를 구성할 수 있습니다. 보안 정책이나 CI/CD 구성 등 다른 소스에서 온 스캐너를 구성하려면 해당 출처에서 조정해야 합니다.
프로젝트에 대한 스캐너를 구성하려면:
-
상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
-
왼쪽 사이드바에서 Secure > Security configuration을 선택합니다.
-
Scanners 탭을 선택합니다.
-
스캐너 옆에서 View details를 선택합니다.
-
프로젝트 옆에서 세로 줄임표( ellipsis_v )를 선택한 후 작업을 선택합니다:
Enable profile-based scanning: 프로젝트에 기본 프로파일을 적용합니다. 프로젝트에 No profile applied가 표시될 때 사용 가능합니다.
-
Disable profile-based scanning: 프로젝트에서 적용된 프로파일을 제거합니다.
-
View project configuration: 프로젝트의 보안 구성 페이지를 엽니다.
-
Troubleshoot failure: 가장 최근 스캔이 실패하거나 경고가 있는 경우 더 많은 세부 정보를 제공합니다.
-
스캐너 활성화 마법사 사용#
스캐너 활성화 마법사는 두 가지 방법을 제공합니다:
-
: 그룹에서 선택한 모드와 일치하는 프로젝트에 프로파일을 적용합니다. GitLab 기본 프로파일이 미리 선택되어 있으며, 스캐너마다 프로파일을 변경할 수 있습니다.
-
Advanced setup: 특정 프로젝트 및 스캐너에 선택한 프로파일을 적용합니다.
마법사는 DAST, 컨테이너 스캐닝, IaC 스캐닝을 구성하지 않습니다. 이러한 스캐너는 보안 정책 또는 프로젝트 수준에서 구성합니다.
빠른 설정#
히스토리
- 모드 단계가 GitLab 19.6에서
scanner_wizard_attach_modes라는 기능 플래그와 함께 도입되었습니다. 기본적으로 활성화되어 있습니다.
이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참고합니다.
빠른 설정을 사용하면 선택한 모드에 따라 그룹 전체에 프로파일을 적용합니다.
빠른 설정을 사용하려면 다음과 같이 합니다.
-
상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
-
왼쪽 사이드바에서 Secure > Security configuration을 선택합니다.
-
Scanners 탭을 선택합니다.
-
Enable scanners를 선택합니다.
-
Quick setup을 선택한 후 Start quick setup을 선택합니다.
-
단계에서 프로파일을 적용할 프로젝트를 선택합니다.
- : 모든 프로젝트에 프로파일을 적용합니다. 프로젝트에 해당 스캐너용으로 이미 있는 프로파일을 대체합니다. CI/CD 구성이나 보안 정책처럼 다른 방식으로도 스캔하는 프로젝트는 두 스캔을 모두 실행합니다.
- : 해당 스캐너의 프로파일도 없고 스캔도 없는 프로젝트에만 프로파일을 적용합니다. 이미 스캔하는 프로젝트는 현재 설정을 유지합니다. 이 모드가 기본으로 선택됩니다.
- : 해당 스캐너의 프로파일이 이미 있는 프로젝트에만 프로파일을 적용하고 그 프로파일을 대체합니다. 다른 프로젝트는 변경되지 않습니다.
GitLab은 스캐너마다 따로 확인합니다. 예를 들어 를 선택하면, SAST는 이미 실행하지만 시크릿 탐지는 실행하지 않는 프로젝트는 시크릿 탐지 프로파일을 받습니다.
-
선택 사항. 스캐너에 다른 프로파일을 사용하려면 Scanners 옆에서 (✏️)를 선택합니다. 단계의 드롭다운 목록에서 프로파일을 선택한 다음 를 선택합니다.
-
단계에서 스캐너와 모드를 검토합니다.
-
Apply configuration을 선택합니다.
구성을 적용하면 GitLab이 프로젝트에 프로파일을 일괄 적용하며, 몇 분이 걸릴 수 있습니다. 확인 단계에는 각 스캐너, 해당 프로파일, 각 프로파일이 적용되는 항목 수가 나열됩니다.
고급 설정#
고급 설정은 특정 프로젝트 및 스캐너에만 선택한 프로파일을 적용합니다. 한 번에 100개 이상의 프로젝트에 프로파일을 적용해야 하는 경우 빠른 설정을 사용합니다.
-
상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
-
왼쪽 사이드바에서 Secure > Security configuration을 선택합니다.
-
Scanners 탭을 선택합니다.
-
Enable scanners를 선택합니다.
-
Advanced setup을 선택한 후 Start advanced setup을 선택합니다.
-
Select projects 단계에서 구성할 프로젝트를 선택합니다. 검색 및 필터를 사용하여 프로젝트를 찾습니다. Scanner coverage 칼럼에 기존 커버리지가 표시됩니다. 최대 100개 항목을 선택할 수 있습니다.
-
Select scanners 단계에서 활성화할 스캐너를 선택합니다. 각 스캐너에 대해 적용할 구성 프로파일을 선택합니다.
-
Review configuration 단계에서 선택한 프로젝트와 스캐너를 검토합니다. 변경하려면 Items 옆에서 (✏️)를 선택하거나, Scanners 옆에서 (✏️)를 선택합니다.
-
Apply configuration을 선택합니다.
구성을 적용하면 GitLab이 프로젝트에 프로파일을 일괄 적용하며, 몇 분이 걸릴 수 있습니다. 확인 단계에는 각 스캐너, 해당 프로파일, 각 프로파일이 적용되는 항목 수가 나열됩니다.