InfoGrab DocsInfoGrab Docs

Secrets Manager API

GitLab Secrets Manager용 단기 액세스 토큰을 발급하는 REST API를 설명합니다.

히스토리 GitLab 19.2에서 secrets_manager_api_access 라는 플래그와 함께 도입되었습니다 . 기본적으로 비활성화되어 있습니다. 이 API를 사용해 외부 서비스와 도구에서 GitLab Secrets Manager 시크릿에 접근합니다. 이 API는 프로젝트 또는 그룹용 단기 JSON 웹 토큰(JWT)을 발급합니다. 클라이언트는 GitLab Runner가 CI/CD 작업 중에 시크릿을 읽는 방식과 같이, 이 토큰을 OpenBao 백엔드에 제시하여 시크릿을 직접 읽습니다. 응답에는 클라이언트에 필요한 OpenBao 연결 세부 정보가 포함됩니다. api 범위가 있는 개인 액세스 토큰, 프로젝트 또는 그룹 액세스 토큰, 서비스 계정 토큰으로 이 API를 호출합니다. API가 반환하는 토큰은 GitLab 액세스 토큰이 아니라 별도의 단기 OpenBao JWT입니다. 이 토큰은 5분 후에 만료됩니다. 시크릿 값을 읽으려면 주체에게 해당 시크릿의 값 읽기 권한도 있어야 합니다. 반환된 연결 세부 정보로 시크릿을 읽는 방법은 외부 도구에서 시크릿 접근 을 참고합니다. 프로젝트용 Secrets Manager 액세스 토큰 생성 # 프로젝트의 시크릿을 읽기 위한 액세스 토큰을 발급합니다. POST /projects/:id/secrets_manager/access_token 지원되는 속성: 속성 유형 필수 설명 id integer or string 예 프로젝트의 ID 또는 URL 인코딩된 경로 . 요청 예시: curl --request POST \ --header "PRIVATE-TOKEN: <your_access_token>" \ --url "https://gitlab.example.com/api/v4/projects/1/secrets_manager/access_token" 응답 예시: { "expires_at" : "2026-05-27T10:35:00Z" , "provider" : { "vault" : { "server" : "https://secrets.gitlab.com" , "namespace" : "org_5/group_42/project_99" , "path" : "secrets/kv" , "version" : "v2" , "secrets_path" : "explicit" , "auth" : { "jwt" : { "path" : "api_jwt/cel" , "role" : "all_api" , "token" : "" } } } } } 응답 속성: 속성 유형 설명 expires_at string 토큰이 만료되는 ISO 8601 타임스탬프. 토큰은 5분 동안 유효합니다. provider.vault.server string 연결할 OpenBao 서버의 URL. GitLab.com에서는 https://secrets.gitlab.com 입니다. GitLab Self-Managed에서는 인스턴스에 구성된 OpenBao URL입니다. provider.vault.namespace string 프로젝트의 시크릿을 보관하는 Open