SSH-Schlüssel über die IBM Cloud-Konsole verwalten

Wenn Sie einen virtuellen Server bereitstellen, können Sie einen neuen SSH-Schlüssel erstellen, aus einer verfügbaren Liste vorhandener SSH-Schlüssel auswählen oder einen neuen hochladen.

1. In IBM Cloud Konsole, gehen Sie zu Navigationsmenü Symbol > Infrastruktur > Compute > SSH Schlüssel. Alle vorhandenen SSH-Schlüssel werden angezeigt.

2. Klicken Sie auf der Registerkarte SSH-Schlüssel für VPC auf das Aktionssymbol für einen SSH-Schlüssel und wählen Sie eine der verfügbaren Optionen aus.

   SSH-Schlüssel-Aktionen

   Aktion	Beschreibung
   Umbenennen	Nachdem Sie einen vorhandenen SSH-Schlüssel aktualisiert haben, wird der Schlüssel sofort umbenannt.
   Löschen	Nachdem Sie einen SSH-Schlüssel entfernt haben, kann er nicht mehr verwendet werden, wenn Sie eine Instanz bereitstellen oder wenn Sie ein Neuladen des Betriebssystems für eine vorhandene Instanz durchführen. Der Schlüssel ist jedoch weiterhin auf allen Instanzen verfügbar, die Sie zuvor mit ihm ausgestattet haben, und Sie können ihn zur Anmeldung verwenden.

   Eine Liste der verfügbaren Regionen für die jeweilige Ressourcengruppe wird angezeigt.

SSH-Schlüssel über die Befehlszeilenschnittstelle verwalten

Zur Verwaltung Ihrer SSH-Schlüssel können Sie auch die Befehlszeilenschnittstelle verwenden.

Stellen Sie sicher, dass das Plug-in IBM Cloud CLI vpc-infrastructure installiert ist. Weitere Informationen finden Sie unter IBM Cloud-Befehlszeilenschnittstelle für VPC.

Verwaltung von SSH-Schlüsseln über die API

Sie können Ihre SSH-Schlüssel auch über die API verwalten. Weitere Informationen zu den Variablen $vpc_api_endpoint und $iam_token in den folgenden Beispielen finden Sie in den Abschnitten Authentifizierung und Endpunkt-URLs in der Virtual Private Cloud API-Einführung.

SSH-Schlüssel mit Terraform verwalten

Sie können Ihre SSH-Schlüssel auch mit Terraform verwalten. Weitere Informationen finden Sie unter ibm_is_ssh_keys.

Alle SSH-Schlüssel über die Benutzerschnittstelle auflisten

Gehen Sie wie folgt vor, um alle SSH-Schlüssel aufzulisten.

1. In IBM Cloud Konsole, gehen Sie zu Navigationsmenü Symbol > Infrastruktur > Compute > SSH Schlüssel.
2. Alle vorhandenen SSH-Schlüssel werden angezeigt.

Alle SSH-Schlüssel über die Befehlszeilenschnittstelle auflisten

Verwenden Sie den Befehl ibmcloud is keys, um alle vorhandenen SSH-Schlüssel anzuzeigen.

Verwenden Sie die Option --all-resource-groups, um die SSH-Schlüssel für alle verfügbaren Ressourcengruppen aufzulisten. Optional können Sie die Liste filtern, um nur SSH-Schlüssel für eine bestimmte Ressourcengruppe einzuschließen. Geben Sie die Ressourcengruppe mit der Variablen RESOURCE_GROUP_ID oder RESOURCE_GROUP_NAME an. Weitere Informationen finden Sie unter ibmcloud is keys.

ibmcloud is keys [--all-resource-groups]

Alle SSH-Schlüssel mithilfe der API auflisten

Um alle SSH-Schlüssel mithilfe der API aufzulisten, verwenden Sie Alle Schlüssel auflisten.

curl -X GET "$vpc_api_endpoint/v1/keys?version=2023-03-30&generation=2" -H "Authorization: Bearer $iam_token"

Alle SSH-Schlüssel mit Terraform auflisten

Verwenden Sie ibm_is_ssh_keys, um alle SSH-Schlüssel mithilfe von Terraform aufzulisten.

data "ibm_is_ssh_keys" keys {}

Details Ihres SSH-Schlüssels über die Benutzerschnittstelle anzeigen

Sie können die folgenden Details eines SSH-Schlüssels anzeigen.

• Name
• Ressourcengruppe
• Fingerabdruck
• Typ
• Länge
• Erstellungsdatum (lokal)

