InfoGrab DocsInfoGrab Docs

GitLab Duo로 유출된 토큰 교체

요약

이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 시크릿 탐지가 코드에서 활성 상태의 GitLab 개인 액세스 토큰을 발견하면 취약점 세부 정보 페이지에서 해당 토큰을 교체할 수 있습니다. 세분화된 개인 액세스 토큰으로 API를 호출하는 경우 토큰에 다음 권한이 모두 있어야 합니다.

히스토리
  • GitLab 19.6에서 베타로 secrets_manager_pat_rotation이라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다.
Feature flag

이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 기록을 참고합니다. 이 기능은 테스트용으로 제공되며 프로덕션 환경에서 사용할 준비가 되지 않았습니다.

시크릿 탐지가 코드에서 활성 상태의 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 권한.

유출된 토큰을 교체하고 코드 수정#

Warning

교체는 되돌릴 수 없습니다. 교체가 실행되는 즉시 유출된 토큰이 취소되며, 유출된 값을 여전히 사용하는 코드나 시스템은 작동을 멈춥니다.

유출된 토큰을 교체하려면 다음과 같이 합니다.

  1. 상단 바에서 를 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 > 를 선택합니다.
  3. 시크릿 탐지 취약점을 선택합니다.
  4. 오른쪽 상단에서 > 를 선택합니다.
  5. 선택 사항. 을 변경합니다. 기본 이름은 ROTATED_GITLAB_TOKEN_<vulnerability_id>입니다. 이름은 프로젝트 안에서 고유해야 하고 255자 이하여야 하며, 문자, 숫자, 밑줄(_)만 포함할 수 있습니다.
  6. 를 선택합니다.

GitLab Duo가 코드를 업데이트하는 진행 상황을 따라가려면 을 선택합니다.

GitLab Secrets Manager에서 시크릿의 세부 정보를 보려면 을 선택합니다.

projectSecretCreateFromLeakedToken GraphQL 뮤테이션으로도 토큰을 교체할 수 있습니다. 이 뮤테이션은 토큰을 교체하고 시크릿을 저장하지만 GitLab Duo 세션은 시작하지 않습니다.

토큰을 교체하면 일어나는 일#

유출된 토큰을 교체하면 GitLab은 다음을 수행합니다.

  1. 유출된 토큰을 취소하고 이름과 스코프가 같은 새 토큰을 생성합니다. 새 토큰의 수명은 교체한 날짜부터 계산하여 유출된 토큰과 같습니다.
  2. 새 토큰 값을 모든 환경과 브랜치에서 사용할 수 있는 프로젝트 시크릿으로 저장합니다. 시크릿 설명에는 토큰이 유출된 파일과 줄이 들어 있습니다.
  3. 취약점의 토큰 상태를 비활성으로 변경합니다.
  4. 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 잡에서 시크릿을 사용합니다.

GitLab Duo로 유출된 토큰 교체

GitLab v19.6
Tier: Ultimate
Offering: GitLab.com, GitLab Self-Managed
원문 보기

요약

이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 시크릿 탐지가 코드에서 활성 상태의 GitLab 개인 액세스 토큰을 발견하면 취약점 세부 정보 페이지에서 해당 토큰을 교체할 수 있습니다. 세분화된 개인 액세스 토큰으로 API를 호출하는 경우 토큰에 다음 권한이 모두 있어야 합니다.

히스토리
  • GitLab 19.6에서 베타로 secrets_manager_pat_rotation이라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다.
Feature flag

이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 기록을 참고합니다. 이 기능은 테스트용으로 제공되며 프로덕션 환경에서 사용할 준비가 되지 않았습니다.

시크릿 탐지가 코드에서 활성 상태의 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 권한.

유출된 토큰을 교체하고 코드 수정#

Warning

교체는 되돌릴 수 없습니다. 교체가 실행되는 즉시 유출된 토큰이 취소되며, 유출된 값을 여전히 사용하는 코드나 시스템은 작동을 멈춥니다.

유출된 토큰을 교체하려면 다음과 같이 합니다.

  1. 상단 바에서 를 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 > 를 선택합니다.
  3. 시크릿 탐지 취약점을 선택합니다.
  4. 오른쪽 상단에서 > 를 선택합니다.
  5. 선택 사항. 을 변경합니다. 기본 이름은 ROTATED_GITLAB_TOKEN_<vulnerability_id>입니다. 이름은 프로젝트 안에서 고유해야 하고 255자 이하여야 하며, 문자, 숫자, 밑줄(_)만 포함할 수 있습니다.
  6. 를 선택합니다.

GitLab Duo가 코드를 업데이트하는 진행 상황을 따라가려면 을 선택합니다.

GitLab Secrets Manager에서 시크릿의 세부 정보를 보려면 을 선택합니다.

projectSecretCreateFromLeakedToken GraphQL 뮤테이션으로도 토큰을 교체할 수 있습니다. 이 뮤테이션은 토큰을 교체하고 시크릿을 저장하지만 GitLab Duo 세션은 시작하지 않습니다.

토큰을 교체하면 일어나는 일#

유출된 토큰을 교체하면 GitLab은 다음을 수행합니다.

  1. 유출된 토큰을 취소하고 이름과 스코프가 같은 새 토큰을 생성합니다. 새 토큰의 수명은 교체한 날짜부터 계산하여 유출된 토큰과 같습니다.
  2. 새 토큰 값을 모든 환경과 브랜치에서 사용할 수 있는 프로젝트 시크릿으로 저장합니다. 시크릿 설명에는 토큰이 유출된 파일과 줄이 들어 있습니다.
  3. 취약점의 토큰 상태를 비활성으로 변경합니다.
  4. 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 잡에서 시크릿을 사용합니다.