Secret Manager API 사용 설정

Secret Manager에서는 직접 또는 애플리케이션에서 보안 비밀을 사용 및 관리할 수 있도록 REST API 및 gRPC API를 노출합니다. 이 페이지에서는 Secret Manager API를 사용 설정하고 Secret Manager를 처음 사용하도록 Cloud de Confiance by S3NS 프로젝트를 구성하는 방법을 설명합니다.

Secret Manager에 익숙해지면 별도의 Cloud de Confiance 프로젝트를 사용하는 것이 좋습니다. 프로젝트를 삭제하면 결제 가능한 리소스 등 테스트 중에 생성된 모든 리소스도 삭제됩니다.

Cloud Code가 설치된 IDE에서 애플리케이션을 개발하는 경우 Secret Manager가 확장 프로그램에 통합됩니다. 즉, IDE에서 나가지 않고도 보안 비밀을 만들고, 보고, 업데이트하고, 사용할 수 있습니다. Cloud Code에 Secret Manager를 사용하는 방법에 대한 자세한 내용은 원하는 IDE, VS Code, IntelliJ 또는 Cloud Shell 편집기를 위한 보안 비밀 관리 가이드를 참조하세요.

시작하기 전에

  1. Cloud de Confiance 콘솔에서 프로젝트 선택기 페이지로 이동합니다.

    프로젝트 선택기로 이동

  2. Cloud de Confiance 프로젝트를 선택하거나 만듭니다.

    프로젝트를 선택하거나 만드는 데 필요한 역할

    • 프로젝트 선택: 프로젝트를 선택하는 데는 특정 IAM 역할이 필요하지 않습니다. 역할이 부여된 프로젝트를 선택하면 됩니다.
    • 프로젝트 만들기: 프로젝트를 만들려면 resourcemanager.projects.create 권한이 포함된 프로젝트 생성자 역할(roles/resourcemanager.projectCreator)이 필요합니다. 역할 부여 방법 알아보기

Secret Manager API 사용 설정

콘솔

  1. Cloud de Confiance 콘솔에서 Secret Manager API 페이지로 이동합니다.

    Secret Manager API로 이동

  2. 페이지 상단의 프로젝트 선택기에 프로젝트 이름이 표시되는지 확인합니다.

    프로젝트 이름이 표시되지 않으면 프로젝트 선택기를 클릭한 후 프로젝트를 선택합니다.

  3. 사용 설정을 클릭합니다.

gcloud

  1. Cloud de Confiance 콘솔에서 Cloud Shell을 활성화합니다.

    Cloud Shell 활성화

    Cloud de Confiance 콘솔 하단에 Cloud Shell 세션이 시작되고 명령줄 프롬프트가 표시됩니다. Cloud Shell은 Google Cloud CLI가 사전 설치된 셸 환경으로, 현재 프로젝트의 값이 이미 설정되어 있습니다. 세션이 초기화되는 데 몇 초 정도 걸릴 수 있습니다.

  2. gcloud 세션에서 Cloud de Confiance by S3NS 프로젝트를 설정하려면 gcloud config set project 명령어를 실행합니다. PROJECT_ID를 Cloud de Confiance 프로젝트 ID로 바꿉니다. 
    gcloud config set project PROJECT_ID
  3. Secret Manager API를 사용 설정하려면 gcloud services enable 명령어를 실행합니다. 
    gcloud services enable secretmanager.googleapis.com
  4. Secret Manager API가 사용 설정되었는지 확인하려면 gcloud services list 명령어를 실행합니다. 
    gcloud services list --enabled

    Secret Manager API가 사용 설정된 API 목록에 나열되는지 확인합니다.

환경에서 리전 보안 비밀에 액세스

리전 보안 비밀을 만들고 관리하기 위해 구성에서는 전역 서버 부하 분산기 (GSLB)를 사용하여 요청을 라우팅하는 중앙 엔드포인트를 사용합니다. 이는 특정 리전 엔드포인트를 구성해야 하는 표준 Cloud de Confiance by S3NS와는 다릅니다.

이 방법을 사용하면 API 호출 또는 Google Cloud CLI 명령어에서 보안 비밀을 저장해야 하는 위치를 명시적으로 지정하여 워크로드가 데이터 상주 및 데이터 주권 요구사항을 계속 준수할 수 있습니다.

보안 비밀이 특정 지리적 위치에 저장되도록 하려면 요청에서 리전을 지정해야 합니다.

  • Cloud de Confiance by S3NS: Cloud de Confiance by S3NS를 사용하는 경우 --location 플래그를 명령어에 추가합니다.
  • REST API: REST API를 사용할 때는 요청 URL에 위치를 직접 포함합니다.

역할 및 권한 구성

Secret Manager를 설정하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대해 Secret Manager 관리자 (roles/secretmanager.admin) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

Secret Manager의 액세스 제어에 대한 자세한 내용은 IAM으로 액세스 제어를 참고하세요.

다음 단계