Gehen Sie wie folgt vor, um Details zu einem SSH-Schlüssel anzuzeigen.

1. In IBM Cloud Konsole, gehen Sie zu Navigationsmenü Symbol > Infrastruktur > Compute > SSH Schlüssel.
2. Auf der Seite SSH-Schlüssel für VPC wird eine Liste aller vorhandenen SSH-Schlüssel angezeigt.
3. Im Menü Aktionen können Sie den SSH-Schlüssel umbenennen oder löschen.

Details Ihres SSH-Schlüssels über die Befehlszeilenschnittstelle (CLI) anzeigen

Sie können den Namen des Schlüssels und die ID des Schlüssels mit dem Befehl ibmcloud is key anzeigen. Geben Sie den Namen des SSH-Schlüssels mit der Variablen KEY an. Weitere Informationen finden Sie unter ibmcloud is key im VPC CLI-Referenzhandbuch.

ibmcloud is key KEY

Details Ihres SSH-Schlüssels mithilfe der API anzeigen

Verwenden Sie Schlüssel abrufen, um Informationen für einen bestimmten Schlüssel mithilfe der API abzurufen.

Geben Sie für die Variable $id den Namen des SSH-Schlüssels an, für den Sie Details anzeigen möchten.

curl -X GET "$vpc_api_endpoint/v1/keys/$id?version=2023-03-30&generation=2" -H "Authorization: Bearer $iam_token"

Details Ihres SSH-Schlüssels mit Terraform anzeigen

Wenn Sie Informationen für einen bestimmten Schlüssel mithilfe von Terraform abrufen möchten, verwenden Sie ibm_is_ssh_keys.

Geben Sie für die Variable name den Namen des SSH-Schlüssels an, für den Sie Details anzeigen möchten.

data "ibm_is_ssh_key" "example" {
  name = "example-ssh-key"
}

Erstellen eines SSH-Schlüssels über die Benutzeroberfläche

Führen Sie die folgenden Schritte aus, um einen neuen SSH-Schlüssel zu erstellen: Sie können nur RSH-SSH-Schlüsseltypen erstellen. Um einen Ed25519-SSH-Schlüssel zu verwenden, muss dieser SSH-Schlüssel importiert werden. Weitere Informationen finden Sie unter SSH-Schlüssel über die Benutzerschnittstelle importieren.

1. In IBM Cloud Konsole, gehen Sie zu Navigationsmenü Symbol > Infrastruktur > Compute > SSH Schlüssel.

2. Klicken Sie auf Erstellen und geben Sie die Informationen aus Tabelle 1 ein.

   Erstellen eines SSH-Schlüssels für VPC-Auswahlen

   Feld	Wert
   Standorte	Standorte setzen sich aus Regionen (bestimmte geografische Gebiete) und Zonen (fehlertolerante Rechenzentren innerhalb einer Region) zusammen. Wählen Sie den Ort, an dem Sie Ihren SSH-Schlüssel erstellen möchten.
   Name	Ein Name ist für Ihren SSH-Schlüssel erforderlich
   Ressourcengruppe	Wählen Sie eine Ressourcengruppe für den SSH-Schlüssel aus.
   Tags	Sie können dem SSH-Schlüssel einen Benutzertag zuordnen, damit Sie ohne großen Aufwand eine Liste von SSH-Schlüsseln filtern können. Weitere Informationen finden Sie unter Mit Tags arbeiten.
   Zugriffsmanagement-Tags	Zugriffsmanagement-Tags helfen Ihnen, flexible Zugriffsrichtlinien auf bestimmte Ressourcen anzuwenden. Weitere Informationen finden Sie im Lernprogramm Zugriff auf Ressourcen mithilfe von Tags steuern in der Benutzerschnittstelle.
   SSH-Schlüsseltyp	Der Standardwert ist rsa.Sie können neue RSA-Schlüsselpaare über die Benutzerschnittstelle generieren. Bereits vorhandene RSA-und Ed25519-SSH-Schlüssel können hochgeladen werden. Ed25519 kann nur verwendet werden, wenn das Betriebssystem diesen Schlüsseltyp unterstützt. Ed25519 kann nicht mit Windows- oder VMware verwendet werden.

3. Wählen Sie Schlüsselpaar für mich generieren.

4. Klicken Sie optional auf API-Beispielaufruf abrufen, um einen API-Code mit allen SSH-Schlüsselinformationen abzurufen, die Sie kopieren können.

5. Klicken Sie auf Erstellen.

Ihr neuer SSH-Schlüssel wird jetzt in der Liste der SSH-Schlüssel in der Benutzerschnittstelle angezeigt.

