Azure Key Vault 日志记录Azure Key Vault logging

• 07/28/2020
• • 
  • 

在创建一个或多个 Key Vault 之后，可能需要监视 Key Vault 的访问方式、时间和访问者。After you create one or more key vaults, you'll likely want to monitor how and when your key vaults are accessed, and by whom. 为此，可以启用 Azure Key Vault 日志记录，以便在提供的 Azure 存储帐户中保存信息。You can do this by enabling logging for Azure Key Vault, which saves information in an Azure storage account that you provide. 系统会自动为指定的存储帐户创建名为 insights-logs-auditevent 的新容器。A new container named insights-logs-auditevent is automatically created for your specified storage account. 可以使用此同一个存储帐户来收集多个 Key Vault 的日志。You can use this same storage account for collecting logs for multiple key vaults.

最多在执行 Key Vault 操作 10 分钟后，就能访问其日志记录信息。You can access your logging information 10 minutes (at most) after the key vault operation. 但大多数情况下不用等待这么长时间。In most cases, it will be quicker than this. 存储帐户中的日志完全由你管理：It's up to you to manage your logs in your storage account:

• 请使用标准的 Azure 访问控制方法限制可访问日志的人员，以此保护日志。Use standard Azure access control methods to secure your logs by restricting who can access them.
• 删除不想继续保留在存储帐户中的日志。Delete logs that you no longer want to keep in your storage account.

借助本教程开始使用 Azure 密钥保管库日志记录。Use this tutorial to help you get started with Azure Key Vault logging. 你将创建一个存储帐户，启用日志记录，并解释收集的日志信息。You'll create a storage account, enable logging, and interpret the collected log information.

有关 Key Vault的概述信息，请参阅什么是 Azure Key Vault？。For overview information about Key Vault, see What is Azure Key Vault?. 有关 Key Vault 可用位置的信息，请参阅定价页。For information about where Key Vault is available, see the pricing page.

先决条件Prerequisites

要完成本教程，必须满足下列要求：To complete this tutorial, you must have the following:

• 正在使用的现有密钥保管库。An existing key vault that you have been using.
• Azure PowerShell，最低版本为 1.0.0。Azure PowerShell, minimum version of 1.0.0. 要安装 Azure PowerShell 并将其与 Azure 订阅相关联，请参阅如何安装和配置 Azure PowerShell。To install Azure PowerShell and associate it with your Azure subscription, see How to install and configure Azure PowerShell. 如果已安装了 Azure PowerShell，但不知道版本，请在 Azure PowerShell 控制台中输入 $PSVersionTable.PSVersion。If you have already installed Azure PowerShell and don't know the version, from the Azure PowerShell console, enter $PSVersionTable.PSVersion.
• 足够的 Azure 存储用于保存密钥保管库日志。Sufficient storage on Azure for your Key Vault logs.

连接到 Key Vault 订阅Connect to your key vault subscription

设置密钥日志记录的第一步是将 Azure PowerShell 指向要记录的 Key Vault。The first step in setting up key logging is to point Azure PowerShell to the key vault that you want to log.

使用以下命令启动 Azure PowerShell 会话，并登录 Azure 帐户：Start an Azure PowerShell session and sign in to your Azure account by using the following command:

Connect-AzAccount -EnvironmentName AzureChinaCloud

在弹出的浏览器窗口中，输入 Azure 帐户用户名和密码。In the pop-up browser window, enter your Azure account user name and password. Azure PowerShell 将获取与此帐户关联的所有订阅。Azure PowerShell gets all the subscriptions that are associated with this account. PowerShell 默认使用第一个订阅。By default, PowerShell uses the first one.

可能需要指定用于创建 Key Vault 的订阅。You might have to specify the subscription that you used to create your key vault. 输入以下命令以查看帐户的订阅：Enter the following command to see the subscriptions for your account:

Get-AzSubscription

然后，若要指定与要记录的 Key Vault 关联的订阅，请输入：Then, to specify the subscription that's associated with the key vault you'll be logging, enter:

Set-AzContext -SubscriptionId <subscription ID>

