Azure Resource Graph-voorbeeldqueries voor Azure Key Vault

Deze pagina is een verzameling Azure Resource Graph-voorbeeldquery's voor Azure Key Vault.

Voorbeeldvragen

Sleutelkluisresources tellen

Deze query gebruikt count in plaats van summarize om het aantal geretourneerde records te tellen. Alleen sleutelkluizen worden geteld.

Resources
| where type =~ 'microsoft.keyvault/vaults'
| count

az graph query -q "Resources | where type =~ 'microsoft.keyvault/vaults' | count"

Sleutelkluizen zonder soft delete ingeschakeld

Deze query identificeert sleutelkluizen waarvoor voorlopig verwijderen niet is ingeschakeld. Dit is een kritieke beveiligingsfunctie waarmee verwijderde sleutelkluisobjecten kunnen worden hersteld.

Resources
| where type =~ 'microsoft.keyvault/vaults'
| where properties.enableSoftDelete == false or isnull(properties.enableSoftDelete)
| project name, resourceGroup, subscriptionId, location, properties.enableSoftDelete

az graph query -q "Resources | where type =~ 'microsoft.keyvault/vaults' | where properties.enableSoftDelete == false or isnull(properties.enableSoftDelete) | project name, resourceGroup, subscriptionId, location, properties.enableSoftDelete"

Sleutelkluizen zonder beveiliging tegen opschonen ingeschakeld

Met deze query worden sleutelkluizen gevonden waarvoor geen verwijderingsbeveiliging is ingeschakeld. Beveiliging tegen verwijderen wordt aanbevolen voor productieomgevingen om permanente verwijdering van sleutelkluisobjecten tijdens de retentieperiode te voorkomen.

Resources
| where type =~ 'microsoft.keyvault/vaults'
| where properties.enablePurgeProtection != true
| project name, resourceGroup, subscriptionId, location, softDeleteEnabled = properties.enableSoftDelete, purgeProtectionEnabled = properties.enablePurgeProtection

az graph query -q "Resources | where type =~ 'microsoft.keyvault/vaults' | where properties.enablePurgeProtection != true | project name, resourceGroup, subscriptionId, location, softDeleteEnabled = properties.enableSoftDelete, purgeProtectionEnabled = properties.enablePurgeProtection"

Sleutelkluizen met RBAC-autorisatie

Deze query bevat sleutelkluizen die Gebruikmaken van Azure RBAC voor autorisatie in plaats van toegangsbeleid. RBAC-autorisatie is de aanbevolen methode voor het beheren van toegang tot het gegevensvlak van de sleutelkluis.

Resources
| where type =~ 'microsoft.keyvault/vaults'
| extend rbacEnabled = properties.enableRbacAuthorization
| project name, resourceGroup, subscriptionId, location, rbacEnabled
| where rbacEnabled == true

az graph query -q "Resources | where type =~ 'microsoft.keyvault/vaults' | extend rbacEnabled = properties.enableRbacAuthorization | project name, resourceGroup, subscriptionId, location, rbacEnabled | where rbacEnabled == true"

Sleutelkluizen met ingeschakelde openbare netwerktoegang

Deze query identificeert sleutelkluizen die openbare netwerktoegang toestaan. Voor verbeterde beveiliging kunt u de toegang tot specifieke netwerken beperken of privé-eindpunten gebruiken.

Resources
| where type =~ 'microsoft.keyvault/vaults'
| extend networkDefaultAction = tostring(properties.networkAcls.defaultAction)
| where networkDefaultAction =~ 'Allow' or isnull(networkDefaultAction)
| project name, resourceGroup, subscriptionId, location, networkDefaultAction

az graph query -q "Resources | where type =~ 'microsoft.keyvault/vaults' | extend networkDefaultAction = tostring(properties.networkAcls.defaultAction) | where networkDefaultAction =~ 'Allow' or isnull(networkDefaultAction) | project name, resourceGroup, subscriptionId, location, networkDefaultAction"

Overzicht van beveiligingsconfiguratie voor sleutelkluizen

Deze query biedt een uitgebreid overzicht van de beveiligingspostuur voor alle sleutelkluizen, waaronder status voor voorlopig verwijderen, beveiliging tegen opschonen, RBAC-autorisatie en netwerkinstellingen.

Resources
| where type =~ 'microsoft.keyvault/vaults'
| extend 
    softDeleteEnabled = tobool(properties.enableSoftDelete),
    purgeProtectionEnabled = tobool(properties.enablePurgeProtection),
    rbacEnabled = tobool(properties.enableRbacAuthorization),
    networkDefaultAction = tostring(properties.networkAcls.defaultAction),
    sku = tostring(properties.sku.name)
| project name, resourceGroup, subscriptionId, location, sku, softDeleteEnabled, purgeProtectionEnabled, rbacEnabled, networkDefaultAction
| order by name asc

az graph query -q "Resources | where type =~ 'microsoft.keyvault/vaults' | extend softDeleteEnabled = tobool(properties.enableSoftDelete), purgeProtectionEnabled = tobool(properties.enablePurgeProtection), rbacEnabled = tobool(properties.enableRbacAuthorization), networkDefaultAction = tostring(properties.networkAcls.defaultAction), sku = tostring(properties.sku.name) | project name, resourceGroup, subscriptionId, location, sku, softDeleteEnabled, purgeProtectionEnabled, rbacEnabled, networkDefaultAction | order by name asc"

Sleutelkluizen per locatie

Deze query telt sleutelkluizen per Azure-regio, wat handig is voor het verkrijgen van inzicht in de regionale distributie van uw sleutelbeheerresources.

Resources
| where type =~ 'microsoft.keyvault/vaults'
| summarize count() by location
| order by count_ desc

az graph query -q "Resources | where type =~ 'microsoft.keyvault/vaults' | summarize count() by location | order by count_ desc"

Sleutelkluizen op SKU-type

Met deze query worden sleutelkluizen gegroepeerd op de SKU-laag (Standard of Premium). Premium-SKU's zijn vereist voor met HSM beveiligde sleutels.

Resources
| where type =~ 'microsoft.keyvault/vaults'
| extend skuName = tostring(properties.sku.name)
| summarize count() by skuName

az graph query -q "Resources | where type =~ 'microsoft.keyvault/vaults' | extend skuName = tostring(properties.sku.name) | summarize count() by skuName"

Sleutelkluizen met abonnementsnaam

De volgende query toont een complex gebruik van join met kind als leftouter. De query beperkt de gekoppelde tabel tot abonnementsresources, en met project worden alleen het oorspronkelijke veld subscriptionId en het veld name, hernoemd tot SubName, opgenomen. Door de wijziging van de veldnaam wordt voorkomen dat join dit toevoegt als name1 omdat het veld al bestaat in resources. De oorspronkelijke tabel wordt gefilterd met where en het volgende project bevat kolommen uit beide tabellen. Het queryresultaat bestaat uit alle sleutelkluizen, met het type kluis en de naam van de sleutelkluis, en de naam van het abonnement waarin de kluis zich bevindt.

Resources
| join kind=leftouter (ResourceContainers | where type=='microsoft.resources/subscriptions' | project SubName=name, subscriptionId) on subscriptionId
| where type == 'microsoft.keyvault/vaults'
| project type, name, SubName

az graph query -q "Resources | join kind=leftouter (ResourceContainers | where type=='microsoft.resources/subscriptions' | project SubName=name, subscriptionId) on subscriptionId | where type == 'microsoft.keyvault/vaults' | project type, name, SubName"

Volgende stappen

  • Laatst bijgewerkt om