세밀한 개인 액세스 토큰

세밀한 개인 액세스 토큰(fine-grained personal access token)을 생성하고 사용 가능한 권한을 구성하는 방법을 설명합니다.

세밀한 개인 액세스 토큰 # - Tier: Free, Premium, Ultimate - Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated History GitLab 18.10에서 베타 로 도입됨 . GitLab 19.2에서 일반 공급 됨. 세밀한 개인 액세스 토큰은 사용자가 정의한 특정 리소스와 권한에만 액세스하도록 범위가 제한됩니다. 토큰을 생성할 때 다음 속성을 정의합니다: 리소스: API 작업의 모음입니다. 리소스는 더 큰 범위( Group and project , User , Global )로 그룹화됩니다. 권한: 토큰이 리소스에 대해 수행할 수 있는 특정 작업입니다. 일반적으로 생성(Create), 읽기(Read), 업데이트(Update), 삭제(Delete) 작업을 따릅니다. 세밀한 개인 액세스 토큰 생성 # 세밀한 개인 액세스 토큰을 생성하려면: 오른쪽 상단 모서리에서 아바타를 선택합니다. **프로필 편집(Edit profile)**을 선택합니다. 왼쪽 사이드바에서 액세스(Access) > **개인 액세스 토큰(Personal access tokens)**을 선택합니다. 토큰 생성(Generate token) 드롭다운 목록에서 **세밀한 토큰(Fine-grained token)**을 선택합니다. 이름(Name) 및 설명(Description) 필드를 작성합니다. 만료 날짜(Expiration date) 텍스트 상자에 토큰의 만료 날짜를 입력합니다. 토큰은 해당 날짜의 자정 UTC에 만료됩니다. 날짜를 입력하지 않으면, 만료 날짜는 오늘부터 365일로 설정됩니다. 기본적으로 만료 날짜는 오늘부터 최대 365일을 초과할 수 없습니다. GitLab 17.6 이상에서 관리자는 액세스 토큰의 최대 수명을 수정 할 수 있습니다. 그룹 또는 프로젝트 리소스를 추가하는 경우, **그룹 및 프로젝트 액세스(Group and project access)**에서 옵션을 선택합니다. **리소스 권한 추가(Add resource permissions)**에서: 그룹 및 프로젝트(Group and project) , 사용자(User) 또는 전역(Global) 탭을 사용하여 경계별로 리소스를 필터링합니다. 왼쪽 패널에서 하나 이상의 리소스를 선택합니다. 오른쪽 패널에서 각 리소스에 대해 사용 가능한 권한 을 선택합니다. **토큰 생성(Generate token)**을 선택합니다. 개인 액세스 토큰이 표시됩니다. 개인 액세스 토큰을 안전한 곳에 저장하세요. 페이지를 벗어나거나 새로 고침하면 다시 볼 수 없습니다. sudo로 사용자 가장하기 # 관리자는 REST API의 sudo 매개변수를 사용하여 다른 사용자를 가장할 수 있는 세밀한 개인 액세스 토큰을 생성할 수 있습니다. sudo 기능이 있는 토큰은 관리자만 생성할 수 있습니다. 관리자가 아닌 사용자가 이를 생성하려고 하면 오류가 발생합니다. 세밀한 토큰은 가장하는 동안에도 자체 권한을 계속 적용합니다. 토큰은 다음 두 조건이 모두 참일 때만