Secrets Manager API
GitLab v19.6Offering: GitLab.com, GitLab Self-Managed
요약
이 API를 사용해 외부 서비스와 도구에서 GitLab Secrets Manager 시크릿에 접근합니다. 이 API는 프로젝트 또는 그룹용 단기 JSON 웹 토큰(JWT)을 발급합니다. api 범위가 있는 개인 액세스 토큰, 프로젝트 또는 그룹 액세스 토큰, 서비스 계정 토큰으로 이 API를 호출합니다.
이 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 | 프로젝트의 시크릿을 보관하는 OpenBao 네임스페이스. X-Vault-Namespace 헤더로 전달합니다. |
provider.vault.path |
string | KV 시크릿 엔진의 마운트 경로. |
provider.vault.version |
string | KV 시크릿 엔진의 버전. |
provider.vault.secrets_path |
string | 시크릿이 저장되는 KV 엔진 아래의 기본 경로. 시크릿 이름 앞에 붙여 읽기 경로(<path>/data/<secrets_path>/<secret_name>)를 구성합니다. |
provider.vault.auth.jwt.path |
string | JWT 인증 방법의 마운트 경로. auth/<path>/login에서 인증합니다. |
provider.vault.auth.jwt.role |
string | 로그인에 사용할 JWT 인증 역할. |
provider.vault.auth.jwt.token |
string | 클라이언트가 OpenBao에 제시하는 단기 JWT. |
그룹용 Secrets Manager 액세스 토큰 생성#
그룹의 시크릿을 읽기 위한 액세스 토큰을 발급합니다.
POST /groups/: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/groups/1/secrets_manager/access_token"
응답 예시:
{
"expires_at": "2026-05-27T10:35:00Z",
"provider": {
"vault": {
"server": "https://secrets.gitlab.com",
"namespace": "org_5/group_42/group_99",
"path": "secrets/kv",
"version": "v2",
"secrets_path": "explicit",
"auth": {
"jwt": {
"path": "api_jwt/cel",
"role": "all_api",
"token": ""
}
}
}
}
}
응답 속성은
프로젝트용 Secrets Manager 액세스 토큰 생성과 같으며,
provider.vault.namespace의 범위가 그룹으로 한정됩니다.