将 PowerShell 指向正确的订阅是一个重要步骤，尤其是在有多个订阅与帐户关联的情况下。Pointing PowerShell to the right subscription is an important step, especially if you have multiple subscriptions associated with your account. 有关配置 Azure PowerShell 的详细信息，请参阅 如何安装和配置 Azure PowerShell。For more information about configuring Azure PowerShell, see How to install and configure Azure PowerShell.

为日志创建存储帐户Create a storage account for your logs

尽管可以使用现有的存储帐户来保存日志，但我们将专门创建一个存储帐户来保存 Key Vault 日志。Although you can use an existing storage account for your logs, we'll create a storage account that will be dedicated to Key Vault logs. 为方便起见，在稍后遇到必须指定此帐户的情况时，我们会将详细信息存储到名为 sa的变量中。For convenience for when we have to specify this later, we'll store the details in a variable named sa.

为了进一步简化管理，我们还使用了包含 Key Vault 的同一个资源组。For additional ease of management, we'll also use the same resource group as the one that contains the key vault. 在 入门教程中，此资源组的名称为 ContosoResourceGroup，我们将继续使用“东亚”位置。From the getting-started tutorial, this resource group is named ContosoResourceGroup, and we'll continue to use the East Asia location. 在适当的情况下，请将这些值替换为自己的值：Replace these values with your own, as applicable:

 $sa = New-AzStorageAccount -ResourceGroupName ContosoResourceGroup -Name contosokeyvaultlogs -Type Standard_LRS -Location 'East Asia'

标识用于保存日志的密钥保管库Identify the key vault for your logs

在入门教程中，Key Vault 名称为 ContosoKeyVault。In the getting-started tutorial, the key vault name was ContosoKeyVault. 我们将继续使用该名称，并将详细信息存储在名为 kv 的变量中：We'll continue to use that name and store the details in a variable named kv:

$kv = Get-AzKeyVault -VaultName 'ContosoKeyVault'

使用 Azure PowerShell 启用日志记录Enable logging using Azure PowerShell

为了启用 Key Vault 日志记录，我们将使用 Set-AzDiagnosticSetting cmdlet 并配合针对新存储帐户和 Key Vault 创建的变量。To enable logging for Key Vault, we'll use the Set-AzDiagnosticSetting cmdlet, together with the variables that we created for the new storage account and the key vault. 还将 -Enabled 标志设置为 $true，并将类别设置为 AuditEvent（Key Vault 日志记录的唯一类别）：We'll also set the -Enabled flag to $true and set the category to AuditEvent (the only category for Key Vault logging):

Set-AzDiagnosticSetting -ResourceId $kv.ResourceId -StorageAccountId $sa.Id -Enabled $true -Category AuditEvent

输出如下所示：The output looks like this:

StorageAccountId   : /subscriptions/<subscription-GUID>/resourceGroups/ContosoResourceGroup/providers/Microsoft.Storage/storageAccounts/ContosoKeyVaultLogs
ServiceBusRuleId   :
StorageAccountName :
    Logs
    Enabled           : True
    Category          : AuditEvent
    RetentionPolicy
    Enabled : False
    Days    : 0

此输出确认 Key Vault 日志记录现已启用，会将信息保存到存储帐户。This output confirms that logging is now enabled for your key vault, and it will save information to your storage account.

还可以选择性地为日志设置保留期策略，以便自动删除较旧的日志。Optionally, you can set a retention policy for your logs such that older logs are automatically deleted. 例如，通过将 -RetentionEnabled 标志设置为 $true 来设置保留期策略，并将 -RetentionInDays 参数设置为 90，以便自动删除 90 天以上的日志。For example, set retention policy by setting the -RetentionEnabled flag to $true, and set the -RetentionInDays parameter to 90 so that logs older than 90 days are automatically deleted.

Set-AzDiagnosticSetting -ResourceId $kv.ResourceId -StorageAccountId $sa.Id -Enabled $true -Category AuditEvent -RetentionEnabled $true -RetentionInDays 90

记录的内容：What's logged:

