Secret Manager API を有効にする

Secret Manager は、REST API と gRPC API を公開し、直接またはアプリケーション内でシークレットを使用、管理します。このページでは、Secret Manager を初めて使用する際に、 Secret Manager API を有効にし プロジェクトを構成する方法について説明します。 Google Cloud

Secret Manager に慣れたら、個別の プロジェクト Google Cloud を使用することをおすすめします。プロジェクトを削除すると、テスト中に作成されるすべてのリソース（課金対象のリソースを含む）も削除されます。

Cloud Code がインストールされている IDE でアプリケーションを開発している場合、Secret Manager は拡張機能に統合されています。つまり、IDE を終了せずに、シークレットを作成、表示、更新、使用できます。Cloud Code で Secret Manager を使用する方法の詳細については、任意の IDE、VS Code、IntelliJ、または Cloud Shell エディタのシークレット管理ガイドを参照してください。

始める前に

  1. コンソールで、プロジェクトの選択ページに移動します。 Google Cloud

    プロジェクト セレクタに移動

  2. プロジェクトの選択または作成 Google Cloud

    プロジェクトを選択または作成するために必要なロール

    • プロジェクトを選択する: プロジェクトの選択には特定の IAM ロールは必要ありません。ロールが付与されているプロジェクトを選択できます。
    • プロジェクトを作成する: プロジェクトを作成するには、プロジェクト作成者ロール （roles/resourcemanager.projectCreator）が必要です。これには resourcemanager.projects.create 権限が含まれています。詳しくは、ロールを付与する方法をご覧ください。

Secret Manager API を有効にする

コンソール

  1. コンソールで、[Secret Manager API] ページに移動します。 Google Cloud

    Secret Manager API に移動

  2. ページの上部にあるプロジェクト セレクタにプロジェクト名が表示されていることを確認します。

    プロジェクトの名前が表示されない場合は、プロジェクト セレクタをクリックしてプロジェクトを選択します。

  3. [有効にする] をクリックします。

gcloud

  1. コンソールで Cloud Shell をアクティブにします。 Google Cloud

    Cloud Shell をアクティブにする

    コンソールの下部にある Google Cloud Cloud Shell セッションが開始し、コマンドライン プロンプトが表示されます。Cloud Shell はシェル環境です。Google Cloud CLI がすでにインストールされており、現在のプロジェクトの値もすでに設定されています。セッションが初期化されるまで数秒かかることがあります。

  2. gcloud セッションで Google Cloud プロジェクトを設定するには、gcloud config set project コマンドを実行します。PROJECT_ID は、実際の Google Cloud プロジェクト 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 のリストに含まれていることを確認します。

リージョン エンドポイントを使用するように Secret Manager を構成する

リージョン エンドポイントを作成するには、リージョン エンドポイントを使用するように Secret Manager を構成する必要があります。リージョン エンドポイントは、影響を受けるリソースがエンドポイントで指定されたロケーションに存在する場合にのみ、リクエストの続行を許可するリクエスト エンドポイントです。リージョン エンドポイントを使用すると、データ所在地とデータ主権の要件を遵守する方法でワークロードを実行できます。

リージョン エンドポイントは次の形式を使用します。

SERVICE_NAME.LOCATION.rep.googleapis.com

リージョン エンドポイントを使用するには、Secret Manager サービスへのアクセス方法に応じて、リージョン エンドポイントのアドレスで構成を更新する必要があります。

gcloud

リージョン エンドポイントを使用するように Google Cloud CLI を構成するには、次の操作を行います。

  1. Google Cloud CLI 402.0.0 以降を使用していることを確認します。

  2. api_endpoint_overrides/secretmanager プロパティを、使用するリージョン エンドポイントに設定します。

    gcloud config set api_endpoint_overrides/secretmanager https://secretmanager.LOCATION.rep.googleapis.com/

    LOCATION は、サポートされている Google Cloud ロケーションの名前（ me-central2 など）に置き換えます。

REST

API を使用して Secret Manager サービスに接続するには、汎用 API エンドポイント URL（https://secretmanager.googleapis.com/v1/）を、使用する特定のリージョン エンドポイントに置き換えます。リージョン エンドポイントは次の形式を使用します。

https://secretmanager.LOCATION.rep.googleapis.com/v1/

LOCATION は、サポートされている Google Cloud ロケーションの名前（ me-central2 など）に置き換えます。

サポートされているロケーションを確認するには、Secret Manager のロケーションをご覧ください。

コンソールからリージョン化されたサービスにアクセスするために追加の構成は必要ありません。

ロールと権限を構成する

Secret Manager を設定するために必要な権限を取得するには、プロジェクトに対するSecret Manager 管理者 （roles/secretmanager.admin）IAM ロールを付与するように管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織に対するアクセス権の管理をご覧ください。

必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。

Secret Manager のアクセス制御の詳細については、 IAM によるアクセス制御をご覧ください。

次のステップ