이 API를 사용하여 임의의 토큰에 대한 세부 정보를 검색하고 취소합니다. 토큰 정보를 노출하는 다른 API와 달리, 이 API는 특정 토큰 유형을 알지 않고도 토큰 세부 정보를 검색하거나 취소할 수 있습니다.

토큰 접두사#

요청 시 personal, project 또는 group access 토큰은 glpat 또는 현재 커스텀 접두사로 시작해야 합니다. 토큰이 이전 커스텀 접두사로 시작하면 작업이 실패합니다. 이전 커스텀 접두사 지원에 대한 관심은 이슈 165663에서 추적됩니다.

사전 요구 사항:

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

토큰 정보 조회#

지정된 토큰에 대한 정보를 검색합니다. 이 엔드포인트는 다음 토큰을 지원합니다:

• 개인 액세스 토큰
• 가장 토큰
• 배포 토큰
• 피드 토큰
• OAuth 애플리케이션 시크릿
• 클러스터 에이전트 토큰
• 러너 인증 토큰
• 파이프라인 트리거 토큰
• CI/CD 작업 토큰
• 기능 플래그 클라이언트 토큰
• GitLab 세션 쿠키
• 수신 이메일 토큰

POST /api/v4/admin/token

지원되는 속성:

성공하면 200과 토큰에 대한 정보를 반환합니다.

다음 상태 코드를 반환할 수 있습니다:

• 200 OK: 토큰에 대한 정보.
• 401 Unauthorized: 사용자가 승인되지 않음.
• 403 Forbidden: 사용자가 관리자가 아님.
• 404 Not Found: 토큰을 찾을 수 없음.
• 422 Unprocessable: 토큰 유형이 지원되지 않음.

요청 예시:

curl --request POST \
  --url "https://gitlab.example.com/api/v4/admin/token" \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --header 'Content-Type: application/json' \
  --data '{"token": "glpat-<example-token>"}'

응답 예시:

{
 "id": 1,
 "user_id": 70,
 "name": "project-access-token",
 "revoked": false,
 "expires_at": "2024-10-04",
 "created_at": "2024-09-04T07:19:18.652Z",
 "updated_at": "2024-09-04T07:19:18.652Z",
 "scopes": [
  "api",
  "read_api"
 ],
 "impersonation": false,
 "expire_notification_delivered": false,
 "last_used_at": null,
 "after_expiry_notification_delivered": false,
 "previous_personal_access_token_id": null,
 "advanced_scopes": null,
 "organization_id": 1
}

토큰 취소#

토큰 유형에 따라 지정된 토큰을 취소, 재설정 또는 삭제합니다. 이 엔드포인트는 다음 토큰 유형을 지원합니다:

DELETE /api/v4/admin/token

지원되는 속성:

성공하면 내용 없이 204를 반환합니다.

다음 상태 코드를 반환할 수 있습니다:

• 204 No content: 토큰이 취소되었습니다.
• 401 Unauthorized: 사용자가 승인되지 않음.
• 403 Forbidden: 사용자가 관리자가 아님.
• 404 Not Found: 토큰을 찾을 수 없음.
• 422 Unprocessable: 토큰 유형이 지원되지 않음.

요청 예시:

curl --request DELETE \
  --url "https://gitlab.example.com/api/v4/admin/token" \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --header 'Content-Type: application/json' \
  --data '{"token": "glpat-<example-token>"}'