• 所有已经过身份验证的 REST API 请求，包括由于访问权限、系统错误或错误请求而发生的失败请求。All authenticated REST API requests, including failed requests as a result of access permissions, system errors, or bad requests.
• 对 Key Vault 本身执行的操作，包括创建、删除、设置 Key Vault 访问策略，以及更新 Key Vault 属性（例如标记）。Operations on the key vault itself, including creation, deletion, setting key vault access policies, and updating key vault attributes such as tags.
• 对 Key Vault 中的密钥和机密执行的操作，包括：Operations on keys and secrets in the key vault, including:
  • 创建、修改或删除这些密钥或机密。Creating, modifying, or deleting these keys or secrets.
  • 签名、验证、加密、解密、包装和解包密钥、获取机密、列出密钥和机密（及其版本）。Signing, verifying, encrypting, decrypting, wrapping and unwrapping keys, getting secrets, and listing keys and secrets (and their versions).
• 导致出现 401 响应的未经身份验证的请求。Unauthenticated requests that result in a 401 response. 例如，请求不包含持有者令牌、格式不正确或已过期，或者包含无效的令牌。Examples are requests that don't have a bearer token, that are malformed or expired, or that have an invalid token.

使用 Azure CLI 启用日志记录Enable logging using Azure CLI

az cloud set -n AzureChinaCloud
az login

az account set --subscription {AZURE SUBSCRIPTION ID}

az provider register -n Microsoft.KeyVault

az monitor diagnostic-settings create  \
--name KeyVault-Diagnostics \
--resource /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Microsoft.KeyVault/vaults/mykeyvault \
--logs    '[{"category": "AuditEvent","enabled": true}]' \
--metrics '[{"category": "AllMetrics","enabled": true}]' \
--storage-account /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Microsoft.Storage/storageAccounts/mystorageaccount \
--workspace /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourcegroups/oi-default-east-us/providers/microsoft.operationalinsights/workspaces/myworkspace \
--event-hub-rule /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Microsoft.EventHub/namespaces/myeventhub/authorizationrules/RootManageSharedAccessKey

访问日志Access your logs

Key Vault 日志存储在提供的存储帐户的 insights-logs-auditevent 容器中。Key Vault logs are stored in the insights-logs-auditevent container in the storage account that you provided. 若要查看这些日志，必须下载 Blob。To view the logs, you have to download blobs.

首先，请为容器名称创建一个变量。First, create a variable for the container name. 本演练的剩余部分将使用此变量。You'll use this variable throughout the rest of the walkthrough.

$container = 'insights-logs-auditevent'

若要列出此容器中的所有 Blob，请输入：To list all the blobs in this container, enter:

Get-AzStorageBlob -Container $container -Context $sa.Context

输出与下面类似：The output looks similar to this:

Container Uri: https://contosokeyvaultlogs.blob.core.chinacloudapi.cn/insights-logs-auditevent

Name

---
resourceId=/SUBSCRIPTIONS/361DA5D4-A47A-4C79-AFDD-XXXXXXXXXXXX/RESOURCEGROUPS/CONTOSORESOURCEGROUP/PROVIDERS/MICROSOFT.KEYVAULT/VAULTS/CONTOSOKEYVAULT/y=2016/m=01/d=05/h=01/m=00/PT1H.json

resourceId=/SUBSCRIPTIONS/361DA5D4-A47A-4C79-AFDD-XXXXXXXXXXXX/RESOURCEGROUPS/CONTOSORESOURCEGROUP/PROVIDERS/MICROSOFT.KEYVAULT/VAULTS/CONTOSOKEYVAULT/y=2016/m=01/d=04/h=02/m=00/PT1H.json

resourceId=/SUBSCRIPTIONS/361DA5D4-A47A-4C79-AFDD-XXXXXXXXXXXX/RESOURCEGROUPS/CONTOSORESOURCEGROUP/PROVIDERS/MICROSOFT.KEYVAULT/VAULTS/CONTOSOKEYVAULT/y=2016/m=01/d=04/h=18/m=00/PT1H.json

