Azure Key Vault-VM-Erweiterung für Windows

Die Azure Key Vault Virtual Machine (VM)-Erweiterung bietet eine automatische Aktualisierung von Zertifikaten, die in einem Azure Key Vault gespeichert sind. Die Erweiterung überwacht eine Liste der in Schlüsseltresoren gespeicherten, berücksichtigten Zertifikate. Wenn eine Änderung erkannt wird, ruft die Erweiterung die entsprechenden Zertifikate ab und installiert sie. In diesem Artikel werden die unterstützten Plattformen, Konfigurationen und Bereitstellungsoptionen für die Key Vault-VM-Erweiterung für Windows beschrieben.

Hinweis

Testen Sie die VM-Unterstützung für eine schnellere Diagnose. Es wird empfohlen, vm assist for Windows or VM assist for Linux auszuführen. Diese skriptbasierten Diagnosetools helfen Ihnen, häufige Probleme zu identifizieren, die sich auf den Azure VM-Gast-Agent und die allgemeine VM-Integrität auswirken.

Wenn Leistungsprobleme mit virtuellen Computern auftreten, führen Sie diese Tools aus, bevor Sie sich an den Support wenden.

Betriebssysteme

Die Key Vault VM-Erweiterung unterstützt Windows Server 2022 und Windows Server 2025 sowohl auf AMD64 als auch ARM64. Auf Windows Server 2025 werden private Schlüssel in KeyGuard gespeichert.

Hinweis

Version 4.0 der Key Vault VM-Erweiterung wird nicht auf Windows Server 2019 oder früheren Versionen installiert.

Unterstützte Zertifikate

Die Vm-Erweiterung Key Vault unterstützt die folgenden Zertifikatinhaltstypen:

  • PKCS #12
  • PEM

Hinweis

Die Key Vault VM-Erweiterung lädt alle Zertifikate in den Windows Zertifikatspeicher oder den Speicherort herunter, den Sie in der Eigenschaft in den certificateStoreLocation VM-Erweiterungseinstellungen angeben.

Features

Die Key Vault VM-Erweiterung für Windows Version 4.x:

  • Installiert private Schlüssel in KeyGuard, wenn sie auf Windows Server 2025 ausgeführt wird und KeyGuard betriebsbereit ist.
  • Installiert die zwei neuesten Versionen jedes Zertifikats.
  • Führt die Überprüfung der Zertifikatkette vor der Installation eines Zertifikats aus, das die Erweiterte Schlüsselverwendung (Extended Key Usage, EKU) der TLS-Serverauthentifizierung enthält, einschließlich Zertifikaten, die andere EKUs zusammenführen (z. B. Clientauthentifizierung). Fehler bei der Kettenvalidierung verursachen einen Bereitstellungsfehler der Erweiterung. Zertifikate ohne die Serverauthentifizierungs-EKU und selbstsignierte Zertifikate (bei denen der Betreff und der Aussteller identisch sind), unterliegen dieser Überprüfung nicht.
  • Verkettet alle Zertifikate auf dem Computer, die von demselben Key Vault Zertifikatobjekt auf die neueste Version dieses Zertifikats stammen.
  • Unterstützt eine optionale Außerkraftsetzung der Authentifizierung pro Zertifikat, die es einzelnen erkannten Zertifikaten ermöglicht, sich mit einer anderen verwalteten Identität als der Standardidentität der Erweiterung bei Key Vault zu authentifizieren. Weitere Informationen finden Sie unter Erweiterungsschema.

Aktualisierung von Version 3.0

Wenn Sie von 3.0 aktualisieren, werden die folgenden Features geändert oder entfernt:

  • pollingIntervalInS ist jetzt auf 5 bis 60 Minuten begrenzt. Standardmäßig führt die Erweiterung einmal pro Stunde eine Abfrage durch.
  • linkOnRenewal wurde entfernt. Verknüpfungen erfolgen immer.
  • keyExportable wurde entfernt. Private Schlüssel können nicht mehr exportiert werden.
  • requireInitialSync wurde entfernt. Die Erweiterung meldet nur erfolg, wenn alle konfigurierten Zertifikate installiert werden.
  • Sie können keine bestimmte Version eines Zertifikats mehr konfigurieren.
  • Die Erweiterung speichert jetzt immer private Schlüssel mithilfe der Kryptografie-API: Next Generation (CNG) anstelle von CAPI.