SSH-Schlüssel über die Benutzerschnittstelle importieren

Sie können einen SSH-Schlüssel auf zwei Arten importieren. Sie können einen öffentlichen Schlüssel aus einer lokalen Datei hochladen. Alternativ können Sie Ihren öffentlichen Schlüssel kopieren und in die Benutzerschnittstelle einfügen.

Verwenden Sie die folgenden Schritte, um einen SSH-Schlüssel aus einer lokalen Datei zu importieren.

1. In IBM Cloud Konsole, gehen Sie zu Navigationsmenü Symbol > Infrastruktur > Compute > SSH Schlüssel.

2. Klicken Sie auf Erstellen und geben Sie die Informationen aus Tabelle 1 ein.

   Erstellen eines SSH-Schlüssels für VPC-Auswahlen

   Feld	Wert
   Standorte	Standorte setzen sich aus Regionen (bestimmte geografische Gebiete) und Zonen (fehlertolerante Rechenzentren innerhalb einer Region) zusammen. Wählen Sie den Ort, an dem Sie Ihren SSH-Schlüssel erstellen möchten.
   Name	Ein Name ist für Ihren SSH-Schlüssel erforderlich
   Ressourcengruppe	Wählen Sie eine Ressourcengruppe für den SSH-Schlüssel aus.
   Tags	Sie können dem SSH-Schlüssel einen Benutzertag zuordnen, damit Sie ohne großen Aufwand eine Liste von SSH-Schlüsseln filtern können. Weitere Informationen finden Sie unter Mit Tags arbeiten.
   Zugriffsmanagement-Tags	Zugriffsmanagement-Tags helfen Ihnen, flexible Zugriffsrichtlinien auf bestimmte Ressourcen anzuwenden. Weitere Informationen finden Sie im Lernprogramm Zugriff auf Ressourcen mithilfe von Tags steuern in der Benutzerschnittstelle.
   SSH-Schlüsseltyp	Wählen Sie einen Schlüsseltyp für den SSH-Schlüssel aus. Der Standardwert ist rsa. Der SSH-Schlüsseltyp ed25519 kann nur zum Erstellen von Instanzen verwendet werden, wenn das Betriebssystem diesen Schlüsseltyp unterstützt. Dieser Schlüsseltyp kann nicht mit Windows-oder VMware-Images verwendet werden.

3. Wählen Sie Vorhandenen öffentlichen Schlüssel bereitstellen.

4. Klicken Sie auf Öffentlichen Schlüssel hochladen.

5. Wählen Sie die Datei mit dem öffentlichen Schlüssel aus und klicken Sie auf Öffnen. Die Dateierweiterung .pub gibt normalerweise an, welche Datei den öffentlichen Schlüssel enthält.

6. Klicken Sie optional auf API-Beispielaufruf abrufen, um einen API-Code mit allen SSH-Schlüsselinformationen abzurufen, die Sie kopieren können.

7. Klicken Sie auf Erstellen.

Wenn Sie einen SSH-Schlüssel aus einem Terminal kopieren, um den Schlüssel zu Ihrem VPC hinzuzufügen, werden manchmal zusätzliche Zeilenumbrüche eingefügt, die einen Parsing-Fehler verursachen. Um dieses Problem zu vermeiden, fügen Sie Ihren SSH-Schlüssel zunächst in einem Texteditor ein und entfernen Sie alle zusätzlich eingefügten Zeilenumbrüche. Kopieren Sie anschließend den SSH-Schlüssel aus dem Texteditor und fügen Sie ihn in der VPC-Benutzerschnittstelle, der CLI oder der API ein.

Der importierte SSH-Schlüssel wird jetzt in der Liste der SSH-Schlüssel in der Benutzerschnittstelle angezeigt.

SSH-Schlüssel über die Befehlszeilenschnittstelle importieren

Um einen SSH-Schlüssel über die Befehlszeilenschnittstelle zu importieren, verwenden Sie den Befehl ibmcloud is key-create. Die Datei, die Sie importieren, ist id_rsa.pub oder id_ed25519.pub, die Ihren öffentlichen Schlüssel enthält. Sie müssen den Namen oder die ID des SSH-Schlüssels mit der Variablen KEY_NAME und den öffentlichen SSH-Schlüssel angeben, den Sie mit der Variablen KEY importieren. Geben Sie den SSH-Schlüsseltyp mit der Option --key-type an. Optional können Sie beim Erstellen des SSH-Schlüssels eine Ressourcengruppe angeben. Geben Sie die Ressourcengruppe mit der Variablen RESOURCE_GROUP_ID oder RESOURCE_GROUP_NAME an. Weitere Informationen finden Sie unter ibmcloud is key-create im Referenzhandbuch zur VPC-CLI.

