GitLab Duo로 유출된 토큰 교체
GitLab v19.6Offering: GitLab.com, GitLab Self-Managed
요약
이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 시크릿 탐지가 코드에서 활성 상태의 GitLab 개인 액세스 토큰을 발견하면 취약점 세부 정보 페이지에서 해당 토큰을 교체할 수 있습니다. 세분화된 개인 액세스 토큰으로 API를 호출하는 경우 토큰에 다음 권한이 모두 있어야 합니다.
이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 기록을 참고합니다. 이 기능은 테스트용으로 제공되며 프로덕션 환경에서 사용할 준비가 되지 않았습니다.
시크릿 탐지가 코드에서 활성 상태의 GitLab 개인 액세스 토큰을 발견하면 취약점 세부 정보 페이지에서 해당 토큰을 교체할 수 있습니다. GitLab은 새 값을 GitLab Secrets Manager에 저장하고, GitLab Duo는 하드코딩된 토큰을 시크릿에 대한 참조로 대체하는 머지 리퀘스트를 엽니다. 새 토큰 값은 사용자에게 표시되지 않으며 GitLab Duo에도 전송되지 않습니다.
사전 요구 사항#
- GitLab Secrets Manager가 프로젝트에 활성화되어 있고 활성 상태여야 합니다.
- GitLab Duo Agent Platform의 사전 요구 사항을 충족해야 합니다.
- 프로젝트에 대해 Developer Flow가 켜져 있어야 합니다.
- 프로젝트에 대해 Security Manager, Maintainer 또는 Owner 권한이 있거나
admin_vulnerability권한이 있는 사용자 지정 역할이 있어야 합니다. - 프로젝트에서 시크릿을 생성할 권한이 있어야 합니다.
- 취약점은 세분화된 개인 액세스 토큰을 포함한 GitLab 개인 액세스 토큰에 대한 시크릿 탐지 취약점이어야 하며, 토큰 상태가 활성이어야 합니다. 클라우드 제공업체 키처럼 시크릿 탐지가 발견한 다른 시크릿에는 이 기능을 사용할 수 없습니다.
- 파이프라인 시크릿 탐지가 유효성 검사를 켠 상태로 실행되어야 합니다.
- 토큰을 소유하고 있거나 관리자 액세스 권한이 있어야 합니다.
세분화된 개인 액세스 토큰으로 API를 호출하는 경우 토큰에 다음 권한이 모두 있어야 합니다.
- 프로젝트에 대한
Secret: Create권한. - 사용자에 대한
Personal Access Token: Rotate권한.
유출된 토큰을 교체하고 코드 수정#
교체는 되돌릴 수 없습니다. 교체가 실행되는 즉시 유출된 토큰이 취소되며, 유출된 값을 여전히 사용하는 코드나 시스템은 작동을 멈춥니다.
유출된 토큰을 교체하려면 다음과 같이 합니다.
- 상단 바에서 를 선택하고 프로젝트를 찾습니다.
- 왼쪽 사이드바에서 > 를 선택합니다.
- 시크릿 탐지 취약점을 선택합니다.
- 오른쪽 상단에서 > 를 선택합니다.
- 선택 사항. 을 변경합니다. 기본 이름은
ROTATED_GITLAB_TOKEN_<vulnerability_id>입니다. 이름은 프로젝트 안에서 고유해야 하고 255자 이하여야 하며, 문자, 숫자, 밑줄(_)만 포함할 수 있습니다. - 를 선택합니다.
GitLab Duo가 코드를 업데이트하는 진행 상황을 따라가려면 을 선택합니다.
GitLab Secrets Manager에서 시크릿의 세부 정보를 보려면 을 선택합니다.
projectSecretCreateFromLeakedToken
GraphQL 뮤테이션으로도 토큰을 교체할 수 있습니다.
이 뮤테이션은 토큰을 교체하고 시크릿을 저장하지만 GitLab Duo 세션은 시작하지 않습니다.
토큰을 교체하면 일어나는 일#
유출된 토큰을 교체하면 GitLab은 다음을 수행합니다.
- 유출된 토큰을 취소하고 이름과 스코프가 같은 새 토큰을 생성합니다. 새 토큰의 수명은 교체한 날짜부터 계산하여 유출된 토큰과 같습니다.
- 새 토큰 값을 모든 환경과 브랜치에서 사용할 수 있는 프로젝트 시크릿으로 저장합니다. 시크릿 설명에는 토큰이 유출된 파일과 줄이 들어 있습니다.
- 취약점의 토큰 상태를 비활성으로 변경합니다.
- Developer Flow로 GitLab Duo 세션을 시작합니다.
플로는 다음을 수행하는 머지 리퀘스트를 엽니다.
- 파일에서 하드코딩된 토큰을 제거합니다.
- 토큰을 사용하는 각 CI/CD 잡에
gitlab_secrets_manager가 있는secrets:키워드를 추가합니다.
GitLab은 취약점 상태를 변경하지 않습니다. 머지 리퀘스트를 검토하고 머지한 뒤 취약점 상태를 변경하여 로 설정합니다.
GitLab Duo가 세션을 시작할 수 없는 경우에도 토큰은 교체되어 저장됩니다. 수정을 마치려면 하드코딩된 토큰을 직접 교체하고 CI/CD 잡에서 시크릿을 사용합니다.
GitLab Duo가 받는 정보#
GitLab Duo 세션을 시작하는 요청에는 다음이 포함됩니다.
- 프로젝트와 취약점.
- 토큰이 유출된 파일과 줄.
- 새 값을 저장하는 시크릿의 이름.
- GitLab Duo가 머지 리퀘스트를 사용자에게 할당할 수 있도록 사용자의 사용자 이름.
요청에는 유출된 토큰 값이나 새 토큰 값이 포함되지 않습니다. 하드코딩된 토큰을 제거하려면 GitLab Duo가 파일을 읽어야 하며, 이 파일에는 유출된 값이 들어 있습니다. 그 시점에 유출된 토큰은 이미 취소되어 있으며, GitLab Duo는 새 값을 받지 않습니다.
유출된 토큰을 사용하는 코드와 시스템#
유출된 토큰을 사용하는 코드와 시스템은 교체한 순간부터 새 토큰을 사용할 때까지 실패합니다.
- 프로젝트의 CI/CD 잡은 GitLab Duo가 만든 머지 리퀘스트를 머지한 뒤 다시 작동합니다.
- 시크릿은 이 프로젝트에만 저장되므로 다른 프로젝트의 CI/CD 잡에는 새 토큰이 필요합니다.
- UI를 통해 시크릿 값을 가져올 수 없으므로 GitLab CI/CD 밖의 시스템에는 새 토큰이 필요합니다.
다른 프로젝트와 시스템에는 개인 액세스 토큰을 생성합니다.
GitLab Credits 사용량#
이 기능은 다음에 대해 GitLab Credits를 소비합니다.
- 머지 리퀘스트를 여는 GitLab Duo Developer Flow 세션.
- 저장된 시크릿, 그리고 CI/CD 잡이 시크릿을 읽을 때마다. 자세한 내용은 GitLab Secrets Manager 크레딧 사용량을 참고합니다.
문제 해결#
Fix with AI를 사용할 수 없음#
시크릿 탐지 취약점에서 에 가 없는 경우 다음을 확인합니다.
secrets_manager_pat_rotation기능 플래그가 활성화되어 있습니다.- 취약점의 토큰 상태가 활성입니다. 토큰 상태는 유효성 검사에서 가져옵니다. 마지막 파이프라인이 실행된 뒤에 유효성 검사를 켰다면 새 파이프라인을 실행합니다.
- 프로젝트에 대해 Developer Flow가 켜져 있습니다.
- 프로젝트에 대해 Security Manager, Maintainer 또는 Owner 권한이 있거나
admin_vulnerability권한이 있는 사용자 지정 역할이 있습니다. - GitLab Duo Agent Platform의 요구 사항을 포함한 다른 사전 요구 사항을 충족합니다.
토큰이 교체되기 전의 오류#
GitLab은 토큰을 교체하기 전에 다음 조건을 확인합니다. 이러한 오류가 발생하면 유출된 토큰은 변경되지 않습니다. 원인을 해결한 다음 다시 시도합니다.
| 오류 | 원인 및 조치 |
|---|---|
Could not resolve a GitLab personal access token from this vulnerability |
발견 항목에 기존 개인 액세스 토큰과 일치하는 토큰이 없습니다. 토큰을 수동으로 취소합니다. |
Personal access token not found |
토큰이 더 이상 존재하지 않습니다. |
Token already revoked |
유출된 토큰은 이미 취소되었지만 취약점의 토큰 상태는 여전히 활성입니다. 토큰 상태를 새로 고칩니다. 교체할 필요는 없습니다. |
Failed to revoke token |
GitLab이 유출된 토큰을 취소할 수 없어서 아무것도 변경되지 않았습니다. 다시 시도합니다. |
Secrets manager is not active |
GitLab Secrets Manager를 활성화하거나 프로비저닝이 끝날 때까지 기다립니다. |
Secrets Manager cannot be written: entitlement state is <state> |
체험판이 종료되었거나 크레딧이 소진된 경우처럼 네임스페이스가 시크릿을 쓸 수 없습니다. GitLab Secrets Manager 크레딧 사용량을 참고합니다. |
Another secret operation in progress |
다른 작업이 끝날 때까지 기다린 다음 다시 시도합니다. |
오류: The token was rotated, but the new value could not be stored#
이 오류는 유출된 토큰은 취소되었지만 GitLab이 새 값을 GitLab Secrets Manager에 저장할 수 없었다는 뜻입니다. 메시지에는 저장에 실패한 이유가 포함됩니다. 두 경우 모두 유출된 토큰은 더 이상 작동하지 않습니다.
-
The token was rotated, but the new value could not be stored, so it was revoked. Create a new token manually.GitLab이 새 토큰을 취소했으므로 활성 토큰이 없습니다. 액세스를 복구하려면 개인 액세스 토큰을 생성하고 시크릿으로 저장합니다.
-
The token was rotated, but the new value could not be stored or revoked. Revoke the token named <name> manually.새 토큰은 여전히 활성 상태이지만 아무도 그 값을 가져올 수 없습니다. 메시지에 있는 이름으로 토큰을 취소합니다. 그런 다음 토큰을 생성하고 시크릿으로 저장합니다.
유출된 토큰은 이미 취소되었으므로 같은 토큰을 다시 교체할 필요가 없습니다.
오류: Failed to complete the rotation#
네트워크 오류 등으로 GitLab이 교체가 끝났는지 확인할 수 없었습니다. 다시 시도하기 전에 유출된 토큰이 취소되었는지 확인합니다.
- 취약점의 토큰 상태가 활성이면 토큰 상태를 새로 고칩니다. 토큰이 여전히 활성이면 다시 시도합니다.
- 토큰이 취소되었으면 Secrets Manager에서 시크릿을 확인합니다. 시크릿이 없으면 토큰을 생성하고 해당 토큰을 시크릿으로 저장합니다.
오류: GitLab Duo could not start 또는 GitLab Duo could not be reached#
토큰은 교체되어 저장되었지만 GitLab Duo 세션이 시작되지 않았습니다. 메시지에는 시크릿 이름이 포함됩니다.
이 문제를 해결하려면 GitLab Duo 문제를 해결합니다. 그런 다음 하드코딩된 토큰을 직접 교체하고 CI/CD 잡에서 시크릿을 사용합니다.