이 API로 개인 액세스 토큰과 가장 토큰을 다룹니다. 자세한 내용은 개인 액세스 토큰과 가장 토큰을 참고합니다.

사용자의 개인 액세스 토큰 생성#

히스토리

• 응답의 last_used_ips가 GitLab 19.4에서 도입되었습니다.

지정한 사용자의 개인 액세스 토큰을 생성합니다.

토큰 값은 응답에 포함되지만, 이후에는 다시 조회할 수 없습니다.

사전 요구 사항:

• 인스턴스의 관리자 액세스 권한이 있어야 합니다.

POST /users/:user_id/personal_access_tokens

지원하는 속성:

요청 예시:

curl --request POST \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --data "name=mytoken" --data "expires_at=2017-04-04" \
  --data "scopes[]=api" \
  --url "https://gitlab.example.com/api/v4/users/42/personal_access_tokens"

응답 예시:

{
    "id": 3,
    "name": "mytoken",
    "revoked": false,
    "created_at": "2020-10-14T11:58:53.526Z",
    "description": "Test Token description",
    "scopes": [
        "api"
    ],
    "user_id": 42,
    "last_used_ips": [],
    "active": true,
    "expires_at": "2020-12-31",
    "token": "<your_new_access_token>"
}

개인 액세스 토큰 생성#

히스토리

• 응답의 last_used_ips가 GitLab 19.4에서 도입되었습니다.
• 응답의 granular_scopes가 GitLab 19.5에서 도입되었습니다.

본인 계정의 개인 액세스 토큰을 생성합니다. 보안을 위해 이 토큰은 다음과 같습니다.

• k8s_proxy 및 self_rotate 스코프로 제한됩니다.

토큰 값은 응답에 포함되지만, 이후에는 다시 조회할 수 없습니다.

사전 요구 사항:

• 본인 인증이 되어 있어야 합니다.

POST /user/personal_access_tokens

지원하는 속성:

요청 예시:

curl --request POST \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --data "name=mytoken" --data "scopes[]=k8s_proxy" \
  --url "https://gitlab.example.com/api/v4/user/personal_access_tokens"

응답 예시:

{
    "id": 3,
    "name": "mytoken",
    "revoked": false,
    "created_at": "2020-10-14T11:58:53.526Z",
    "description": "Test Token description",
    "scopes": [
        "k8s_proxy"
    ],
    "user_id": 42,
    "last_used_ips": [],
    "active": true,
    "expires_at": "2020-10-15",
    "token": "<your_new_access_token>"
}

사용자의 모든 가장 토큰 조회#

히스토리

• 응답의 last_used_ips가 GitLab 19.2에서 expose_last_used_ips_for_access_tokens라는 이름의 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다.
• 응답의 last_used_ips가 GitLab 19.4에서 일반 제공되었습니다. 기능 플래그 expose_last_used_ips_for_access_tokens는 제거되었습니다.
• 응답의 granular_scopes가 GitLab 19.5에서 도입되었습니다.

지정한 사용자의 모든 가장 토큰을 조회합니다.

page 및 per_page 페이지네이션 파라미터로 결과를 필터링합니다.

사전 요구 사항:

• 인스턴스의 관리자 액세스 권한이 있어야 합니다.

GET /users/:user_id/impersonation_tokens

지원하는 속성:

요청 예시:

curl --request GET \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/users/42/impersonation_tokens"

응답 예시:

[
   {
      "active" : true,
      "user_id" : 2,
      "scopes" : [
         "api"
      ],
      "revoked" : false,
      "name" : "mytoken",
      "description": "Test Token description",
      "id" : 2,
      "created_at" : "2017-03-17T17:18:09.283Z",
      "impersonation" : true,
      "expires_at" : "2017-04-04",
      "last_used_at": "2017-03-24T09:44:21.722Z",
      "last_used_ips": ["192.0.2.10"]
   },
   {
      "active" : false,
      "user_id" : 2,
      "scopes" : [
         "read_user"
      ],
      "revoked" : true,
      "name" : "mytoken2",
      "description": "Test Token description",
      "created_at" : "2017-03-17T17:19:28.697Z",
      "id" : 3,
      "impersonation" : true,
      "expires_at" : "2017-04-14",
      "last_used_at": "2017-03-24T09:44:21.722Z",
      "last_used_ips": ["192.0.2.11"]
   }
]

사용자의 가장 토큰 조회#

히스토리

• 응답의 last_used_ips가 GitLab 19.2에서 expose_last_used_ips_for_access_tokens라는 이름의 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다.
• 응답의 last_used_ips가 GitLab 19.4에서 일반 제공되었습니다. 기능 플래그 expose_last_used_ips_for_access_tokens는 제거되었습니다.
• 응답의 granular_scopes가 GitLab 19.5에서 도입되었습니다.

지정한 사용자의 가장 토큰 하나를 조회합니다.

사전 요구 사항:

• 인스턴스의 관리자 액세스 권한이 있어야 합니다.

GET /users/:user_id/impersonation_tokens/:impersonation_token_id

지원하는 속성:

요청 예시:

curl --request GET \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/users/42/impersonation_tokens/2"

응답 예시:

{
   "active" : true,
   "user_id" : 2,
   "scopes" : [
      "api"
   ],
   "revoked" : false,
   "name" : "mytoken",
   "description": "Test Token description",
   "id" : 2,
   "created_at" : "2017-03-17T17:18:09.283Z",
   "impersonation" : true,
   "expires_at" : "2017-04-04",
   "last_used_ips": ["192.0.2.10"]
}

가장 토큰 생성#

히스토리

• 응답의 last_used_ips가 GitLab 19.2에서 expose_last_used_ips_for_access_tokens라는 이름의 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다.
• 응답의 last_used_ips가 GitLab 19.4에서 일반 제공되었습니다. 기능 플래그 expose_last_used_ips_for_access_tokens는 제거되었습니다.
• 응답의 granular_scopes가 GitLab 19.5에서 도입되었습니다.

지정한 사용자의 가장 토큰을 생성합니다. 이 토큰은 해당 사용자를 대신해 동작하며, API 호출은 물론 Git 읽기·쓰기 작업도 수행할 수 있습니다. 이 토큰은 해당 사용자의 프로필 설정 페이지에 표시되지 않습니다.

토큰 값은 응답에 포함되지만, 이후에는 다시 조회할 수 없습니다.

사전 요구 사항:

• 인스턴스의 관리자 액세스 권한이 있어야 합니다.

POST /users/:user_id/impersonation_tokens

지원하는 속성:

요청 예시:

curl --request POST \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --data "name=mytoken" --data "expires_at=2017-04-04" \
  --data "scopes[]=api" \
  --url "https://gitlab.example.com/api/v4/users/42/impersonation_tokens"

응답 예시:

{
   "id" : 2,
   "revoked" : false,
   "user_id" : 2,
   "scopes" : [
      "api"
   ],
   "token" : "<impersonation_token>",
   "active" : true,
   "impersonation" : true,
   "name" : "mytoken",
   "description": "Test Token description",
   "created_at" : "2017-03-17T17:18:09.283Z",
   "expires_at" : "2017-04-04",
   "last_used_ips": []
}

가장 토큰 폐기#

지정한 사용자의 가장 토큰을 폐기합니다.

사전 요구 사항:

• 인스턴스의 관리자 액세스 권한이 있어야 합니다.

DELETE /users/:user_id/impersonation_tokens/:impersonation_token_id

지원하는 속성:

요청 예시:

curl --request DELETE \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/users/42/impersonation_tokens/1"