REST API 인증
OAuth 2.0, 접근 토큰, job 토큰으로 GitLab REST API를 인증합니다.
대부분의 API 요청에는 인증이 필요하거나, 인증이 제공되지 않으면 공개 데이터만 반환됩니다. 인증이 필요하지 않은 경우 각 엔드포인트의 문서에 명시되어 있습니다. 예를 들어 /projects/:id 엔드포인트 는 인증이 필요하지 않습니다. GitLab REST API에서 여러 방법으로 인증할 수 있습니다: OAuth 2.0 토큰 개인 접근 토큰 프로젝트 접근 토큰 그룹 접근 토큰 세션 쿠키 CI/CD job 토큰 (특정 엔드포인트만) 프로젝트 접근 토큰은 다음에서 지원됩니다: GitLab Self-Managed: Free, Premium, Ultimate. GitLab.com: Premium, Ultimate. 관리자인 경우 귀하 또는 귀하의 애플리케이션은 다음 중 하나를 사용하여 특정 사용자로 인증할 수 있습니다: 가장 토큰(Impersonation tokens) Sudo 인증 정보가 유효하지 않거나 누락된 경우 GitLab은 상태 코드 401 과 함께 오류 메시지를 반환합니다: { "message" : "401 Unauthorized" } 액세스 토큰은 유효하지만 엔드포인트에 필요한 스코프가 없으면 GitLab은 상태 코드 403 과 함께 insufficient_scope 오류를 반환합니다. 응답 본문과 WWW-Authenticate 헤더는 모두 요청을 인가할 수 있는 스코프를 나열합니다. 토큰에는 이 스코프 중 하나가 필요하며, 모두 필요한 것은 아닙니다. 엔드포인트가 일부 요청에만 허용하는 스코프는 해당 요청에 대해서만 나열됩니다. 예를 들어 대부분의 엔드포인트는 read_api 스코프를 GET 및 HEAD 요청에만 허용합니다. read_user 스코프만 있는 토큰으로 GET /namespaces 를 요청하면 다음 헤더가 반환됩니다. WWW-Authenticate: Bearer realm="Protected by OAuth 2.0", error="insufficient_scope", error_description="The request requires higher privileges than provided by the access token.", scope="api read_api" MCP 서버 엔드포인트인 /api/v4/mcp 와 /api/v4/orbit/mcp 는 대신 요청에 토큰이 없을 때 보내는 챌린지로 응답합니다. 챌린지에는 realm GitLab , OAuth 클라이언트가 해당 엔드포인트에 요청하는 스코프( mcp 또는 mcp_orbit ), resource_metadata 에 있는 엔드포인트의 보호된 리소스 메타데이터 URL이 포함됩니다. 만료되었거나 취소되었거나 알 수 없는 토큰은 invalid_token 오류와 함께 같은 챌린지를 받습니다. insufficient_scope 오류의 경우 챌린지는 응답 본문과 같은 스코프를 나열합니다. 토큰에 엔드포인트가 허용하는 스코프가 하나도 없는 경우: /api/v4/mcp 는 허용하는 유일한 스코프인 mcp 만 나열합니다. /api/v4/orbit/mcp 는 mcp_or