可从此输出中看出，blob 遵循以下命名约定：resourceId=<ARM resource ID>/y=<year>/m=<month>/d=<day of month>/h=<hour>/m=<minute>/filename.jsonAs you can see from this output, the blobs follow a naming convention: resourceId=<ARM resource ID>/y=<year>/m=<month>/d=<day of month>/h=<hour>/m=<minute>/filename.json

日期和时间值使用 UTC。The date and time values use UTC.

由于可以使用相同的存储帐户来收集多个资源的日志，Blob 名称中的完整资源 ID 适合用于仅访问或下载所需 Blob。Because you can use the same storage account to collect logs for multiple resources, the full resource ID in the blob name is useful to access or download just the blobs that you need. 但在这样做之前，让我们先了解如何下载所有 Blob。But before we do that, we'll first cover how to download all the blobs.

创建一个文件夹用于下载 Blob。Create a folder to download the blobs. 例如：For example:

New-Item -Path 'C:\Users\username\ContosoKeyVaultLogs' -ItemType Directory -Force

然后获取所有 blob 的列表：Then get a list of all blobs:

$blobs = Get-AzStorageBlob -Container $container -Context $sa.Context

通过 Get-AzStorageBlobContent 以管道传送此列表，将 Blob 下载到目标文件夹：Pipe this list through Get-AzStorageBlobContent to download the blobs to the destination folder:

$blobs | Get-AzStorageBlobContent -Destination C:\Users\username\ContosoKeyVaultLogs'

运行第二个命令时，blob 名称中的 / 分隔符会在目标文件夹下创建完整的文件夹结构。When you run this second command, the / delimiter in the blob names creates a full folder structure under the destination folder. 你将使用此结构下载 Blob 并将其存储为文件。You'll use this structure to download and store the blobs as files.

若要选择性地下载 Blob，请使用通配符。To selectively download blobs, use wildcards. 例如：For example:

• 如果有多个密钥保管库，并只想要下载其中名为 CONTOSOKEYVAULT3 的密钥保管库的日志：If you have multiple key vaults and want to download logs for just one key vault, named CONTOSOKEYVAULT3:

  Get-AzStorageBlob -Container $container -Context $sa.Context -Blob '*/VAULTS/CONTOSOKEYVAULT3
  

• 如果有多个资源组，并只想要下载其中某个资源组的日志，请使用 -Blob '*/RESOURCEGROUPS/<resource group name>/*'：If you have multiple resource groups and want to download logs for just one resource group, use -Blob '*/RESOURCEGROUPS/<resource group name>/*':

  Get-AzStorageBlob -Container $container -Context $sa.Context -Blob '*/RESOURCEGROUPS/CONTOSORESOURCEGROUP3/*'
  

• 如果要下载 2019 年 1 月份的所有日志，请使用 -Blob '*/year=2019/m=01/*'：If you want to download all the logs for the month of January 2019, use -Blob '*/year=2019/m=01/*':

  Get-AzStorageBlob -Container $container -Context $sa.Context -Blob '*/year=2016/m=01/*'
  

现在已准备就绪，可以开始查看日志中的内容。You're now ready to start looking at what's in the logs. 但在开始之前，应该了解另外两个命令：But before we move on to that, you should know two more commands:

• 若要查询密钥保管库资源的诊断设置状态：Get-AzDiagnosticSetting -ResourceId $kv.ResourceIdTo query the status of diagnostic settings for your key vault resource: Get-AzDiagnosticSetting -ResourceId $kv.ResourceId
• 若要禁用密钥保管库资源的日志记录： Set-AzDiagnosticSetting -ResourceId $kv.ResourceId -StorageAccountId $sa.Id -Enabled $false -Category AuditEventTo disable logging for your key vault resource: Set-AzDiagnosticSetting -ResourceId $kv.ResourceId -StorageAccountId $sa.Id -Enabled $false -Category AuditEvent

解释 Key Vault 日志Interpret your Key Vault logs

