세분화된 개인 액세스 토큰
세분화된 개인 액세스 토큰(fine-grained personal access token)을 생성하고 사용 가능한 권한을 구성하는 방법을 설명합니다.
히스토리 GitLab 18.10에서 베타 로 도입 되었습니다. GitLab 19.2에서 일반 공급 되었습니다. GitLab 19.6에서 기능 플래그 granular_personal_access_tokens 가 제거 되었습니다. 세분화된 개인 액세스 토큰은 사용자가 정의한 리소스와 권한으로 범위가 제한됩니다. 토큰을 생성할 때 다음 속성을 정의합니다. 리소스: API 작업의 모음입니다. 리소스는 더 큰 경계( Group and project , User , Global )로 묶입니다. 권한: 토큰이 리소스에 대해 수행할 수 있는 구체적인 작업입니다. 일반적으로 생성, 읽기, 업데이트, 삭제 작업에 해당합니다. 세분화된 개인 액세스 토큰 생성 # 세분화된 개인 액세스 토큰을 생성하려면 다음과 같이 합니다. 오른쪽 상단 모서리에서 아바타를 선택합니다. 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 을 선택합니다. 개인 액세스 토큰이 표시됩니다. 개인 액세스 토큰을 안전한 곳에 저장합니다. 페이지를 벗어나거나 새로 고치면 다시 볼 수 없습니다. 세분화된 토큰이 각 요청을 인가하는 방식 # 세분화된 개인 액세스 토큰으로 보내는 모든 API 요청은 두 가지 검사를 통과해야 합니다. 다음 두 가지가 모두 참이어야 합니다. 토큰에 요청 경로의 리소스에 대한 해당 작업의 권한이 있습니다. 토큰 소유자인 사용자가 해당 작업을 수행할 수 있습니다. 토큰 검사는 토큰이 어떤 API 작업을 어떤 리소스에 대해 호출할 수 있는지를 제어합니다. 이 검사를 통과한 뒤에는 사용자 본인의 액세스 권한이 작업의 허용 여부를 결정합니다. sudo로 사용자 가장 # 관리자는 REST API의 sudo 파라미터로 다른 사용자를 가장할 수 있는 세분화된 개인 액세스 토큰을 생성할 수 있습니다. sudo 기능이 있는 토큰은 관리자만 생성할 수 있습니다. 관리자가 아닌 사용자가 생성하려고 하면 오류가 발생합