InfoGrab DocsInfoGrab Docs

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