Schlüsselringe mit der Benutzerschnittstelle erstellen

Um einen Schlüsselring zu erstellen, müssen Sie die Funktion "Writer" oder "Manager" haben.

So erstellen Sie einen Schlüsselring:

1. Klicken Sie in der linken Navigation auf Schlüsselringe .
2. Klicken Sie in der Anzeige Schlüsselringe auf die Schaltfläche Erstellen .
3. Geben Sie auf der Registerkarte Schlüsselring erstellen Ihrem neuen Schlüsselring einen Namen nach den Anweisungen für zulässige Zeichen ein. Klicken Sie anschließend auf Erstellen.

Nach der Erstellung wird Ihr neuer Schlüsselring in der Liste der Schlüsselringe angezeigt, und Sie können Schlüssel zu ihm übertragen oder Schlüssel für ihn erstellen.

Wenn Sie Schlüsselanhänger in mehreren Umgebungen einheitlich verwalten, können Sie Schlüsselanhänger und Schlüssellayout mit dem Modul Key Protect Key Ring oder dem umfassenderen Modul Key Protect All-Inclusive automatisieren. Siehe Über Terraform IBM Module für den Kontext.

Schlüsselringe mit der API erstellen

Erstellen Sie einen Schlüsselring, indem Sie einen POST-Aufruf an den folgenden Endpunkt ausführen.

https://<region>.kms.cloud.ibm.com/api/v2/keys

1. Rufen Sie Ihre Authentifizierungsnachweise ab, um mit den Schlüsseln im Service zu arbeiten.

2. Erstellen Sie einen Schlüsselring, indem Sie den folgenden curl-Befehl ausführen.

   $ curl -X POST \
       "https://<region>.kms.cloud.ibm.com/api/v2/key_rings/<key_ring_id>" \
       -H "authorization: Bearer <IAM_token>" \
       -H "bluemix-instance: <instance_ID>" \
       -H "correlation-id: <correlation_ID>"
   

   Ersetzen Sie die Variablen in der Beispielanforderung entsprechend der folgenden Tabelle.

Eine erfolgreiche POST api/v2/key_rings Anfrage liefert eine HTTP 201 Created Antwort, die anzeigt, dass der Schlüsselring erstellt wurde und nun zur Speicherung von Standard- und Root-Schlüsseln zur Verfügung steht.

Zugriff auf einen Schlüsselring erteilen

Sie können den Zugriff auf einen Schlüsselbund innerhalb einer „ Key Protect “-Instanz über die „ IBM Cloud “-Konsole, die IAM-API oder die CLI{ :external} gewähren.

Überprüfen Sie die Rollen und Berechtigungen auf Informationen zum Zuordnen der IBM Cloud IAM-Rollen zu Key Protect-Aktionen.

So erteilen Sie über die Konsole Zugriff auf einen Schlüsselring:

1. Klicken Sie in der Menüleiste auf Verwalten > **Zugriff (IAM)**und wählen Sie Benutzer aus, um die vorhandenen Benutzer in Ihrem Account zu durchsuchen.

2. Wählen Sie eine Tabellenzeile aus und klicken Sie auf das Fragezeichensymbol (?), um eine Liste mit Optionen für diesen Benutzer zu öffnen.

3. Klicken Sie im Auswahlmenü auf Zugriffsberechtigungen zuweisen.

4. Klicken Sie auf Benutzern zusätzliche Zugriffsberechtigungen zuweisen.

5. Klicken Sie auf die Schaltfläche IAM-Services.

6. Wählen Sie in der Liste der Services Key Protect.

7. Wählen Sie die Option für Auf Attributen basierende Services aus.

8. Wählen Sie das Attribut Instanz-ID aus und wählen Sie die Instanz aus, in der sich der Schlüsselring befindet.

9. Wählen Sie das Attribut Schlüsselring-ID aus und geben Sie die ID ein, die dem Schlüsselring zugeordnet ist.

10. Wählen Sie eine Kombination aus Plattform- und Servicezugriffsrollen aus, um den Zugriff für den Benutzer zuzuweisen.

11. Klicken Sie auf Hinzufügen.

