現在のシークレットバージョンにロックを設定する

Secrets Manager UI を使用して、シークレットの現行バージョンをロックできます。 要求が成功すると、選択したシークレットの現行バージョンに新しいロックが付加されるか、同じ名前のロックが既に存在する場合はそのロックが置き換えられます。

1. コンソールで、**「メニュー」**アイコン **>「リソース・リスト」**をクリックします。
2. サービスのリストから、Secrets Manager のインスタンスを選択します。
3. Secrets Manager UI で、**「シークレット」**リストに移動します。
4. ロックしたい秘密の行で、[アクション]メニューの![アクション]アイコン > [ロック] > [ロックの作成] をクリックします。
5. ロックを簡単に識別できるよう、名前と説明を追加してください。
6. ロックするバージョンのリストから、 「現在」 を選択します。
7. オプション: JSON 属性をロックに付加します。 自動化フローに必要な情報を保持するために、各ロックに JSON オブジェクトを含めることができます。 例えば、このロックに関連付けたいリソースを識別するキーと値のペアです。
8. オプション: ロックを排他的にします。 指定した名前と一致する他のロックを削除するには、このオプションを選択します。 シークレットの前のバージョンで一致するロックが検出された場合、それらのロックは新しいロックの作成時に削除されます。
9. オプション：以前のバージョンのデータを削除します。 以前のシークレット・バージョンに関連付けられているロックがない場合に、そのバージョンのデータも完全に削除するには、このオプションを選択します。
10. 「作成」 をクリックします。 選択したシークレット・バージョンに対して新しいロックが作成されます。

前のシークレット・バージョンでのロックの作成

Secrets Manager の UI を使用して、以前のバージョンのシークレットをロックできます。 要求が成功すると、選択したシークレットの前のバージョンに新しいロックが付加されるか、同じ名前のロックが既に存在する場合はそのロックが置き換えられます。

3. Secrets Manager UI で、**「シークレット」**リストに移動します。
4. ロックしたい秘密の行で、[アクション]メニューの![アクション]アイコン > [ロック] > [ロックの作成] をクリックします。
5. ロックを簡単に識別できるよう、名前と説明を追加してください。
6. ロックするバージョンのリストから、 「前へ」 を選択します。
7. オプション: JSON 属性をロックに付加します。 自動化フローに必要な情報を保持するために、各ロックに JSON オブジェクトを含めることができます。 例えば、このロックに関連付けたいリソースを識別するキーと値のペアです。
8. 「作成」 をクリックします。 選択したシークレット・バージョンに対して新しいロックが作成されます。

現在のシークレットバージョンにロックを設定する

Secrets Manager CLI を使用して、シークレットの現行バージョンをロックできます。 要求が成功すると、選択したシークレットの現行バージョンに新しいロックが付加されるか、同じ名前のロックが既に存在する場合はそのロックが置き換えられます。

Secrets Manager CLI プラグインを使用してシークレットの現行バージョンに対するロックを作成するには、 ibmcloud secrets-manager secret-locks-bulk-create コマンドを実行します。 シークレットのタイプ、シークレット ID、およびモードを指定できます。

ibmcloud secrets-manager secret-locks-bulk-create \
    --id=exampleString \
    --locks='[{"name": "lock-example-1", "description": "lock for consumer 1", "attributes": {"anyKey": "anyValue"}}]' \
    --mode=remove_previous

現在のシークレット・バージョンでのロックの作成

以下の要求は、シークレットの現行バージョンに対して 2 つのロックを作成します。 API を呼び出す場合は、ID 変数と IAM トークンを、ご使用の Secrets Manager インスタンス固有の値で置き換えます。

curl -X POST
-H "Authorization: Bearer {iam_token}" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
      "locks": [
        {
          "name": "lock-1",
          "description": "Lock for consumer 1.",
          "attributes": {
            "key": "value"
          }
        },
        {
          "name": "lock-2",
          "description": "Lock for consumer 2.",
          "attributes": {
            "key": "value"
            }
          }
        ]
      }' \
    "https://{instance_ID}.{region}.secrets-manager.appdomain.cloud/api/v2/secrets/{id}/locks_bulk"

自動化フローを作成する場合は、 attributes オブジェクトを使用して、シークレットに対する各ロックでキー値データを指定できます。 例えば、ID やクラウド・リソース名 (CRN) などのリソース ID を含めることができます。

成功すると、新しいロックに関する詳細と、その他のメタデータが応答で返されます。

{
  "secret_id": "0cf4addb-7a90-410b-a3a7-a15bbe2b7909",
  "secret_group_id": "d8371728-95c8-4c12-b2af-1af98adb9e41",
  "versions": [
    {
      "version_id": "7bf3814d-58f8-4df8-9cbd-f6860e4ca973",
      "version_alias": "current",
      "locks": [
        "lock-3",
        "lock-4"
      ],
      "payload_available": true
    },
    {
      "version_id": "5bf89b0c-df55-c8d5-7ad6-8816951c6784",
      "version_alias": "previous",
      "locks": [
        "lock-1",
        "lock-2"
      ],
      "payload_available": true
    }
  ]
}

必須およびオプションの要求パラメーターについて詳しくは、API リファレンスをチェックしてください。

前のシークレット・バージョンでのロックの作成

以下の要求は、前のバージョンのシークレットに対して 2 つのロックを作成します。 API を呼び出す場合は、ID 変数と IAM トークンを、ご使用の Secrets Manager インスタンス固有の値で置き換えます。

curl -X POST
    -H "Authorization: Bearer {iam_token}" \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -d '{
      "locks": [
        {
          "name": "lock-1",
          "description": "Lock for consumer 1.",
          "attributes": {
            "key": "value"
            }
          },
          {
            "name": "lock-2",
            "description": "Lock for consumer 2.",
            "attributes": {
              "key": "value"
              }
            }
          ]
        }' \ "https://{instance_ID}.{region}.secrets-manager.appdomain.cloud/api/v2/secrets/{id}/versions/{version_id}/locks_bulk"

成功すると、新しいロックに関する詳細と、その他のメタデータが応答で返されます。

{
  "secret_id": "0cf4addb-7a90-410b-a3a7-a15bbe2b7909",
  "secret_group_id": "d8371728-95c8-4c12-b2af-1af98adb9e41",
  "versions": [
    {
      "version_id": "7bf3814d-58f8-4df8-9cbd-f6860e4ca973",
      "version_alias": "current",
      "locks": [
        "lock-3",
        "lock-4"
      ],
      "payload_available": true
    },
    {
      "version_id": "5bf89b0c-df55-c8d5-7ad6-8816951c6784",
      "version_alias": "previous",
      "locks": [
        "lock-1",
        "lock-2"
      ],
      "payload_available": true
    }
  ]
}

必須およびオプションの要求パラメーターについて詳しくは、API リファレンスをチェックしてください。