ibmcloud is key-create KEY_NAME (KEY | @KEY_FILE) [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [--key-type KEY_TYPE]

SSH-Schlüssel mithilfe der API importieren

Um einen neuen SSH-Schlüssel mithilfe der API zu importieren, verwenden Sie die Option Schlüssel erstellen. Die Datei, die Sie importieren, ist id_rsa.pub oder id_ed25519.pub, die Ihren öffentlichen Schlüssel enthält. Sie können keinen brandneuen SSH-Schlüssel über die API erstellen. Sie können jedoch einen neuen SSH-Schlüssel erstellen, indem Sie die Benutzerschnittstelle verwenden und das erforderliche API-Code-Snippet generieren, das den neuen SSH-Schlüssel enthält. Weitere Informationen finden Sie unter SSH-Schlüssel mithilfe der Benutzerschnittstelle erstellen.

Geben Sie für die Eigenschaft name den Namen des SSH-Schlüssels an. Geben Sie für die Eigenschaft public_key die Informationen zum öffentlichen Schlüssel ein. Geben Sie für die Eigenschaft type entweder rsa oder ed25519 als SSH-Schlüsseltyp an.

Der SSH-Schlüsseltyp Ed25519 kann nur zum Erstellen von Instanzen verwendet werden, wenn das Betriebssystem diesen Schlüsseltyp unterstützt. Dieser Schlüsseltyp kann nicht mit Windows-oder VMware-Images verwendet werden.

curl -X POST "$vpc_api_endpoint/v1/keys?version=2023-03-30&generation=2" -H "Authorization: Bearer $iam_token" -d '{
      "name":"my-key-1",
      "public_key":"AAAAB3NzaC1yc2EAAAADAQABAAABAQDDGe50Bxa5T5NDddrrtbx2Y4/VGbiCgXqnBsYToIUKoFSHTQl5IX3PasGnneKanhcLwWz5M5MoCRvhxTp66NKzIfAz7r+FX9rxgR+ZgcM253YAqOVeIpOU408simDZKriTlN8kYsXL7P34tsWuAJf4MgZtJAQxous/2byetpdCv8ddnT4X3ltOg9w+LqSCPYfNivqH00Eh7S1Ldz7I8aw5WOp5a+sQFP/RbwfpwHp+ny7DfeIOokcuI42tJkoBn7UsLTVpCSmXr2EDRlSWe/1M/iHNRBzaT3CK0+SwZWd2AEjePxSnWKNGIEUJDlUYp7hKhiQcgT5ZAnWU121oc5En",
      "type":"rsa"
    }'

SSH-Schlüssel mit Terraform importieren

Um einen neuen SSH-Schlüssel mithilfe von Terraform zu importieren, verwenden Sie ibm_is_ssh_keys.

Gehen Sie wie folgt vor, um einen neuen SSH-Schlüssel zu importieren.

1. Erstellen Sie den Ressourcenblocktyp ibm_is_ssh_key mit den erforderlichen Werten. Geben Sie für das Attribut name den Pseudonamen des SSH-Schlüssels an. Geben Sie für das Attribut public_key die Dummy-Informationen zum öffentlichen Schlüssel ein.

   resource "ibm_is_ssh_key" "example_sshkey" {
     name = "my-key"
     public_key = "public-key"
   }
   

2. Führen Sie nach der Erstellung der Ressource den folgenden Terraform-Befehl aus, um den SSH-Schlüssel zu importieren.

 terraform import ibm_is_ssh_key.example_sshkey d7bec597-4726-451f-8a63-e62e6f19c32c

1. Verbessern Sie die Konfiguration so, dass sie dem Status entspricht. Kopieren Sie die Ressourcenblockdetails, um das Ersetzen des Ressourcenblocks zu vermeiden.

   resource "ibm_is_ssh_key" "example_sshkey" {
      name       = "example-sshkey"
      public_key = "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQCKVmnMOlHKcZK8tpt3MP1lqOLAcqcJzhsvJcjscgVERRN7/9484SOBJ3HSKxxNG5JN8owAjy5f9yYwcUg+JaUVuytn5Pv3aeYROHGGg+5G346xaq3DAwX6Y5ykr2fvjObgncQBnuU5KHWCECO/4h8uWuwh/kfniXPVjFToc+gnkqA+3RKpAecZhFXwfalQ9mMuYGFxn+fwn8cYEApsJbsEmb0iJwPiZ5hjFC8wREuiTlhPHDgkBLOiycd20op2nXzDbHfCHInquEe/gYxEitALONxm0swBOwJZwlTDOB7C6y2dzlrtxr1L59m7pCkWI4EtTRLvleehBoj3u7jB4usR"
      type = "rsa"
   }
   

