프로젝트 액세스 토큰
- GitLab 13.0에 도입.
- GitLab 13.5에서 유료 그룹에 한해 GitLab.com에서 사용 가능.
- GitLab 13.5에서 특징 플래그가 제거됨.
- GitLab 14.5에서 변경. 기본 접두사가 추가됨.
- GitLab 16.1에서 평가 구독에서 사용 가능. 기본 접두사가 추가됨.
프로젝트 액세스 토큰은 암호와 비슷하지만 리소스에 대한 액세스를 제한하고 제한된 역할을 선택하며 만료 날짜를 제공할 수 있습니다.
프로젝트 액세스 토큰을 사용하여 다음을 인증하세요:
- GitLab API로.
- Git을 사용할 때 HTTP 기본 인증을 사용하는 경우:
- 빈 값이 아닌 어떤 값이든 사용자 이름으로.
- 프로젝트 액세스 토큰을 비밀번호로.
프로젝트 액세스 토큰은 그룹 액세스 토큰과 개인 액세스 토큰과 유사하지만 프로젝트 액세스 토큰은 프로젝트에 대해 범위가 지정되므로 다른 프로젝트의 리소스에 액세스할 수는 없습니다.
Self-managed 인스턴스에서 프로젝트 액세스 토큰은 제한이 설정된 경우 개인 액세스 토큰의 최대 수명 제한과 동일하게 적용됩니다.
프로젝트 액세스 토큰을 사용할 수 있습니다:
- GitLab SaaS에서: Premium 또는 Ultimate 라이선스 티어가 있으면 트라이얼 라이선스로 하나의 프로젝트 액세스 토큰이 사용 가능합니다.
- GitLab의 Self-managed 인스턴스에서: 모든 라이선스 티어로 사용할 수 있습니다. 프리 티어의 경우 프로젝트 액세스 토큰 생성 사용 중지를 고려하여 잠재적인 남용을 줄일 수 있습니다.
프로젝트 액세스 토큰으로 다른 그룹, 프로젝트 또는 개인 액세스 토큰을 생성할 수 없습니다.
프로젝트 액세스 토큰은 기본 접두어 설정을 상속받습니다.
프로젝트 액세스 토큰 생성
- GitLab 15.1에서 도입됨, 소유자는 프로젝트 액세스 토큰에 소유자 역할을 선택할 수 있습니다.
- GitLab 15.3에서 도입됨, 기본 만료 기간인 30일 및 기본 역할인 게스트가 UI에 자동으로 채워집니다.
- 영구적인 프로젝트 액세스 토큰 생성 기능이 GitLab 16.0에서 제거되었습니다.
프로젝트 액세스 토큰을 생성하려면:
- 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
- 설정 > 액세스 토큰을 선택합니다.
- 새 토큰 추가를 선택합니다.
- 이름을 입력하십시오. 토큰 이름은 프로젝트를 볼 수 있는 권한이 있는 모든 사용자에게 표시됩니다.
- 토큰의 만료 날짜를 입력합니다.
- 토큰은 그 날의 자정(UTC)에 만료됩니다.
- 또한, 만료 날짜를 입력하지 않으면 자동으로 현재 날짜로부터 30일 후가 만료 날짜로 설정됩니다.
- 기본적으로 이 날짜는 현재 날짜로부터 최대 365일 후일 수 있습니다.
- Self-managed 인스턴스에서는 최대 허용 수명을 제한할 수 있는 인스턴스 전체 최대 수명 설정이 적용될 수 있습니다.
- 토큰의 역할을 선택합니다.
- 원하는 범위를 선택합니다.
- 프로젝트 액세스 토큰 생성을 선택합니다.
프로젝트 액세스 토큰이 표시됩니다. 프로젝트 액세스 토큰을 안전한 위치에 저장하세요. 페이지를 나가거나 새로 고침한 후에는 다시 보지 못합니다.
프로젝트 액세스 토큰 취소
프로젝트 액세스 토큰을 취소하려면:
- 왼쪽 사이드바에서 검색 또는 이동를 선택하고 프로젝트를 찾습니다.
- 설정 > 액세스 토큰을 선택합니다.
- 취소할 프로젝트 액세스 토큰 옆에서 취소를 선택합니다 ().
프로젝트 액세스 토큰의 범위
k8s_proxy가 GitLab 16.4에서 특징 플래그와 함께 도입되어 기본으로 활성화되었습니다.- 특징 플래그
k8s_proxy_pat이 GitLab 16.5에서 제거되었습니다.
이 범위는 프로젝트 액세스 토큰으로 인증할 때 수행할 수 있는 작업을 결정합니다.
| 범위 | 설명 |
|---|---|
api
| 컨테이너 레지스트리, 의존성 프록시 및 패키지 레지스트리를 포함한 지정된 프로젝트 API에 대한 완전한 읽기 및 쓰기 액세스를 부여합니다. |
read_api
| 패키지 레지스트리를 포함한 지정된 프로젝트 API에 대한 읽기 액세스를 부여합니다. |
read_registry
| 프로젝트가 비공개이고 권한이 필요한 경우 컨테이너 레지스트리 이미지에 대한 읽기 액세스(추출)를 부여합니다. |
write_registry
| 컨테이너 레지스트리에 대한 쓰기 액세스(푸시)를 부여합니다. 이미지를 푸시하려면 읽기 및 쓰기 권한이 필요합니다. |
read_repository
| 리포지터리에 대한 읽기 액세스(추출)를 부여합니다. |
write_repository
| 리포지터리에 대한 읽기 및 쓰기 액세스(추출 및 푸시)를 부여합니다. |
create_runner
| 프로젝트에서 러너를 만들 권한을 부여합니다. |
ai_features
| GitLab Duo를 위한 API 작업을 수행할 수 있는 권한을 부여합니다. 이 범위는 JetBrains용 GitLab Duo 플러그인과 함께 작동하도록 설계되었습니다. 다른 확장 기능에 대한 요구 사항은 범위 요구 사항을 참조하세요. |
k8s_proxy
| 프로젝트의 쿠버네티스 에이전트를 사용하여 Kubernetes API 호출을 수행할 수 있는 권한을 부여합니다. |
프로젝트 액세스 토큰 생성 활성화 또는 비활성화
모든 프로젝트에 대해 최상위 그룹 내에서 프로젝트 액세스 토큰 생성을 활성화 또는 비활성화하려면 다음을 수행하세요:
- 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
- 설정 > 일반을 선택합니다.
- 권한 및 그룹 기능을 확장합니다.
- 권한에서 이 그룹에서 프로젝트 액세스 토큰 및 그룹 액세스 토큰을 만들 수 있는 사용자 확인란을 선택 또는 선택 해제합니다.
생성이 비활성화되더라도 기존의 프로젝트 액세스 토큰을 여전히 사용하고 취소할 수 있습니다.
프로젝트용 봇 사용자
프로젝트용 봇 사용자는 GitLab이 작성한 서비스 계정입니다. 프로젝트 액세스 토큰을 생성할 때마다 봇 사용자가 생성되어 프로젝트에 추가됩니다. 이 사용자는 과금되는 사용자가 아니므로 라이선스 한도에 포함되지 않습니다.
프로젝트용 봇 사용자는 프로젝트 액세스 토큰의 선택된 역할과 범위와 해당하는 권한을 갖습니다.
- 이름은 토큰의 이름으로 설정됩니다.
- 사용자 이름은
project_{project_id}_bot_{random_string}으로 설정됩니다. 예:project_123_bot_4ffca233d8298ea1. - 이메일은
project_{project_id}_bot_{random_string}@noreply.{Gitlab.config.gitlab.host}로 설정됩니다. 예:project_123_bot_4ffca233d8298ea1@noreply.example.com.
프로젝트 액세스 토큰을 사용하여 수행된 API 호출은 해당하는 봇 사용자와 연관됩니다.
프로젝트용 봇 사용자:
- 프로젝트의 멤버 디렉터리에 포함되지만 수정할 수 없습니다.
- 다른 프로젝트에 추가할 수 없습니다.
- 프로젝트에 대해 소유자의 최대 권한을 갖을 수 있습니다. 자세한 내용은 프로젝트 액세스 토큰 생성을 참조하세요.
프로젝트 액세스 토큰이 취소될 때:
- 봇 사용자가 삭제됩니다.
- 모든 레코드가 Ghost 사용자라는 사용자로 이동됩니다.
더 자세한 내용은 그룹용 봇 사용자도 참조하세요.
토큰 이용 가능성
여러 개의 프로젝트 액세스 토큰을 사용하려면 유료 구독이 필요합니다. Premium 및 Ultimate 체험 구독에서는 하나의 프로젝트 액세스 토큰만 포함되어 있습니다. 자세한 내용은 “GitLab 체험판 FAQ”의 “포함 사항” 섹션을 참조하세요.
도움말