每个 Blob 存储为文本，并格式化为 JSON Blob。Individual blobs are stored as text, formatted as a JSON blob. 让我们看一个示例日志项。Let's look at an example log entry.

    {
        "records":
        [
            {
                "time": "2016-01-05T01:32:01.2691226Z",
                "resourceId": "/SUBSCRIPTIONS/361DA5D4-A47A-4C79-AFDD-XXXXXXXXXXXX/RESOURCEGROUPS/CONTOSOGROUP/PROVIDERS/MICROSOFT.KEYVAULT/VAULTS/CONTOSOKEYVAULT",
                "operationName": "VaultGet",
                "operationVersion": "2015-06-01",
                "category": "AuditEvent",
                "resultType": "Success",
                "resultSignature": "OK",
                "resultDescription": "",
                "durationMs": "78",
                "callerIpAddress": "104.40.82.76",
                "correlationId": "",
                "identity": {"claim":{"http://schemas.microsoft.com/identity/claims/objectidentifier":"d9da5048-2737-4770-bd64-XXXXXXXXXXXX","http://schemas.xmlsoap.org/ws/2005/05/identity/claims/upn":"live.com#username@outlook.com","appid":"1950a258-227b-4e31-a9cf-XXXXXXXXXXXX"}},
                "properties": {"clientInfo":"azure-resource-manager/2.0","requestUri":"https://control-prod-wus.vaultcore.azure.cn/subscriptions/361da5d4-a47a-4c79-afdd-XXXXXXXXXXXX/resourcegroups/contosoresourcegroup/providers/Microsoft.KeyVault/vaults/contosokeyvault?api-version=2015-06-01","id":"https://contosokeyvault.vault.azure.cn/","httpStatusCode":200}
            }
        ]
    }

下表列出了字段的名称和描述：The following table lists the field names and descriptions:

operationName 字段值采用 ObjectVerb 格式。The operationName field values are in ObjectVerb format. 例如：For example:

• 所有 Key Vault 操作采用 Vault<action> 格式，例如 VaultGet 和 VaultCreate。All key vault operations have the Vault<action> format, such as VaultGet and VaultCreate.
• 所有密钥操作采用 Key<action> 格式，例如 KeySign 和 KeyList。All key operations have the Key<action> format, such as KeySign and KeyList.
• 所有机密操作采用 Secret<action> 格式，例如 SecretGet 和 SecretListVersions。All secret operations have the Secret<action> format, such as SecretGet and SecretListVersions.

下表列出了 operationName 值和对应的 REST API 命令：The following table lists the operationName values and corresponding REST API commands:

使用 Azure Monitor 日志Use Azure Monitor logs

可以使用 Azure Monitor 日志中的 Key Vault 解决方案查看 Key Vault AuditEvent 日志。You can use the Key Vault solution in Azure Monitor logs to review Key Vault AuditEvent logs. 在 Azure Monitor 日志中，可以使用日志查询来分析数据并获取所需的信息。In Azure Monitor logs, you use log queries to analyze data and get the information you need.

有关详细信息，包括如何进行设置，请参阅 Azure Monitor 日志中的Azure Key Vault 解决方案。For more information, including how to set this up, see Azure Key Vault solution in Azure Monitor logs. 如果需要从 Azure Monitor 日志预览版提供的旧 Key Vault 解决方案进行迁移，且之前在该方案中，首先将日志路由到了 Azure 存储帐户，并将 Azure Monitor 日志配置为了从此处读取，则本文也可提供指导。This article also contains instructions if you need to migrate from the old Key Vault solution that was offered during the Azure Monitor logs preview, where you first routed your logs to an Azure storage account and configured Azure Monitor logs to read from there.

后续步骤Next steps

有关在 .NET Web 应用程序中使用 Azure Key Vault 的教程，请参阅从 Web 应用程序使用 Azure Key Vault。For a tutorial that uses Azure Key Vault in a .NET web application, see Use Azure Key Vault from a web application.

有关编程参考，请参阅 Azure 密钥保管库开发人员指南。For programming references, see the Azure Key Vault developer's guide.

有关 Azure Key Vault 的 Azure PowerShell 1.0 cmdlet 列表，请参阅 Azure Key Vault cmdlet。For a list of Azure PowerShell 1.0 cmdlets for Azure Key Vault, see Azure Key Vault cmdlets.