UI での Secrets Manager インスタンスの作成

IBM Cloud コンソールから Secrets Manager のインスタンスを作成するには、以下のステップを実行します。

1. コンソールで、 Secrets Manager の提供詳細ページに移動します。

2. **「作成」**タブで、インスタンスをプロビジョニングする地理的領域を表すリージョンを選択します。

3. 料金プランを確認して選択します。

   アカウントにつき、 Secrets Manager のトライアルインスタンスは1つしか作成できません。 新しい試用版インスタンスを作成する前に、既存の試用版インスタンスとその再利用を削除する必要があります。

4. インスタンスの名前を指定します。

5. リソース・グループを選択します。

6. オプション: アカウント内のインスタンスを整理するために役立つタグを追加します。

7. インスタンスでお客様管理の暗号化を有効にするかどうかを決定します。

   鍵管理サービスと統合することによって、保存中のシークレットのセキュリティーを強化することができます。 カスタマー・マネージド型の暗号化について詳しくは、Secrets Manager で機密データを保護するをチェックしてください。

   また、 Key Management Services All-Inclusiveモジュールを使用して、鍵管理を合理化することもできます。 詳しくは Terraform IBM Modulesを ご覧ください。

8. Secrets Manager に接続するためのオプションを決定します。 デフォルトでは、 Secrets Manager のインスタンスはプライベート・エンドポイントのみで作成される。

   private-only または public-and-private のいずれかを選択してください。 プライベート接続オプションをサポートするようにアカウントをセットアップする方法について詳しくは、VRF およびサービス・エンドポイントの有効化を参照してください。

9. 「作成」 をクリックして、選択したアカウント、リージョン、リソース・グループに Secrets Manager のインスタンスを作成します。

   インスタンスの作成後にサービス・プランを更新するには、 サービス・プランの更新 を参照してください。

CLI からの Secrets Manager インスタンスの作成

IBM Cloud （ ）CLI を使用して Secrets Manager のインスタンスを作成するには、以下の手順を実行してください。

1. IBM Cloud CLI から IBM Cloud にログインしてください。

   ibmcloud login
   

   ログインに失敗した場合は、ibmcloud login --ssoコマンドを実行して再試行してください。 フェデレーテッドIDを使用してログインする場合は、--ssoパラメーターが必要です。 このオプションを使用する場合、CLI 出力にリストされているリンクに移動して、ワンタイム・パスコードを生成します。

2. Secrets Manager サービス・インスタンスを作成するアカウント、リージョン、リソース・グループを選択します。

   ibmcloud target -r REGION_NAME -g RESOURCE_GROUP_NAME
   

3. そのアカウントおよびリソース・グループに Secrets Manager のインスタンスを作成します。

   ibmcloud resource service-instance-create INSTANCE_NAME secrets-manager PLAN REGION_NAME [OPTIONS]
   

   CLIを使用してサービスをプロビジョニングするために必要な情報の説明Secrets Manager

   変数	説明
   インスタンス名 (instance_name)	サービス・インスタンスの固有の別名。
   地域 (region)	インスタンスをプロビジョンする必要があるリージョン。 対応地域
   料金プラン (plan)	ご希望の料金プラン trial または standard をご利用ください。
   エンドポイント (options)	オプション。 デフォルトでは、 Secrets Manager のインスタンスはプライベート・エンドポイント（private-only ）のみで作成される。パブリック・エンドポイントも使用する Secrets Manager のインスタンスをプロビジョニングする必要がある場合は、コマンドに --service-endpoints public-and-private オプションを追加する。
   暗号化 (options)	顧客管理の暗号化を使用するSecrets Managerのインスタンスをプロビジョンするには、-p '{"kms_key": "<root_key_crn>"}'を追加します。 <root_key_crn>を、統合するルート・キーの CRN 値に置き換えます。

   アカウントにつき、 Secrets Manager のトライアルインスタンスは1つしか作成できません。 新しい試用版インスタンスを作成する前に、既存の試用版インスタンスとその再利用を削除する必要があります。

   インスタンスの作成後にサービス・プランを更新するには、 サービス・プランの更新 を参照してください。

API からの Secrets Manager インスタンスの作成

API から Secrets Manager のインスタンスを作成するには、以下の手順を実行してください。

その他のプログラミング言語のサポートについては、 リソース・コントローラー API 資料 を参照してください。

1. IBM Cloud IAM アクセス・トークンを取得します。

2. curl コマンドを実行して、 Secrets Managerのインスタンスをプロビジョンします。

   curl -X POST https://resource-controller.cloud.ibm.com/v2/resource_instances -H "Authorization: Bearer <IAM token>" -H 'Content-Type: application/json' -d '{
      "name": "<instance_name>",
      "target": "<region>",
      "resource_group": "<resource_group_id>",
      "resource_plan_id": "<plan>",
      "parameters": {"service-endpoints": "public-and-private","kms_key": "<root_key_crn>"}
   }'
   

   APIを使用してサービスをプロビジョニングするために必要な情報の説明Secrets Manager

   変数	説明
   インスタンス名 (name)	サービス・インスタンスの固有の別名。
   ターゲット (region)	インスタンスをプロビジョンする必要があるリージョン。 対応地域
   料金プラン (plan)	プラン ID として提供される、使用する料金プラン。 trial の場合は 869c191a-3c2a-4faf-98be-18d48f95ba1f 、 standard の場合は 7713c3a8-3be8-4a9a-81bb-ee822fcaac3d を使用します。
   Endpoints	デフォルトでは、インスタンスはプライベートエンドポイント Secrets Manager のみで作成されます。 パブリックエンドポイントも使用するインスタンス Secrets Manager をプロビジョニングする必要がある場合は、に "service-endpoints":"public-and-private" を追加してください parameters。
   暗号化	お客様管理の暗号化 を使用する Secrets Manager のインスタンスをプロビジョンするには、 kms_key パラメーターを保持し、 <root_key_crn> を、統合するルート鍵の CRN 値に置き換えます。

   アカウントにつき、 Secrets Manager のトライアルインスタンスは1つしか作成できません。 新しい試用版インスタンスを作成する前に、既存の試用版インスタンスとその再利用を削除する必要があります。

   インスタンスの作成後にサービス・プランを更新するには、 サービス・プランの更新 を参照してください。

Terraformを使って Secrets Manager インスタンスを作成する

Terraformを使って Secrets Manager のインスタンスを作成するには、 Secrets Manager の ibm_resource_instance リソースに以下のパラメータを記述します。

• service: secrets-manager
• planStandard または Trial。 サービスプランの 詳細
• service_endpoints: private または public-and-private のいずれか。 含まれていない場合、デフォルトは private さらにカスタマイズを行うには、 parameters 内に以下の内容を記述してください。
• kms_key: Key Protect からのルートキーCRN. もし含まれていない場合、デフォルトはルートキーとなります。 Secrets Manager

リソースの例は、以下のようになります。

resource "ibm_resource_instance" "sm_instance" {
  name              = "demo-sm-instance"
  service           = "secrets-manager"
  plan              = "standard"
  location          = "us-south"
  service_endpoints = "public-and-private"
}

また IBM Cloud® Secrets Manager を使用して、 Secrets Manager インスタンスをコードとしてプロビジョニングおよび設定することもできます。 Terraform IBM モジュールについての詳細は、 Terraform IBM モジュールについてを 参照。