Eine Sperre für die aktuelle Version des Geheimnisses erstellen

Sie können die aktuelle Version eines geheimen Schlüssels über die Benutzerschnittstelle von Secrets Manager sperren. Eine erfolgreiche Anforderung hängt eine neue Sperre an die aktuelle Version Ihres ausgewählten geheimen Schlüssels an oder ersetzt eine Sperre mit demselben Namen, sofern sie bereits vorhanden ist.

1. Klicken Sie in der Konsole auf das Symbol Menü > Ressourcenliste.
2. Wählen Sie in der Liste der Services Ihre Instanz von Secrets Manager aus.
3. Wechseln Sie in der Benutzerschnittstelle von Secrets Manager zur Liste Geheime Schlüssel.
4. Klicken Sie in der Zeile des Geheimnisses, das Sie sperren möchten, auf das Menü „ Aktionen “ > Sperren > Sperre erstellen.
5. Fügen Sie einen Namen und eine Beschreibung hinzu, um das Schloss leicht identifizieren zu können.
6. Wählen Sie in der Liste der zu sperrenden Versionen Aktuell aus.
7. Optional: Ordnen Sie Ihrer Sperre JSON-Attribute zu. Sie können ein JSON-Objekt mit jeder Sperre einschließen, um alle Informationen zu speichern, die Sie für einen automatisierten Ablauf benötigen. Beispiel: Ein Schlüssel/Wert-Paar, das die Ressource angibt, die Sie dieser Sperre zuordnen wollen.
8. Optional: Machen Sie die Sperre exklusiv. Wählen Sie diese Option aus, um alle anderen Sperren zu entfernen, die mit dem angegebenen Namen übereinstimmen. Wenn in der Vorgängerversion des geheimen Schlüssels übereinstimmende Sperren gefunden werden, werden diese Sperren gelöscht, wenn die neue Sperre erstellt wird.
9. Optional: Daten der vorherigen Version löschen. Wählen Sie diese Option aus, um auch die Daten der vorherigen Version des geheimen Schlüssels permanent zu löschen, wenn ihr keine Sperren zugeordnet sind.
10. Klicken Sie auf Erstellen. Für die ausgewählte Version des geheimen Schlüssels wird eine neue Sperre erstellt.

Sperre für die vorherige Version des geheimen Schlüssels erstellen

Sie können die Vorgängerversion eines geheimen Schlüssels über die Benutzerschnittstelle von Secrets Manager sperren. Eine erfolgreiche Anforderung ordnet der vorherigen Version Ihres ausgewählten geheimen Schlüssels eine neue Sperre zu oder ersetzt eine Sperre mit demselben Namen, wenn sie bereits vorhanden ist.

3. Wechseln Sie in der Benutzerschnittstelle von Secrets Manager zur Liste Geheime Schlüssel.
4. Klicken Sie in der Zeile des Geheimnisses, das Sie sperren möchten, auf das Menü „ Aktionen “ > Sperren > Sperre erstellen.
5. Fügen Sie einen Namen und eine Beschreibung hinzu, um das Schloss leicht identifizieren zu können.
6. Wählen Sie in der Liste der zu sperrenden Versionen Zurück aus.
7. Optional: Ordnen Sie Ihrer Sperre JSON-Attribute zu. Sie können ein JSON-Objekt mit jeder Sperre einschließen, um alle Informationen zu speichern, die Sie für einen automatisierten Ablauf benötigen. Beispiel: Ein Schlüssel/Wert-Paar, das die Ressource angibt, die Sie dieser Sperre zuordnen wollen.
8. Klicken Sie auf Erstellen. Für die ausgewählte Version des geheimen Schlüssels wird eine neue Sperre erstellt.

Eine Sperre für die aktuelle Version des Geheimnisses erstellen

Sie können die aktuelle Version eines geheimen Schlüssels über die Befehlszeilenschnittstelle von Secrets Manager sperren. Eine erfolgreiche Anforderung hängt eine neue Sperre an die aktuelle Version Ihres ausgewählten geheimen Schlüssels an oder ersetzt eine Sperre mit demselben Namen, sofern sie bereits vorhanden ist.

Führen Sie den Befehl ibmcloud secrets-manager secret-locks-bulk-create aus, um eine Sperre für die aktuelle Version eines geheimen Schlüssels mit dem CLI-Plug-in Secrets Manager zu erstellen. Sie können den Typ des geheimen Schlüssels, die ID des geheimen Schlüssels und den Modus angeben.

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

Sperren für die aktuelle Version des geheimen Schlüssels erstellen

Die folgende Anforderung erstellt zwei Sperren für die aktuelle Version eines geheimen Schlüssels. Wenn Sie die API aufrufen, müssen Sie die ID-Variablen und das IAM-Token durch die Werte ersetzen, die für Ihre Secrets Manager-Instanz spezifisch sind.

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"

Wenn Sie einen automatisierten Ablauf erstellen, können Sie das Objekt attributes verwenden, um Schlüsselwertdaten mit jeder Sperre für Ihren geheimen Schlüssel anzugeben. Sie können beispielsweise eine Ressourcenkennung, wie eine ID oder einen Cloud Resource Name (CRN), angeben.

Eine erfolgreiche Antwort gibt Details zu den neuen Sperren sowie weitere Metadaten zurück.

{
  "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
    }
  ]
}

Weitere Informationen zu den erforderlichen und optionalen Anforderungsparametern finden Sie in der API-Referenz.

Sperren für die vorherige Version des geheimen Schlüssels erstellen

Die folgende Anforderung erstellt zwei Sperren für die vorherige Version eines geheimen Schlüssels. Wenn Sie die API aufrufen, müssen Sie die ID-Variablen und das IAM-Token durch die Werte ersetzen, die für Ihre Secrets Manager-Instanz spezifisch sind.

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"

Eine erfolgreiche Antwort gibt Details zu den neuen Sperren sowie weitere Metadaten zurück.

{
  "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
    }
  ]
}

Weitere Informationen zu den erforderlichen und optionalen Anforderungsparametern finden Sie in der API-Referenz.