프로젝트 액세스 토큰

인증, 생성, 취소 및 토큰 만료.

프로젝트 액세스 토큰은 특정 프로젝트에 대한 인증된 액세스를 제공합니다. 그룹 액세스 토큰 및 개인 액세스 토큰과 비슷하지만, 그룹이나 사용자가 아니라 연결된 프로젝트로 범위가 한정됩니다. 프로젝트 액세스 토큰으로는 다른 프로젝트의 리소스에 접근하거나 다른 그룹, 프로젝트, 개인 액세스 토큰을 생성할 수 없습니다. 프로젝트 액세스 토큰으로 다음과 같이 인증할 수 있습니다. GitLab API 로 인증합니다. HTTPS를 통한 Git으로 인증합니다. 다음과 같이 사용합니다. 사용자 이름에는 비어 있지 않은 임의의 값을 사용합니다. 비밀번호에는 프로젝트 액세스 토큰을 사용합니다. 사전 요구 사항: 프로젝트의 Maintainer 또는 Owner 권한. Note GitLab.com에서 프로젝트 액세스 토큰에는 Premium 또는 Ultimate 구독이 필요합니다. 체험판 기간에는 프로젝트 액세스 토큰을 하나만 사용할 수 있습니다. GitLab Self-Managed와 GitLab Dedicated에서는 모든 라이선스에서 프로젝트 액세스 토큰을 사용할 수 있습니다. 프로젝트 액세스 토큰 생성 # 히스토리 GitLab 17.6에서 buffered_token_expiration_limit 라는 기능 플래그 와 함께 최대 허용 수명 한도가 400일로 연장됨 . 기본적으로 비활성화되어 있습니다. GitLab 17.7에서 프로젝트 액세스 토큰 설명이 도입됨 . Feature flag 연장된 최대 허용 수명 한도의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참고합니다. 프로젝트 액세스 토큰을 생성하려면 다음 절차를 따릅니다. 상단 바에서 Search or go to 를 선택하고 프로젝트를 찾습니다. 왼쪽 사이드바에서 Settings > Access tokens 를 선택합니다. Add new token 을 선택합니다. Token name 에 이름을 입력합니다. 토큰 이름은 프로젝트를 볼 수 있는 권한이 있는 모든 사용자에게 표시됩니다. 선택 사항. Token description 에 토큰 설명을 입력합니다. Expiration date 에 토큰의 만료 날짜를 입력합니다. 토큰은 해당 날짜의 UTC 자정에 만료됩니다. 날짜를 입력하지 않으면 만료 날짜는 오늘로부터 365일 후로 설정됩니다. 기본적으로 만료 날짜는 오늘로부터 365일을 넘을 수 없습니다. GitLab 17.6 이상에서는 관리자가 액세스 토큰의 최대 수명을 변경 할 수 있습니다. 토큰의 권한을 선택합니다. 프로젝트 액세스 토큰 범위 를 하나 이상 선택합니다. Create project access token 을 선택합니다. 프로젝트 액세스 토큰이 표시됩니다. 프로젝트 액세스 토큰을 안전한 곳에 저장합니다. 페이지를 벗어나거나 새로 고치면 토큰을 다시 볼 수 없습니다. 모든 프로젝트 액세스 토큰은 개인 액세스 토큰에 설정된 기본 접두사 설정 을 상속합니다. Warning 프로젝트 액세스 토큰은 내부 사용자로 취급됩니다. 내부 사용자가 프로젝트 액세스 토큰을 생성하면 해당