시크릿 오탐지 감지
GitLab v19.5Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
요약
이 기능의 가용성은 기능 플래그로 제어됩니다. 시크릿 오탐지 감지는 옵트인 기능입니다. 이 기능을 활성화하면 탐지된 시크릿 주변의 코드 컨텍스트를 포함한 취약점 정보가 분석을 위해 대규모 언어 모델(LLM)로 전송됩니다.
히스토리
- GitLab 18.10에서
duo_secret_detection_false_positive라는 기능 플래그와 함께 에픽 17885에서 베타 기능으로 도입되었습니다. GitLab.com, GitLab Self-Managed, GitLab Dedicated에서 활성화되었습니다. - GitLab 19.1에서 일반 제공되었습니다.
- 트리아지 및 해결 프로필 지원이 GitLab 19.4에서
triage_and_remediation_profile이라는 기능 플래그와 함께 도입되었습니다. 기본적으로 활성화되어 있습니다.
이 기능의 가용성은 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참고합니다.
시크릿 오탐지 감지는 옵트인 기능입니다. 이 기능을 활성화하면 GitLab Duo가 탐지된 각 시크릿을 분석하여 오탐지일 가능성을 판단합니다. GitLab 시크릿 탐지가 탐지하는 모든 시크릿 유형에서 감지를 사용할 수 있습니다.
이 기능을 활성화하면 탐지된 시크릿 주변의 코드 컨텍스트를 포함한 취약점 정보가 분석을 위해 대규모 언어 모델(LLM)로 전송됩니다. 시크릿 탐지 및 편집 문서에 설명된 동작은 이 기능에 적용되지 않습니다. 이 기능을 활성화하기 전에 조직의 데이터 정책을 검토합니다.
GitLab Duo 평가에는 각 오탐지 결과에 대한 다음 정보가 포함됩니다.
- 신뢰도 점수: 결과가 오탐지일 가능성을 나타내는 수치 점수입니다.
- 설명: 코드 컨텍스트와 시크릿 특성을 근거로 결과가 실제 탐지이거나 아닐 수 있는 이유입니다.
- 시각적 표시: 오탐지 평가를 보여 주는 취약점 보고서의 배지입니다.
활성화하면 오탐지 감지는 각 보안 스캔 이후 수동 개입 없이 자동으로 실행됩니다.
결과는 AI 분석을 기반으로 하므로 보안 전문가의 검토가 필요합니다. 이 기능에는 활성 구독이 있는 GitLab Duo가 필요합니다.
보안 구성 프로필도 이 플로를 지원합니다. 여러 프로젝트와 그룹에서 한 번에 플로를 켜고 구성하려면 자동 트리아지 및 해결 프로필을 사용합니다.
자동 감지#
오탐지 감지는 다음 상황에서 자동으로 실행됩니다.
- 기본 브랜치에서 시크릿 탐지 스캔이 성공적으로 완료된 경우입니다.
- 스캔이 시크릿을 탐지한 경우입니다.
- 프로젝트에서 GitLab Duo 기능이 활성화된 경우입니다.
분석은 백그라운드에서 실행되며, 처리가 끝나면 취약점 보고서에 결과가 표시됩니다.
수동 실행#
기존 취약점에 대해 오탐지 감지를 수동으로 실행할 수 있습니다.
- 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
- 왼쪽 사이드바에서 Secure > Vulnerability report를 선택합니다.
- 분석할 취약점을 선택합니다.
- 오른쪽 상단에서 AI actions를 선택한 다음 Check for false positive를 선택합니다.
GitLab Duo 분석이 실행되고 취약점 세부 정보 페이지에 결과가 표시됩니다.
구성#
오탐지 감지를 사용하려면 다음 요구 사항을 충족해야 합니다.
- GitLab Duo 애드온 구독(GitLab Duo Core, Pro 또는 Enterprise)이 필요합니다.
- 프로젝트 또는 그룹에서 GitLab Duo가 활성화되어 있어야 합니다.
- 사용자 기본 설정에 기본 GitLab Duo 네임스페이스가 설정되어 있어야 합니다.
- GitLab 18.10 이상이어야 합니다.
오탐지 감지 활성화#
오탐지 감지는 기본적으로 꺼져 있으며 명시적으로 활성화해야 합니다. 활성화하면 주변 코드 컨텍스트를 포함한 취약점 정보가 분석을 위해 LLM으로 전송됩니다. 이 기능을 사용하려면 그룹에서 기초 플로를 허용하고 프로젝트에서 기능을 켜야 합니다.
그룹에서 기초 플로 허용#
그룹의 모든 프로젝트가 기초 플로를 사용하도록 허용할 수 있습니다. 개별 프로젝트는 프로젝트 설정에서 기능을 활성화해야 합니다. 그룹의 모든 프로젝트에 대해 오탐지 감지를 허용하려면 다음과 같이 진행합니다.
- 왼쪽 사이드바에서 Search or go to를 선택하고 그룹을 찾습니다.
- Settings > GitLab Duo를 선택합니다.
- Allow foundational flows 아래에서 Secret Detection False Positive Detection 체크박스를 선택합니다.
- Save changes를 선택합니다.
프로젝트에서 켜기#
사전 요구 사항:
- 프로젝트의 Security Manager, Maintainer 또는 Owner 권한이 필요합니다.
특정 프로젝트에서 오탐지 감지를 켜려면 다음과 같이 진행합니다.
- 왼쪽 사이드바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
- Settings > General을 선택합니다.
- GitLab Duo를 확장합니다.
- Turn on secret detection false positive detection 토글을 켭니다.
- Save changes를 선택합니다.
그룹에서 오탐지 감지를 허용하고 프로젝트에서 켜면, 기존 시크릿 탐지 스캐너와 함께 기능이 자동으로 동작합니다.
신뢰도 점수#
신뢰도 점수는 GitLab Duo 평가가 정확할 가능성을 추정한 값입니다.
- 오탐지 가능성 높음(80-100%): GitLab Duo가 결과를 오탐지로 매우 확신합니다.
- 오탐지 가능성 있음(60-79%): GitLab Duo가 결과를 오탐지로 볼 여지가 있다고 판단하지만 수동 검토를 권장합니다.
- 오탐지 가능성 낮음(<60%): GitLab Duo가 결과를 오탐지로 확신하지 않습니다. 취약점을 무시하기 전에 수동 검토를 강력히 권장합니다.
오탐지 무시#
GitLab Duo 분석이 취약점을 오탐지로 식별하면 다음 선택지가 있습니다.
- 취약점 무시
- 오탐지 플래그 제거
취약점 무시#
- 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
- 왼쪽 사이드바에서 Secure > Vulnerability report를 선택합니다.
- 무시할 취약점을 선택합니다.
- 오른쪽 사이드바의 Status 섹션에서 Edit를 선택합니다.
- Status 드롭다운 목록의 Dismiss as... 아래에서 False positive를 선택합니다.
- Comment 텍스트 상자에 오탐지로 무시하는 이유를 입력합니다. 댓글은 필수입니다.
- Change status를 선택합니다.
취약점은 무시됨으로 표시되며, 다시 도입되지 않는 한 이후 스캔에 나타나지 않습니다.
오탐지 플래그 제거#
오탐지 평가를 제거하고 취약점은 유지하려면 다음과 같이 진행합니다.
- 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
- 왼쪽 사이드바에서 Secure > Vulnerability report를 선택합니다.
- 오탐지 플래그가 있는 취약점을 찾습니다.
- 취약점의 오탐지 배지 위에 마우스를 올립니다.
- Remove False Positive Flag를 선택합니다.
오탐지 플래그가 제거되고 FP 신뢰도 점수가 0으로 돌아갑니다. 취약점은 보고서에 그대로 남으며 이후 스캔에서 다시 평가될 수 있습니다.
피드백 제공#
이슈 592861에서 피드백을 공유합니다.