SSH-Schlüssel über die Befehlszeilenschnittstelle aktualisieren

Sie können einen bestehenden Schlüssel mit dem Befehl ibmcloud is key-update aktualisieren. Nachdem Sie einen vorhandenen Schlüssel aktualisiert haben, wird der Schlüssel sofort umbenannt. Weitere Informationen finden Sie unter ibmcloud is key-delete. Sie müssen sowohl den aktuellen SSH-Schlüsselnamen mit der Variablen KEY als auch den neuen SSH-Schlüsselnamen mit der Variablen NEW_NAME in der Option --name angeben.

ibmcloud is key-update KEY [--name NEW_NAME]

Aktualisieren Ihres SSH-Schlüssels mit Hilfe der API

Um einen vorhandenen SSH-Schlüssel über die API zu aktualisieren, verwenden Sie Schlüssel aktualisieren. Nachdem Sie einen vorhandenen Schlüssel aktualisiert haben, wird der Schlüssel sofort umbenannt.

Geben Sie für die Variable $id den aktuellen Namen des SSH-Schlüssels an. Geben Sie für die Eigenschaft name den neuen Namen für den SSH-Schlüssel an.

curl -X PATCH "$vpc_api_endpoint/v1/keys/$id?version=2023-03-30&generation=2" -H "Authorization: Bearer $iam_token" -d '{ "name": "my-key-1-updated" }'

SSH-Schlüssel mit Terraform aktualisieren

Um einen vorhandenen SSH-Schlüssel mithilfe von Terraform zu aktualisieren, verwenden Sie ibm_is_ssh_keys. Nachdem Sie einen vorhandenen Schlüssel aktualisiert haben, wird der Schlüssel sofort umbenannt.

1. Aktualisieren Sie den SSH-Schlüsselressourcenblock. Geben Sie für die Eigenschaft name den neuen Namen für den SSH-Schlüssel an.

      resource "ibm_is_ssh_key" "example_sshkey" {
      name       = "new-example-sshkey"
      public_key = "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQCKVmnMOlHKcZK8tpt3MP1lqOLAcqcJzhsvJcjscgVERRN7/9484SOBJ3HSKxxNG5JN8owAjy5f9yYwcUg+JaUVuytn5Pv3aeYROHGGg+5G346xaq3DAwX6Y5ykr2fvjObgncQBnuU5KHWCECO/4h8uWuwh/kfniXPVjFToc+gnkqA+3RKpAecZhFXwfalQ9mMuYGFxn+fwn8cYEApsJbsEmb0iJwPiZ5hjFC8wREuiTlhPHDgkBLOiycd20op2nXzDbHfCHInquEe/gYxEitALONxm0swBOwJZwlTDOB7C6y2dzlrtxr1L59m7pCkWI4EtTRLvleehBoj3u7jB4usR"
      type = "rsa"
   }
   

2. Führen Sie terraform apply aus, um die Ressource mit dem neuen Namen zu aktualisieren.

Löschen Ihres SSH-Schlüssels mit der CLI

Um einen oder mehrere SSH-Schlüssel über die Befehlszeilenschnittstelle zu löschen, verwenden Sie den Befehl ibmcloud is key-delete. Weitere Informationen finden Sie unter ibmcloud is key-delete. Geben Sie mit der Variablen KEY den Namen jedes SSH-Schlüssels an, den Sie löschen.

ibmcloud is key-delete (KEY1 KEY2 ...)

Löschen Ihres SSH-Schlüssels mit Hilfe der API

Um einen oder mehrere SSH-Schlüssel mithilfe der API zu löschen, verwenden Sie Schlüssel löschen.

Geben Sie für die Variable $id den Namen des SSH-Schlüssels an, den Sie löschen wollen.

curl -X DELETE "$vpc_api_endpoint/v1/keys/$id?version=2023-03-30&generation=2" -H "Authorization: Bearer $iam_token"

SSH-Schlüssel mit Terraform löschen

Verwenden Sie ibm_is_ssh_keys, um Ihren SSH-Schlüssel mithilfe von Terraform zu löschen.

Ersetzen Sie das Attribut example_sshkey durch den SSH-Schlüssel, den Sie löschen möchten.

terraform destroy --target ibm_is_ssh_keys.example_sshkey