Vulnerability Context Flow
GitLab v19.6Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
요약
이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. Vulnerability Context Flow를 사용해 코드베이스를 읽고 다음 보안 범주에 대한 컨텍스트를 생성합니다. 플로를 켜면 사람이 기본 브랜치를 업데이트하는 푸시를 한 뒤 24시간에 최대 한 번 자동으로 실행됩니다.
이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참고합니다.
Vulnerability Context Flow를 사용해 코드베이스를 읽고 다음 보안 범주에 대한 컨텍스트를 생성합니다.
- 인증 모델
- 인가 모델
- 민감 데이터 분류
- 보안 경계
플로를 켜면 사람이 기본 브랜치를 업데이트하는 푸시를 한 뒤 24시간에 최대 한 번 자동으로 실행됩니다. 봇과 서비스 계정의 푸시, 브랜치 생성은 플로를 트리거하지 않습니다. 플로가 트리거되면 다음 과정을 완료합니다.
- 프로젝트의 코드베이스를 읽어 아키텍처와 보안 상태를 파악합니다.
- 각 보안 컨텍스트 범주에 대한 구조화된 출력을 생성합니다.
- 하위 보안 기능이 사용할 수 있도록 컨텍스트를 저장합니다.
분석은 백그라운드에서 실행됩니다. 이 플로를 수동으로 트리거하지 않습니다.
이 기능을 켜면 프로젝트의 소스 코드가 보안 컨텍스트를 생성하기 위한 분석 목적으로 대규모 언어 모델(LLM)에 전송됩니다. 이 기능을 켜기 전에 조직의 데이터 정책을 검토합니다.
사전 요구 사항#
- GitLab Duo Agent Platform 사전 요구 사항을 충족해야 합니다.
- 베타 및 실험 기능을 켭니다.
- 최상위 그룹에 대해 Allow foundational flows와 Vulnerability Context Flow를 켭니다.
- 서비스 계정을 허용하도록 푸시 규칙을 구성합니다.
- 자체 러너를 구성하거나 프로젝트에 GitLab 호스팅 러너를 켭니다.
- 사용자 환경설정에서 기본 GitLab Duo 네임스페이스를 설정합니다.
Vulnerability Context Flow 켜기#
이 기능을 사용하려면 루트 그룹에서 기반 플로를 켜고 프로젝트에서 기능을 켜야 합니다.
그룹에 기반 플로 허용#
그룹의 모든 프로젝트가 기반 플로를 사용하도록 허용할 수 있습니다. 개별 프로젝트는 여전히 프로젝트 설정에서 기능을 활성화해야 합니다.
그룹에 Vulnerability Context Flow를 허용하려면 다음과 같이 합니다.
- 왼쪽 사이드바에서 Search or go to를 선택하고 그룹을 찾습니다.
- Settings > GitLab Duo를 선택합니다.
- Allow foundational flows에서 Vulnerability Context Flow 체크박스를 선택합니다.
- Save changes를 선택합니다.
프로젝트에서 켜기#
사전 요구 사항:
- 프로젝트에 대한 Maintainer 또는 Owner 권한.
- 이름이 Duo Vulnerability Context로 시작하는 서비스 계정 사용자에 대해 프로젝트의 Developer, Maintainer 또는 Owner 권한.
프로젝트에 Vulnerability Context Flow를 허용하려면 다음과 같이 합니다.
- 왼쪽 사이드바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
- Settings > General을 선택합니다.
- GitLab Duo를 확장합니다.
- Turn on Vulnerability Context Flow 토글을 켭니다.
- Save changes를 선택합니다.
- 왼쪽 사이드바에서 Manage > Members를 선택합니다.
- 이름이 Duo Vulnerability Context로 시작하는 서비스 계정 사용자에게 프로젝트의 Developer, Maintainer 또는 Owner 권한이 있는지 확인합니다.
플로 끄기#
프로젝트에서 Vulnerability Context Flow를 끄면 기존 컨텍스트는 취약점 세부 정보 페이지의 Risk 섹션에 계속 표시됩니다. 플로는 컨텍스트 업데이트를 중단합니다. 플로를 꺼도 기존 컨텍스트는 삭제되지 않습니다.
플로가 스캔하는 보안 컨텍스트#
플로는 다음 범주의 컨텍스트를 생성합니다. 각 범주는 취약점의 영향을 평가하는 데 도움이 되는 구조화된 정보를 제공합니다.
- 인증:
Yes또는No. 구성 요소가 인증을 요구하는지 나타냅니다. - 인가:
Elevated또는Standard. 구성 요소를 악용하는 데 상승된 권한이 필요한지 나타냅니다. - 민감 데이터:
Yes또는No. 구성 요소가 개인 정보, 자격 증명, 토큰, 결제 데이터, 건강 데이터 같은 민감 데이터를 처리하는지 나타냅니다. - 보안 경계:
Network access,User input,Partner boundary,Trusted service,Internal only,Isolated중 하나 이상. 구성 요소가 어떤 신뢰 경계에 놓여 있는지, 그래서 취약한 코드가 신뢰할 수 없는 호출자에게 얼마나 노출되어 있는지 나타냅니다.
이 값은 취약점 세부 정보 페이지의 Risk 섹션에 표시됩니다.
지원되는 스캐너#
Vulnerability Context Flow가 생성한 보안 컨텍스트는 다음 스캐너와 기능에서 사용됩니다.
알려진 문제#
- 플로는 소스 코드만 분석합니다. 런타임 텔레메트리, 동적 분석 결과, 함수 수준 도달 가능성 데이터는 입력으로 사용되지 않습니다.
- 컨텍스트 생성은 리포지터리에서 사용할 수 있는 정보에 따라 달라집니다. 문서가 거의 없거나 비표준 구조를 가진 프로젝트는 덜 상세한 컨텍스트를 생성할 수 있습니다.
- 24시간 디바운스는 조건에 맞는 푸시를 받은 시점에 시작됩니다. 그 기간 안의 푸시는 새 분석을 트리거하지 않습니다. 실행이 실패하면 24시간 기간이 지나기 전까지 재시도되지 않습니다.