Secret Manager は、REST API と gRPC API を公開し、直接またはアプリケーション内でシークレットを使用、管理します。このページでは、Secret Manager を初めて使用する際に、Secret Manager API を有効にし、 Google Cloud プロジェクトを構成する方法について説明します。
この手順は、クイックスタートを含め、Secret Manager のすべてのタスクの前提条件です。
Secret Manager に慣れたら、個別の Google Cloud プロジェクトを使用することをおすすめします。プロジェクトを削除すると、テスト中に作成されるすべてのリソース(課金対象のリソースを含む)も削除されます。
Cloud Code がインストールされている IDE でアプリケーションを開発している場合、Secret Manager は拡張機能に統合されています。つまり、IDE を終了せずに、シークレットを作成、表示、更新、使用できます。Cloud Code で Secret Manager を使用する方法の詳細については、任意の IDE、VS Code、IntelliJ、または Cloud Shell エディタのシークレット管理ガイドを参照してください。
始める前に
-
Google Cloud コンソールで、プロジェクトの選択ページに移動します。
-
Google Cloud プロジェクトの選択または作成
プロジェクトの選択または作成に必要なロール
- プロジェクトを選択する: プロジェクトの選択に特定の IAM ロールは必要ありません。ロールが付与されているプロジェクトであれば、どのプロジェクトでも選択できます。
-
プロジェクトを作成する: プロジェクトを作成するには、
resourcemanager.projects.create権限を含むプロジェクト作成者ロール(roles/resourcemanager.projectCreator)が必要です。ロールを付与する方法を確認する。
Secret Manager API を有効にする
コンソール
Google Cloud コンソールで、[Secret Manager API] ページに移動します。
ページの上部にあるプロジェクト セレクタにプロジェクト名が表示されていることを確認します。
プロジェクトの名前が表示されない場合は、プロジェクト セレクタをクリックしてプロジェクトを選択します。
- [有効にする] をクリックします。
gcloud
-
Google Cloud コンソールで Cloud Shell をアクティブにします。
Google Cloud コンソールの下部にある Cloud Shell セッションが開始し、コマンドライン プロンプトが表示されます。Cloud Shell はシェル環境です。Google Cloud CLI がすでにインストールされており、現在のプロジェクトの値もすでに設定されています。セッションが初期化されるまで数秒かかることがあります。
- gcloud セッションで Google Cloud プロジェクトを設定するには、
gcloud config set projectコマンドを実行します。PROJECT_ID は、実際の Google Cloud プロジェクト ID に置き換えます。gcloud config set project PROJECT_ID
- Secret Manager API を有効にするには、
gcloud services enableコマンドを実行します。gcloud services enable secretmanager.googleapis.com
- Secret Manager API が有効になっていることを確認するには、
gcloud services listコマンドを実行します。gcloud services list --enabled
Secret Manager API が、有効な API のリストに含まれていることを確認します。
ロールと権限を構成する
Secret Manager を設定するために必要な権限を取得するには、プロジェクトに対する Secret Manager 管理者 (roles/secretmanager.admin)IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織に対するアクセス権の管理をご覧ください。
必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。
Secret Manager のアクセス制御の詳細については、IAM によるアクセス制御をご覧ください。
次のステップ
- Secret Manager API の認証とアクセスについて学習する。
- シークレットの作成について確認する。
- シークレット バージョンを追加する方法を確認する。