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 、または dedicated をご利用ください。
   エンドポイント (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 を、「 dedicated 」の場合は をご利用ください。
   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
• plan: Standard、 Trial 、または dedicated のいずれかです。 サービスプランの 詳細はこちら
• 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 モジュールについてを 参照。

利用可能な各プランの詳細については、「 機能の概要 」をご覧ください。