Voraussetzungen

Überprüfen Sie die folgenden Voraussetzungen für die Verwendung der Key Vault-VM-Erweiterung für Windows:

Hinweis

Sie können auch das alte Zugriffsrichtlinienberechtigungsmodell verwenden, um Zugriff auf VMs und Virtual Machine Scale Sets bereitzustellen. Diese Methode erfordert eine Richtlinie mit den Berechtigungen Abruf und Auflistung für Geheimnisse. Weitere Informationen finden Sie unter Zuweisen einer Key Vault-Zugriffsrichtlinie.

Erweiterungsschema

Im folgenden JSON-Code ist das Schema für die Key Vault-VM-Erweiterung dargestellt. Bevor Sie die Schemaimplementierungsoptionen berücksichtigen, lesen Sie die folgenden wichtigen Hinweise.

  • Für die Erweiterung sind keine geschützten Einstellungen erforderlich. Alle Einstellungen sind öffentliche Informationen.

  • Beobachtete Zertifikat-URLs müssen das Formular https://myVaultName.vault.azure.net/secrets/myCertNameverwenden.

    Dieses Formular ist erforderlich, da der /secrets Pfad das vollständige Zertifikat zurückgibt, einschließlich des privaten Schlüssels, aber der /certificates Pfad nicht. Weitere Informationen zu Zertifikaten finden Sie unter Azure Key Vault-Schlüssel, Geheimschlüssel und Zertifikatübersicht. Sie können keine bestimmte Version des Zertifikats angeben.

  • Der URL-Host muss ein erkannter Azure Key Vault Host sein.

  • Die authenticationSettings Eigenschaft ist für VMs mit allen vom Benutzer zugewiesenen Identitätenerforderlich.

    Diese Eigenschaft gibt die Identität an, die für die Authentifizierung für Key Vault verwendet werden soll. Definieren Sie diese Eigenschaft mit einer vom System zugewiesenen Identität, um Probleme mit einer VM-Erweiterung mit mehreren Identitäten zu vermeiden.

{
   "type": "Microsoft.Compute/virtualMachines/extensions",
   "name": "KVVMExtensionForWindows",
   "apiVersion": "2025-04-01",
   "location": "<location>",
   "dependsOn": [
      "[concat('Microsoft.Compute/virtualMachines/', <vmName>)]"
   ],
   "properties": {
      "publisher": "Microsoft.Azure.KeyVault",
      "type": "KeyVaultForWindows",
      "typeHandlerVersion": "4.0",
      "autoUpgradeMinorVersion": true,
      "enableAutomaticUpgrade": true,
      "settings": {
         "secretsManagementSettings": {
             "observedCertificates": <An array of Key Vault URIs that represent monitored certificates, including certificate store location and ACL permission to certificate private key. Example:
             [
                {
                    "url": <A Key Vault URI to the secret portion of the certificate. Example: "https://myvault.vault.azure.net/secrets/mycertificate1">,
                    "certificateStoreName": <The certificate store name. Example: "MY">,
                    "certificateStoreLocation": <The certificate store location, which currently works locally only. Example: "LocalMachine">,
                    "accounts": <Optional. An array of preferred accounts with read access to certificate private keys. Administrators and SYSTEM get Full Control by default. Example: ["Network Service", "Local Service"]>
                },
                {
                    "url": <Example: "https://myvault.vault.azure.net/secrets/mycertificate2">,
                    "certificateStoreName": <Example: "MY">,
                    "certificateStoreLocation": <Example: "CurrentUser">,
                    "accounts": <Example: ["Local Service"]>,
                    "authenticationOverride": <Optional. Overrides authenticationSettings for this certificate only, so it can authenticate with a different managed identity. Example: {"msiClientId": "11112222-bbbb-3333-cccc-4444dddd5555"}>
                },
                {
                    "url": <Example: "https://myvault.vault.azure.net/secrets/mycertificate3">,
                    "certificateStoreName": <Example: "TrustedPeople">,
                    "certificateStoreLocation": <Example: "LocalMachine">
                }
             ]>
         },
         "authenticationSettings": {
             "msiEndpoint":  <Required when the msiClientId property is used. Specifies the MSI endpoint. Example for most Azure VMs: "http://169.254.169.254/metadata/identity/oauth2/token">,
             "msiClientId":  <Required when the VM has any user assigned identities. Specifies the MSI identity. Example:  "00001111-aaaa-2222-bbbb-3333cccc4444">
         }
      }
   }
}

