InfoGrab DocsInfoGrab Docs

Secrets Manager API

요약

이 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의 범위가 그룹으로 한정됩니다.

Secrets Manager API

GitLab v19.6
Tier: Premium, Ultimate
Offering: 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의 범위가 그룹으로 한정됩니다.