토큰 정보 API

Tier: Free, Premium, Ultimate Offering: Self-Managed Status: Experiment
  • GitLab 17.5에 도입되었으며 기본으로 비활성화된 admin_agnostic_token_finder 플래그와 함께 사용됩니다.
이 기능의 사용 가능 여부는 기능 플래그에 의해 제어됩니다. 자세한 정보는 히스토리를 참조하세요. 이 기능은 테스트용으로 제공되지만 프로덕션 환경에서 사용할 준비가 되어있지는 않습니다.

관리자는 임의의 토큰에 관한 정보를 검색하기 위해 이 API를 사용할 수 있습니다. 다른 API 엔드포인트가 토큰 정보를 노출시키는 것과 다르게(예: 개인 액세스 토큰 API), 이 엔드포인트는 토큰의 유형을 알지 못해도 관리자가 토큰 정보를 검색할 수 있게 합니다.

전제 조건:

  • 관리자여야 합니다.

토큰 정보 가져오기

토큰에 관한 정보를 반환합니다.

지원되는 토큰: 

POST /api/v4/admin/token

지원되는 속성:

속성 유형 필수여부 설명
token string Yes 식별해야 하는 토큰.

성공 시 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
}