Immobilienwerte

Das JSON-Schema enthält die folgenden Eigenschaften.

Name Beispiel/Wert Datentyp
apiVersion 2025-04-01 date
publisher Microsoft.Azure.KeyVault Schnur
type KeyVaultForWindows Schnur
typeHandlerVersion "4.0" Schnur
observedCertificates [{...}, {...}] Zeichenfolgenarray
observedCertificates/url „https://myvault.vault.azure.net/secrets/mycertificate" Schnur
observedCertificates/certificateStoreName MY Schnur
observedCertificates/certificateStoreLocation LocalMachine oder CurrentUser (Groß-/Kleinschreibung beachten) Schnur
observedCertificates/accounts (wahlweise) ["Netzwerkdienst"; "Lokaler Dienst"] Zeichenfolgenarray
observedCertificates/authenticationOverride (wahlweise) {"msiClientId": "00001111-aaaa-2222-bbbb-3333cccc4444"} Objekt
msiEndpoint „http://169.254.169.254/metadata/identity/oauth2/token" Schnur
msiClientId 00001111-aaaa-2222-bbbb-3333cccc44444 Schnur

Bereitstellung von Vorlagen

Stellen Sie Azure VM-Erweiterungen mithilfe von AZURE RESOURCE MANAGER(ARM)-Vorlagen bereit. Vorlagen sind ideal, wenn Sie einen oder mehrere virtuelle Computer bereitstellen, die eine Aktualisierung von Zertifikaten nach der Bereitstellung erfordern. Sie können die Erweiterung für einzelne VMs oder Virtual Machine Scale Sets Instanzen bereitstellen. Das Schema und die Konfiguration sind für beide Vorlagentypen gleich.