12. Fügen Sie nach Bedarf weitere Plattform- und Servicezugriffsrollen hinzu und klicken Sie anschließend auf Zuweisen. Beachten Sie, dass dem Benutzer mindestens Reader-Zugriff auf die gesamte Instanz zugewiesen werden muss, damit dieser Schlüsselringe in der Instanz auflisten, erstellen und löschen kann.

Schlüsselringe mit der API auflisten

Für eine übergeordnete Ansicht können Sie die Schlüsselringe durchsuchen, die in Ihrer bereitgestellten Instanz von Key Protect verwaltet werden, indem Sie einen GET-Aufruf an den folgenden Endpunkt ausführen.

https://<region>.kms.cloud.ibm.com/api/v2/keys_rings

1. Rufen Sie Ihre Authentifizierungsnachweise ab, um mit den Schlüsseln im Service zu arbeiten.

2. Rufen Sie die allgemeinen Eigenschaften Ihrer Schlüsselanhänger ab, indem Sie den folgenden Befehl ausführen curl-Befehl ausführen.

   $ curl -X GET \ "https://<region>.kms.cloud.ibm.com/api/v2/key_rings?totalCount=<show_total>&offset=<offset_value>&limit=<offset_limit>" \
       -H "accept: application/vnd.ibm.kms.key_ring+json" \
       -H "authorization: Bearer <IAM_token>" \
       -H "bluemix-instance: <instance_ID>" \
       -H "correlation-id: <correlation_ID>"
   

   Abfrageparameter, die auf das Fragezeichen ? folgen, sind optional, aber hier enthalten, um ihre Verwendung zu dokumentieren. (: :Hinweis)

   Ersetzen Sie die Variablen in der Beispielanforderung entsprechend der folgenden Tabelle.

Eine erfolgreiche GET api/v2/key_rings-Anforderung gibt eine Sammlung von Schlüsselringen zurück, die in Ihrer Key Protect-Serviceinstanz verfügbar sind.

{
    "metadata": {
        "collectionType": "application/vnd.ibm.kms.key_ring+json",
        "collectionTotal": 2
    },
    "resources": [
        {
            "id": "default"
        },
        {
            "id": "Sample Key Ring 2",
            "creationDate": "2020-03-12T11:00:06Z",
            "createdBy": "..."
        }
    ]
}

Schlüsselringe mit der API löschen

Sie können einen Schlüsselring löschen, indem Sie einen DELETEAufruf an den folgenden Endpunkt ausführen.

https://<region>.kms.cloud.ibm.com/api/v2/key_rings/<key_ring_id>

Diese Aktion wird nicht erfolgreich ausgeführt, wenn der Schlüsselring mindestens einen Schlüssel in einem anderen Status als Gelöscht enthält. Wenn sich die einzigen Schlüssel im Schlüsselring im Status Destroyed befinden, kann der Schlüsselring gelöscht werden, wenn force=true zum Löschbefehl hinzugefügt wird. Die Schlüssel in diesem Status werden automatisch an den Schlüsselring default übertragen.

1. Rufen Sie Ihre Authentifizierungsnachweise ab, um mit den Schlüsseln im Service zu arbeiten.

2. Rufen Sie die ID des Schlüsselrings ab, den Sie löschen möchten.

   Sie können die ID für einen Schlüsselring in Ihrer Key Protect-Instanz finden, indem Sie eine Liste Ihrer Schlüsselringe abrufen.

3. Führen Sie den folgenden curl-Befehl aus, um den Schlüsselring zu löschen. Beachten Sie das Vorhandensein von force=true, wodurch das Löschen des Schlüsselrings erzwungen wird, wenn er Schlüssel im Status Gelöscht enthält.

   $ curl -X DELETE \
       "https://<region>.kms.cloud.ibm.com/api/v2/key_rings/<key_ring_id>?force=true" \
       -H "authorization: Bearer <IAM_token>" \
       -H "bluemix-instance: <instance_ID>" \
       -H "prefer: <return_preference>"
   

   Ersetzen Sie die Variablen in der Beispielanforderung entsprechend der folgenden Tabelle.

Eine erfolgreiche Anforderung gibt eine HTTP-Antwort 204 No Content zurück, die angibt, dass der Schlüsselring erfolgreich gelöscht wurde.