Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Dieser Artikel ist der dritte Teil einer vierteiligen Tutorialserie. Teil eins bietet einen Überblick über kundenseitig verwaltete Schlüssel, ihre Funktionen und die zu berücksichtigenden Aspekte, bevor Sie einen solchen Schlüssel für Ihre Registrierung aktivieren. Im zweiten Teil erfahren Sie, wie Sie kundenseitig verwaltete Schlüssel mithilfe der Azure CLI, mit dem Azure-Portal oder einer Azure Resource Manager-Vorlage aktivieren. In diesem Artikel werden die Schritte zum Rotieren, Aktualisieren und Widerrufen eines kundenseitig verwalteten Schlüssels erläutert.
Rotieren eines kundenseitig verwalteten Schlüssels
Um einen Schlüssel zu rotieren, können Sie entweder die Schlüsselversion in Azure Key Vault oder Azure Key Vault Managed HSM aktualisieren oder einen neuen Schlüssel erstellen. Beim Rotieren des Schlüssels können Sie dieselbe Identität angeben, die Sie zum Erstellen der Registrierung verwendet haben.
Optional können Sie:
- Konfigurieren Sie eine neue benutzerseitig zugewiesene Identität, um auf den Schlüssel zuzugreifen.
- Aktivieren Sie die systemseitig zugewiesene Identität der Registrierung, und geben Sie sie an.
Hinweis
Um die systemseitig zugewiesene Identität der Containerregistrierung im Portal zu aktivieren, wählen Sie Einstellungen>Identität aus, und legen Sie den Status der systemseitig zugewiesenen Identität auf Ein fest.
Stellen Sie sicher, dass die Identität über den erforderlichen Zugriff auf den Schlüsselspeicher verfügt. Zu einem Schlüsseltresor siehe Aktivieren verwalteter Identitäten für den Zugriff auf den Schlüsseltresor. Weisen Sie für verwaltetes HSM die lokale RBAC-Rolle "Managed HSM Crypto Service Encryption User" auf Schlüsselbereichsebene zu.
Erstellen oder aktualisieren Sie die Schlüsselversion mithilfe der Azure CLI
Führen Sie den Befehl az keyvault key create aus, um eine neue Schlüsselversion in einem Schlüsseltresor zu erstellen:
# Create new version of existing key
az keyvault key create \
--name <key-name> \
--vault-name <key-vault-name>
Verwenden Sie den --hsm-name Parameter, um eine neue Schlüsselversion in verwaltetem HSM zu erstellen:
az keyvault key create \
--name <key-name> \
--hsm-name <managed-hsm-name> \
--kty RSA-HSM \
--ops wrapKey unwrapKey
Wenn Sie die Containerregistrierung so konfigurieren, dass Schlüsselversionsupdates erkannt werden, wird der vom Kunden verwaltete Schlüssel innerhalb einer Stunde automatisch aktualisiert, unabhängig davon, ob der Schlüssel in Key Vault oder Managed HSM gespeichert wird.
Wenn Sie die Registry für die manuelle Aktualisierung auf eine neue Schlüsselversion konfigurieren, führen Sie den Befehl az-acr-encryption-rotate-key aus. Übergeben Sie die neue Schlüssel-ID und die Identität, die Sie konfigurieren möchten.
Tipp
Wenn Sie az-acr-encryption-rotate-key ausführen, können Sie entweder eine versionierte Schlüssel-ID oder eine nicht versionierte Schlüssel-ID übergeben. Wenn Sie eine nicht versionierte Schlüssel-ID verwenden, wird die Registrierung so konfiguriert, dass spätere Aktualisierungen der Schlüsselversion automatisch erkannt werden.
Sie haben drei Optionen, um die Version eines kundenseitig verwalteten Schlüssels manuell zu aktualisieren:
- Rotieren Sie den Schlüssel, und verwenden Sie eine Client-ID einer verwalteten Identität.
Wenn Sie einen Schlüssel aus einem anderen Schlüsseltresor verwenden, vergewissern Sie sich, dass die Identität über die Berechtigungen get, wrap und unwrap verfügt. Stellen Sie für verwaltetes HSM sicher, dass die Identität die Rolle " Managed HSM Crypto Service Encryption User" im Schlüsselbereich besitzt.
az acr encryption rotate-key \
--name <registry-name> \
--key-encryption-key <new-key-id> \
--identity <client ID of a managed identity>
- Rotieren des Schlüssels und Verwenden einer benutzerseitig zugewiesenen Identität:
Bevor Sie die vom Benutzer zugewiesene Identität verwenden, überprüfen Sie, ob ihr die erforderlichen Key Vault-Berechtigungen oder die lokale Managed HSM-RBAC-Rolle zugewiesen sind.
az acr encryption rotate-key \
--name <registry-name> \
--key-encryption-key <new-key-id> \
--identity <id of user assigned identity>
- Rotieren des Schlüssels und Verwenden einer systemseitig zugewiesenen Identität:
Bevor Sie die vom System zugewiesene Identität verwenden, überprüfen Sie, ob ihr die erforderlichen Key Vault-Berechtigungen oder die lokale Managed HSM-RBAC-Rolle zugewiesen sind.
az acr encryption rotate-key \
--name <registry-name> \
--key-encryption-key <new-key-id> \
--identity [system]
Erstellen oder aktualisieren Sie die Schlüsselversion über das Azure-Portal
Verwenden Sie die Verschlüsselungseinstellungen der Registrierung, um den Key Vault- oder Managed HSM-Schlüssel und die Identitätseinstellungen für einen vom Kunden verwalteten Schlüssel zu aktualisieren.
Zum Beispiel zum Konfigurieren eines neuen Schlüssels:
Wechseln Sie im Portal zu Ihrer Registrierung.
Wählen Sie unter Einstellungen die Option Verschlüsselung>Schlüssel ändern aus.
Wählen Sie für "Identität" eine verwaltete Identität aus, die Zugriff auf den neuen Schlüssel hat.
Wählen Sie unter Verschlüsselung eine der folgenden Optionen aus:
- Wählen Sie Aus Key Vault wählen aus, und öffnen Sie dann das Schlüsselauswahlfeld unter Verschlüsselungsschlüssel. Wählen Sie das Abonnement aus, legen Sie den Schlüsselspeichertyp auf Key Vault oder verwaltetes HSM fest, und wählen Sie den Schlüsselspeicher und den Schlüssel aus. Wählen Sie "Auswählen" aus, um dies zu bestätigen. Der ausgewählte Schlüssel ist nicht versioniert und ermöglicht automatische Schlüsselrotation.
- Wählen Sie Schlüssel-URI eingeben aus, und geben Sie einen Key Vault- oder verwalteten HSM-Schlüsselbezeichner direkt an. Sie können den URI eines versionierten Schlüssels (für einen Schlüssel, den Sie manuell rotieren müssen) oder eines Schlüssels ohne Versionsangabe (aktiviert die automatische Schlüsselrotation) angeben.
Wählen Sie "Speichern" aus, um die neuen Schlüssel- und Identitätseinstellungen anzuwenden.
Einen kundenseitig verwalteten Schlüssel widerrufen
Sie können einen vom Kunden verwalteten Verschlüsselungsschlüssel widerrufen, indem Sie den Zugriff der Registrierungsidentität auf den Schlüssel entfernen oder den Schlüssel löschen.
Zugriff auf einen Schlüssel in einem Schlüsseltresor widerrufen
Führen Sie den Befehl az-keyvault-delete-policy aus, um die Zugriffsrichtlinie für die verwaltete Identität zu ändern, die von Ihrer Registrierung verwendet wird:
az keyvault delete-policy \
--resource-group <resource-group-name> \
--name <key-vault-name> \
--object-id <identity-principal-id>
Wenn die key vault Azure RBAC anstelle von Zugriffsrichtlinien verwendet, entfernen Sie die entsprechende Key Vault Rollenzuweisung.
Widerrufen des Zugriffs auf einen Schlüssel in Managed HSM
Verwaltetes HSM unterstützt Key Vault Zugriffsrichtlinien nicht. Entfernen Sie die lokale RBAC-Zuweisung für die Registrierungsidentität. Verwenden Sie denselben Geltungsbereich, in dem Sie die Zuweisung erstellt haben. Im folgenden Beispiel wird eine schlüsselbereichsbezogene Zuweisung entfernt:
az keyvault role assignment delete \
--hsm-name <managed-hsm-name> \
--role "Managed HSM Crypto Service Encryption User" \
--assignee-object-id <identity-principal-id> \
--scope /keys/<key-name>
Eine bei /keys oder / erstellte Aufgabe wird nicht durch einen Befehl entfernt, der /keys/<key-name> angibt.
Verschlüsselungsschlüssel löschen
Führen Sie den Befehl az-keyvault-key-delete aus, um einen Schlüssel aus einem Schlüsseltresor zu löschen. Für diesen Vorgang wird die Berechtigung keys/delete benötigt.
az keyvault key delete \
--vault-name <key-vault-name> \
--name <key-name>
Verwenden Sie den --hsm-name Parameter, um einen Schlüssel aus Managed HSM zu löschen:
az keyvault key delete \
--hsm-name <managed-hsm-name> \
--name <key-name>
Hinweis
Durch das Widerrufen eines kundenseitig verwalteten Schlüssels wird der Zugriff auf alle Registrierungsdaten gesperrt. Wenn Sie den Zugriff auf den Schlüssel aktivieren oder einen gelöschten Schlüssel wiederherstellen, wählt die Registrierung den Schlüssel aus, und Sie können erneut Zugriff auf die verschlüsselten Registrierungsdaten erhalten.
Nächste Schritte
Fahren Sie mit dem nächsten Artikel fort, um eine Problembehandlung für die häufigsten Fehler durchzuführen, z. B. das Entfernen einer verwalteten Identität, 403-Fehler und versehentliches Löschen von Schlüsseln.