Die JSON-Konfiguration für eine Key Vault-Erweiterung ist in der VM- oder Virtual Machine Scale Sets-Vorlage eingebettet. Bei einer VM-Ressourcenerweiterung wird die Konfiguration unter dem Objekt des "resources": [] virtuellen Computers geschachtelt. Bei einer Instanzerweiterung von Virtual Machine Scale Sets wird die Konfiguration unter dem "virtualMachineProfile":"extensionProfile":{"extensions" :[]-Objekt verschachtelt.

Die folgenden JSON-Codeausschnitte stellen Beispieleinstellungen für eine ARM-Vorlagenbereitstellung der Key Vault-VM-Erweiterung bereit.

{
   "type": "Microsoft.Compute/virtualMachines/extensions",
   "name": "KeyVaultForWindows",
   "apiVersion": "2025-04-01",
   "location": "<location>",
   "dependsOn": [
      "[concat('Microsoft.Compute/virtualMachines/', <vmName>)]"
   ],
   "properties": {
      "publisher": "Microsoft.Azure.KeyVault",
      "type": "KeyVaultForWindows",
      "typeHandlerVersion": "4.0",
      "autoUpgradeMinorVersion": true,
      "enableAutomaticUpgrade": true,
      "settings": {
         "secretsManagementSettings": {
             "observedCertificates": <An array of Key Vault URIs that represent monitored certificates, including certificate store location and ACL permission to certificate private key. Example:
             [
                {
                    "url": <A Key Vault URI to the secret portion of the certificate. Example: "https://myvault.vault.azure.net/secrets/mycertificate1">,
                    "certificateStoreName": <The certificate store name. Example: "MY">,
                    "certificateStoreLocation": <The certificate store location, which currently works locally only. Example: "LocalMachine">,
                    "accounts": <Optional. An array of preferred accounts with read access to certificate private keys. Administrators and SYSTEM get Full Control by default. Example: ["Network Service", "Local Service"]>
                },
                {
                    "url": <Example: "https://myvault.vault.azure.net/secrets/mycertificate2">,
                    "certificateStoreName": <Example: "MY">,
                    "certificateStoreLocation": <Example: "CurrentUser">,
                    "accounts": <Example: ["Local Service"]>
                },
                {
                    "url": <Example: "https://myvault.vault.azure.net/secrets/mycertificate3">,
                    "certificateStoreName": <Example: "TrustedPeople">,
                    "certificateStoreLocation": <Example: "LocalMachine">
                }
             ]>
         },
         "authenticationSettings": {
            "msiEndpoint":  <Required when the msiClientId property is used. Specifies the MSI endpoint. Example for most Azure VMs: "http://169.254.169.254/metadata/identity/oauth2/token">,
            "msiClientId":  <Required when the VM has any user assigned identities. Specifies the MSI identity. Example: "00001111-aaaa-2222-bbbb-3333cccc4444">
         }
      }
   }
}

Automatisches Upgrade der Erweiterung

Die Key Vault VM-Erweiterung unterstützt das automatische Erweiterungsupgrade für virtuelle Computer und Skalierungssätze in Azure. Azure hält die Erweiterung automatisch auf dem neuesten Stand, wenn Sie die Eigenschaften autoUpgradeMinorVersion und enableAutomaticUpgrade in den vorangegangenen Beispielen auf true festlegen.

Reihenfolge von Erweiterungsabhängigkeiten

Die Key Vault VM-Erweiterung unterstützt die Sortierung von Erweiterungsabhängigkeiten. Die Erweiterung meldet einen erfolgreichen Start nach dem Herunterladen und Installieren aller Zertifikate.

Wenn Sie andere Erweiterungen verwenden, für die eine Installation von Zertifikaten erforderlich ist, bevor sie beginnen, können Sie die Erweiterungsabhängigkeitsbestellung verwenden, um eine Abhängigkeit von der Key Vault VM-Erweiterung zu deklarieren.

Beim Start versucht die Key Vault VM-Erweiterung, das Herunterladen und die Installation von Zertifikaten bis zu 25 Mal erneut, wobei die Rückoff-Zeiträume dabei immer länger werden, und verbleibt in einem Zustand Transitioning. Wenn die Wiederholungen erschöpft sind, meldet die Erweiterung einen Fehler-Status. Nachdem alle Zertifikate erfolgreich installiert wurden, meldet die Key Vault-VM-Erweiterung einen erfolgreichen Start.

Weitere Informationen zum Einrichten von Abhängigkeiten zwischen Erweiterungen finden Sie unter Sequenzerweiterungsbereitstellung in Virtual Machine Scale Sets.

Von Bedeutung

Die Erweiterungsabhängigkeits-Sortierungsfunktion ist nicht mit einer ARM-Vorlage kompatibel, die eine vom System zugewiesene Identität erstellt und eine Key Vault-Zugriffsrichtlinie mit dieser Identität aktualisiert. Wenn Sie versuchen, das Feature in diesem Szenario zu verwenden, tritt ein Deadlock auf, da die Key Vault-Zugriffsrichtlinie erst aktualisiert werden kann, nachdem alle Erweiterungen gestartet wurden. Verwenden Sie stattdessen eine vom Benutzer zugewiesene verwaltete Identität und gewähren Sie dieser Identität vor der Bereitstellung Zugriff auf Ihre Schlüsseltresore.

Azure PowerShell-Bereitstellung

Stellen Sie die Azure Key Vault VM-Erweiterung mithilfe von Azure PowerShell bereit. Speichern Sie die Key Vault-VM-Erweiterungseinstellungen in einer JSON-Datei (settings.json).

Die folgenden JSON-Codeausschnitte stellen Beispieleinstellungen für die Bereitstellung der Key Vault-VM-Erweiterung mithilfe von PowerShell bereit.

{
   "secretsManagementSettings": {
   "observedCertificates":
   [
      {
          "url": "https://<examplekv>.vault.azure.net/secrets/certificate1",
          "certificateStoreName": "MY",
          "certificateStoreLocation": "LocalMachine",
          "accounts": [
             "Network Service"
          ]
      },
      {
          "url": "https://<examplekv>.vault.azure.net/secrets/certificate2",
          "certificateStoreName": "MY",
          "certificateStoreLocation": "LocalMachine",
          "accounts": [
             "Network Service",
             "Local Service"
          ]
      }
   ]},
   "authenticationSettings": {
      "msiEndpoint":  "http://169.254.169.254/metadata/identity/oauth2/token",
      "msiClientId":  "00001111-aaaa-2222-bbbb-3333cccc4444"
   }
}

Bereitstellen auf einer VM

# Build settings
$settings = (get-content -raw ".\settings.json")
$extName =  "KeyVaultForWindows"
$extPublisher = "Microsoft.Azure.KeyVault"
$extType = "KeyVaultForWindows"

# Start the deployment
Set-AzVmExtension -TypeHandlerVersion "4.0" -ResourceGroupName <ResourceGroupName> -Location <Location> -VMName <VMName> -Name $extName -Publisher $extPublisher -Type $extType -SettingString $settings

Bereitstellen in einer Virtual Machine Scale Sets-Instanz

# Build settings
$settings = ".\settings.json"
$extName = "KeyVaultForWindows"
$extPublisher = "Microsoft.Azure.KeyVault"
$extType = "KeyVaultForWindows"

# Add extension to Virtual Machine Scale Sets
$vmss = Get-AzVmss -ResourceGroupName <ResourceGroupName> -VMScaleSetName <VmssName>
Add-AzVmssExtension -VirtualMachineScaleSet $vmss  -Name $extName -Publisher $extPublisher -Type $extType -TypeHandlerVersion "4.0" -Setting $settings

# Start the deployment
Update-AzVmss -ResourceGroupName <ResourceGroupName> -VMScaleSetName <VmssName> -VirtualMachineScaleSet $vmss

Bereitstellung mithilfe der Azure-Befehlszeilenschnittstelle

Stellen Sie die Azure Key Vault VM-Erweiterung mithilfe der Azure CLI bereit. Speichern Sie die Key Vault-VM-Erweiterungseinstellungen in einer JSON-Datei (settings.json).

Die folgenden JSON-Codeausschnitte stellen Beispieleinstellungen für die Bereitstellung der Key Vault VM-Erweiterung mithilfe der Azure CLI bereit.

   {
        "secretsManagementSettings": {
          "observedCertificates": [
            {
                "url": "https://<examplekv>.vault.azure.net/secrets/certificate1",
                "certificateStoreName": "MY",
                "certificateStoreLocation": "LocalMachine",
                "accounts": [
                    "Network Service"
                ]
            },
            {
                "url": "https://<examplekv>.vault.azure.net/secrets/certificate2",
                "certificateStoreName": "MY",
                "certificateStoreLocation": "LocalMachine",
                "accounts": [
                    "Network Service",
                    "Local Service"
                ]
            }
        ]
        },
          "authenticationSettings": {
          "msiEndpoint":  "http://169.254.169.254/metadata/identity/oauth2/token",
          "msiClientId":  "00001111-aaaa-2222-bbbb-3333cccc4444"
        }
     }

Bereitstellen auf einer VM

# Start the deployment
az vm extension set --name "KeyVaultForWindows" `
 --publisher Microsoft.Azure.KeyVault `
 --resource-group "<resourcegroup>" `
 --vm-name "<vmName>" `
 --settings "@settings.json" `
 --version "4.0"

Bereitstellen in einer Virtual Machine Scale Sets-Instanz

# Start the deployment
az vmss extension set --name "KeyVaultForWindows" `
 --publisher Microsoft.Azure.KeyVault `
 --resource-group "<resourcegroup>" `
 --vmss-name "<vmssName>" `
 --settings "@settings.json" `
 --version "4.0"

Tipp

Wenn die Erweiterungsbereitstellung fehlschlägt, müssen Sie die vorhandene Erweiterung möglicherweise löschen, bevor Sie sie mit der richtigen Version erneut installieren. Azure lässt keine Downgrades von Erweiterungen zu, daher müssen Sie die fehlerhafte Erweiterung möglicherweise zuerst entfernen:

az vm extension delete --name "KeyVaultForWindows" --resource-group "<resourcegroup>" --vm-name "<vmName>"

Probleme beheben

Verwenden Sie diese Vorschläge, um Bereitstellungsprobleme zu beheben.

Häufig gestellte Fragen überprüfen

Gibt es eine Beschränkung der Anzahl beobachteter Zertifikate?

Nein. Die Vm-Erweiterung "Key Vault" beschränkt nicht die Anzahl der beobachteten Zertifikate (observedCertificates).

Was ist die Standardberechtigung, wenn kein Konto angegeben wird?

Standardmäßig erhalten Administratoren und SYSTEM vollzugriff.

Wie bestimmen Sie, ob ein Zertifikatschlüssel CAPI1 oder CNG ist?

Ab Key Vault VM-Erweiterung 4.0 speichert die Erweiterung private Schlüssel für alle Zertifikate mithilfe von CNG.

Unterstützt die Erweiterung die automatische Neubindung des Zertifikats?

Ja, die Azure Key Vault-VM-Erweiterung unterstützt die automatische Neubindung von Zertifikaten. Die Key Vault VM-Erweiterung unterstützt die S-Kanalbindung bei der Zertifikatverlängerung.

Für IIS können Sie die automatische Neubindung konfigurieren, indem Sie die automatische Neubindung von Zertifikatverlängerungen in IIS aktivieren. Die Azure Key Vault VM-Erweiterung generiert Zertifikatlebenszyklusbenachrichtigungen, wenn ein erneuertes Zertifikat für dasselbe Key Vault Zertifikatobjekt wie ein vorhandenes Zertifikat installiert wird. IIS verwendet dieses Ereignis, um das Zertifikat automatisch neu zu binden. Weitere Informationen finden Sie unter Certificate Rebind in IIS.

Anzeigen des Erweiterungsstatus

Überprüfen Sie den Status Ihrer Erweiterungsbereitstellung im Azure-Portal, oder mithilfe von PowerShell oder der Azure CLI.

Führen Sie den folgenden Befehl aus, um den Bereitstellungsstatus von Erweiterungen für eine bestimmte VM anzuzeigen.

  • Azure PowerShell:

    Get-AzVMExtension -ResourceGroupName <myResourceGroup> -VMName <myVM> -Name <myExtensionName>
    
  • Die Azure CLI:

    az vm get-instance-view --resource-group <myResourceGroup> --name <myVM> --query "instanceView.extensions"
    

Überprüfen von Protokollen und Konfigurationen

Die Key Vault-VM-Erweiterungsprotokolle sind nur lokal auf der VM vorhanden. Überprüfen Sie die Protokolldetails, um hilfe bei der Problembehandlung zu erhalten.

Protokolldatei BESCHREIBUNG
C:\WindowsAzure\Logs\WaAppAgent.log Zeigt an, wann Aktualisierungen an der Erweiterung vorgenommen werden.
C:\WindowsAzure\Logs\Plugins\Microsoft.Azure.KeyVault.KeyVaultForWindows\<_most recent version_>\ Zeigt den Status des Zertifikatdownloads an. Der Downloadspeicherort ist immer der MY Store des Windows Computers (certlm.msc).
C:\Packages\Plugins\Microsoft.Azure.KeyVault.KeyVaultForWindows\<_most recent version_>\RuntimeSettings\ Die Protokolle des Key Vault-VM-Erweiterungsdiensts zeigen den Status des Diensts akvvm_service an.
C:\Packages\Plugins\Microsoft.Azure.KeyVault.KeyVaultForWindows\<_most recent version_>\Status\ Die Konfigurations- und Binärdateien für den Key Vault VM-Erweiterungsdienst.

Zertifikatinstallation auf Windows

Die Key Vault-VM-Erweiterung für Windows installiert Zertifikate im Windows-Zertifikatspeicher. Wenn die Erweiterung ein Zertifikat von Key Vault herunterlädt, lautet dies:

  1. Installiert alle Zwischen- und Blattzertifikate, unabhängig davon, wie viele Zwischenzertifikate vorhanden sind. Die Erweiterung installiert keine Stammzertifikate, da sie nicht zum Installieren autorisiert sind. Stellen Sie sicher, dass das Stammzertifikat auf dem System vertrauenswürdig ist.
    • Installiert Blattzertifikate im angegebenen Zertifikatspeicher (certificateStoreName) und Speicherort (certificateStoreLocation).
    • Installiert Zwischenzertifikate im Zertifikatspeicher der Zwischenzertifizierungsstellen.
  2. Platziert die Zertifikate im angegebenen Zertifikatspeicher (certificateStoreName) und speicherort (certificateStoreLocation).
  3. Wendet geeignete Berechtigungen auf den privaten Schlüssel gemäß der in der Konfiguration angegebenen accounts an.
  4. Legt die CERT_RENEWAL Eigenschaft fest, sodass Zertifikatbindungen in Anwendungen wie IIS automatisch aktualisiert werden, wenn Zertifikate erneuert werden. Ein Zertifikat wird mit der neuesten Version verkettet, die aus demselben Key Vault Zertifikatobjekt stammt, das von der Key Vault geheimen Basis-URL des Zertifikats identifiziert wird. Zertifikate, die unterschiedlichen Key Vault Zertifikatobjekte entsprechen, werden nie miteinander verknüpft.

Standardzertifikatspeicher

Standardmäßig installiert die Erweiterung Zertifikate an den folgenden Speicherorten:

  • Name des Stores: MY (Persönlich).
  • Speicherort: LocalMachine.

Zertifikatzugriffskontrolle

Standardmäßig erhalten Administratoren und SYSTEM Vollzugriffsberechtigungen für installierte Zertifikate. Sie können den Zugriff mithilfe des accounts Arrays in der Zertifikatkonfiguration anpassen:

"accounts": ["Network Service", "Local Service"]

Diese Konfiguration gewährt Lesezugriff auf die angegebenen Konten, wodurch Anwendungen, die unter diesen Identitäten ausgeführt werden, die Zertifikate verwenden können.

Zertifikaterneuerung

Wenn Zertifikate im Key Vault erneuert werden, führt die Erweiterung dies automatisch durch.

  1. Lädt die neue Zertifikatversion herunter.
  2. Installiert das Zertifikat im konfigurierten Zertifikatspeicher.
  3. Verwaltet vorhandene Bindungen mithilfe der CERT_RENEWAL Eigenschaft.

Verwalten des Zertifikatlebenszyklus

Für Anwendungen wie IIS, die Zertifikatdienste-Lebenszyklusbenachrichtigungen unterstützen, löst die Key Vault VM-Erweiterung Ereignis 1001 im ereignisprotokoll Windows aus, wenn es ein erneuertes Zertifikat für dasselbe Key Vault Zertifikatobjekt wie ein vorhandenes Zertifikat installiert (das neue Zertifikat mit seinem Vorgänger verknüpft). IIS abonniert dieses Ereignis, um das erneuerte Zertifikat automatisch neu zu binden, ohne den Dienst zu unterbrechen. Andere Anwendungen und Teams können auch auf Ereignis 1001 lauschen, um bei Bedarf auf Zertifikatverlängerungen zu reagieren. Weitere Informationen finden Sie unter Certificate Services Lifecycle Notifications.

Unterstützung erhalten

Microsoft bietet nur Unterstützung für die Hauptversion 3.0 und höher der Key Vault VM-Erweiterung. Wenn Sie Version 1.0 verwenden, führen Sie ein Upgrade auf die neueste Version durch, bevor Sie Support anfordern.

Verwenden Sie diese anderen Optionen, um Bereitstellungsprobleme zu beheben:

  • Um Hilfe zu erhalten, wenden Sie sich an die Azure Experten in Microsoft Q& A.

  • Wenn Sie auf der Website keine Antwort finden, können Sie eine Frage an Microsoft oder andere Mitglieder der Community stellen.

  • Sie können auch den Microsoft-Support kontaktieren. Informationen zur Verwendung von Azure-Support finden Sie unter How to create an Azure-Support request.