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.
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:
-
pollingIntervalInSist jetzt auf 5 bis 60 Minuten begrenzt. Standardmäßig führt die Erweiterung einmal pro Stunde eine Abfrage durch. -
linkOnRenewalwurde entfernt. Verknüpfungen erfolgen immer. -
keyExportablewurde entfernt. Private Schlüssel können nicht mehr exportiert werden. -
requireInitialSyncwurde 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:
Eine Azure Key Vault-Instanz mit einem Zertifikat. Weitere Informationen finden Sie unter Einen Schlüsseltresor mit dem Azure-Portal erstellen.
Eine VM mit einer zugewiesenen verwalteten Identität.
Weisen Sie der verwalteten Identität für die VM oder Azure Virtual Machine Scale Sets die Rolle Key Vault-Geheimnisbenutzer auf der Bereichsebene des Schlüsseltresors zu. Diese Rolle ruft den geheimen Teil eines Zertifikats ab. Weitere Informationen finden Sie in den folgenden Artikeln:
Konfigurieren Sie Skalierungssätze für virtuelle Computer mit der folgenden
identity-Konfiguration:"identity": { "type": "UserAssigned", "userAssignedIdentities": { "[parameters('userAssignedIdentityResourceId')]": {} } }Konfigurieren Sie die Key Vault VM-Erweiterung mit der folgenden
authenticationSettingsKonfiguration:"authenticationSettings": { "msiEndpoint": "[parameters('userAssignedIdentityEndpoint')]", "msiClientId": "[reference(parameters('userAssignedIdentityResourceId'), variables('msiApiVersion')).clientId]" }
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
/secretsPfad das vollständige Zertifikat zurückgibt, einschließlich des privaten Schlüssels, aber der/certificatesPfad 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
authenticationSettingsEigenschaft 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:
- 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.
- Installiert Blattzertifikate im angegebenen Zertifikatspeicher (
- Platziert die Zertifikate im angegebenen Zertifikatspeicher (
certificateStoreName) und speicherort (certificateStoreLocation). - Wendet geeignete Berechtigungen auf den privaten Schlüssel gemäß der in der Konfiguration angegebenen
accountsan. - Legt die
CERT_RENEWALEigenschaft 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.
- Lädt die neue Zertifikatversion herunter.
- Installiert das Zertifikat im konfigurierten Zertifikatspeicher.
- Verwaltet vorhandene Bindungen mithilfe der
CERT_RENEWALEigenschaft.
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.