Azure Key Vault как источник Event Grid

В этой статье описаны свойства и схема для событий в Azure Key Vault. Для введения в схемы событий см. схему событий для Azure Event Grid и схему событий для облачных сценариев.

Доступные типы событий

Учетная запись Azure Key Vault создает следующие типы событий:

Полное имя события Отображаемое имя события Описание
Microsoft.KeyVault.CertificateNewVersionCreated (Создана новая версия сертификата) Создана новая версия сертификата Активируется при создании нового сертификата или новой версии сертификата.
Microsoft.KeyVault.CertificateNearExpiry Срок действия сертификата скоро истечет Активируется, когда срок действия текущей версии сертификата близится к истечению. (Событие активируется за 30 дней до даты окончания срока действия.)
Microsoft.KeyVault.СрокСертификатаИстек Срок действия сертификата истек Активируется, когда срок действия текущей версии сертификата истекает.
Microsoft.KeyVault.KeyNewVersionCreated Создана новая версия ключа Активируется при создании нового ключа или новой версии ключа.
Microsoft.KeyVault.KeyNearExpiry Срок действия ключа скоро истечет Активируется, когда срок действия текущей версии ключа близится к истечению. Время события можно настроить с помощью политики смены ключей
Microsoft.KeyVault.KeyExpired Срок действия ключа истек Активируется, когда срок действия текущей версии ключа истекает.
Microsoft.KeyVault.СекретНоваяВерсияСоздана Создана новая секретная версия Активируется при создании нового секрета или новой версии секрета.
Microsoft.KeyVault.SecretNearExpiry Срок действия секрета скоро истечет Активируется, когда срок действия текущей версии секрета близится к истечению. (Событие активируется за 30 дней до даты окончания срока действия.)
Microsoft.KeyVault.SecretExpired Срок действия секрета истек Активируется, когда срок действия текущей версии секрета истекает.
Microsoft.KeyVault.VaultAccessPolicyChanged Политика доступа к Key Vault изменена Активируется при изменении политики доступа к Key Vault. Включает случай, когда модель разрешений Key Vault изменяется на управление доступом с использованием контроля на основе ролей Azure и обратно.

Примеры событий

В следующем примере показана схема Microsoft.KeyVault.SecretNewVersionCreated:

[
   {
      "id":"00eccf70-95a7-4e7c-8299-2eb17ee9ad64",
      "source":"/subscriptions/{subscription-id}/resourceGroups/sample-rg/providers/Microsoft.KeyVault/vaults/sample-kv",
      "subject":"newsecret",
      "type":"Microsoft.KeyVault.SecretNewVersionCreated",
      "time":"2019-07-25T01:08:33.1036736Z",
      "data":{
         "Id":"https://sample-kv.vault.azure.net/secrets/newsecret/ee059b2bb5bc48398a53b168c6cdcb10",
         "VaultName":"sample-kv",
         "ObjectType":"Secret",
         "ObjectName":"newsecret",
         "Version":"ee059b2bb5bc48398a53b168c6cdcb10",
         "NBF":"1559081980",
         "EXP":"1559082102"
      },
      "specversion":"1.0"
   }
]

Свойства событий

Событие содержит следующие высокоуровневые данные:

Свойство Тип Описание
source строка Полный путь к ресурсу источника событий. Это поле не является записываемым. Это значение предоставляет Сетка событий.
subject строка Установленный издателем путь к теме события.
type строка Один из зарегистрированных типов событий для этого источника событий.
time строка Время создания события определяется временем поставщика в формате UTC.
id строка Уникальный идентификатор события.
data объект Данные события Конфигурации приложений.
specversion строка Версия спецификации схемы CloudEvents.

Объект данных имеет следующие свойства:

Свойство Тип Описание
id строка Идентификатор объекта, активировавшего событие
VaultName строка Имя хранилища ключей объекта, активировавшего событие
ObjectType строка Тип объекта, активировавшего событие
ObjectName строка Имя объекта, активировавшего событие
Version строка Версия объекта, активировавшего событие
NBF номер Дата "не ранее" в секундах с 1970-01-01T00:00:00Z для объекта, который вызвал это событие
EXP номер Дата окончания срока действия в секундах с 1970-01-01T00:00:00Z для объекта, активировавшего событие

Практические руководства и другие учебные материалы

Заголовок Описание
Мониторинг событий Key Vault с помощью Сетки событий Azure Общие сведения об интеграции Key Vault со службой "Сетка событий".
Учебник. Создание и мониторинг событий Key Vault с помощью службы "Сетка событий" Здесь описано, как настроить уведомления службы "Сетка событий" для Key Vault.