외부 도구에서 시크릿에 접근
Secrets Manager API로 Kubernetes 애플리케이션과 코드형 인프라 도구 같은 외부 도구에서 GitLab Secrets Manager 시크릿을 읽는 방법을 설명합니다.
히스토리 GitLab 19.2에서 secrets_manager_api_access 라는 플래그와 함께 도입 되었습니다. 기본적으로 비활성화되어 있습니다. Secrets Manager API 를 사용하면 Kubernetes 애플리케이션이나 코드형 인프라 도구 같은 외부 애플리케이션과 도구에서 GitLab Secrets Manager 시크릿을 읽을 수 있습니다. CI/CD 작업에서 시크릿을 읽으려면 작업 스크립트에서 시크릿 사용 을 참고합니다. 클라이언트가 액세스 토큰을 발급받은 뒤에는 GitLab 애플리케이션을 거치지 않고 OpenBao 백엔드에서 직접 시크릿을 읽습니다. 액세스 토큰을 발급받으려면 GitLab API가 필요합니다. 액세스 토큰 흐름 # 클라이언트가 Secrets Manager API를 호출할 수 있는 토큰으로 GitLab에 인증합니다. 지원되는 토큰 유형은 사전 요구 사항 을 참고합니다. 클라이언트가 Secrets Manager API를 호출해 수명이 짧은 액세스 토큰을 발급받습니다. 이 액세스 토큰은 GitLab 액세스 토큰이 아니라 OpenBao용 JSON 웹 토큰(JWT)입니다. 응답에는 JWT와 OpenBao 연결 정보가 포함됩니다. 클라이언트가 JWT를 OpenBao 토큰으로 교환한 다음, 그 OpenBao 토큰으로 시크릿 값을 읽습니다. 또는 인라인 인증 을 사용해 요청마다 JWT를 보낼 수도 있습니다. JWT와 OpenBao 토큰은 각각 5분 후에 만료됩니다. OpenBao는 Vault API를 구현하므로 HashiCorp Vault 와 호환되는 모든 클라이언트를 사용할 수 있습니다. 모든 OpenBao 연결 정보는 발급 응답에서 얻으므로 네임스페이스, 마운트, 인증 경로를 직접 구성하지 않습니다. 사전 요구 사항 # GitLab Secrets Manager가 활성화되어 있어야 합니다. Secrets Manager가 GitLab 19.2 이상에서 프로비저닝되었어야 합니다. 다음 중 하나로 인증합니다. api 범위가 있는 개인 액세스 토큰, 프로젝트 또는 그룹 액세스 토큰, 서비스 계정 토큰. Secrets Manager API JWT 권한이 있는 세분화된 개인 액세스 토큰 . 권한이 Reporter 이상이어야 합니다. 값 읽기 권한이 있어야 합니다. 프로젝트 Owner(그룹 시크릿의 경우 그룹 Owner)가 이 권한을 부여할 수 있습니다. 시크릿 권한 관리 를 참고합니다. Note GitLab 19.2 이전에 프로비저닝된 Secrets Manager는 외부 요청이나 서비스의 접근을 지원하지 않습니다. 외부 접근을 활성화하려면 외부 요청의 시크릿 접근 활성화 를 참고합니다. 서비스 계정으로 인증 # 사전 요구 사항: 서비스 계정 을 만들 수 있는 권한. 시크릿 권한을 부여하기 위한 프로젝트 또는 그룹에 대한 Owner 권한. 서비스 계정으로 인증하려면 다음을 수행합니다. 서비스 계정을 만듭니다 . 서비스 계정의 개인 액세스 토큰을 만듭니다 . 범위는 api 입니다. 서비스 계정을 Reporter 이상의 권한으로