Skip to content

Commit 0613d1a

Browse files
committed
Freshness review of 2 more articles
1 parent e077dc3 commit 0613d1a

2 files changed

Lines changed: 29 additions & 21 deletions

File tree

articles/event-grid/event-schema-key-vault.md

Lines changed: 11 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,12 @@
11
---
2-
title: Azure Key Vault as Event Grid source
3-
description: This article describes the properties and schema provided for Azure Key Vault events with Azure Event Grid
2+
title: Azure Key Vault as Event Grid Source Overview
3+
description: "Azure Key Vault events: Discover how to use Azure Key Vault as an Event Grid source, including event types, schema details, and integration tips."
4+
#customer intent: As an architect, I want to understand which Azure Key Vault events are available in Event Grid so that I can design event-driven solutions.
45
ms.topic: concept-article
5-
ms.date: 02/14/2025
6+
ms.date: 03/26/2026
7+
author: spelluru
8+
ms.author: spelluru
9+
ms.reviewer: spelluru
610
# Customer intent: As an architect or a developer, I want to know whether I can use Azure Key Vault as an Event Grid source.
711
---
812

@@ -33,7 +37,7 @@ An Azure Key Vault account generates the following event types:
3337

3438
# [Cloud event schema](#tab/cloud-event-schema)
3539

36-
The following example show schema for **Microsoft.KeyVault.SecretNewVersionCreated**:
40+
The following example shows the schema for **Microsoft.KeyVault.SecretNewVersionCreated**:
3741

3842
```JSON
3943
[
@@ -59,7 +63,7 @@ The following example show schema for **Microsoft.KeyVault.SecretNewVersionCreat
5963

6064
# [Event Grid event schema](#tab/event-grid-event-schema)
6165

62-
The following example show schema for **Microsoft.KeyVault.SecretNewVersionCreated**:
66+
The following example shows the schema for **Microsoft.KeyVault.SecretNewVersionCreated**:
6367

6468
```JSON
6569
[
@@ -95,7 +99,7 @@ An event has the following top-level data:
9599

96100
| Property | Type | Description |
97101
| -------- | ---- | ----------- |
98-
| `source` | string | Full resource path to the event source. This field isn't writeable. Event Grid provides this value. |
102+
| `source` | string | Full resource path to the event source. This field isn't writable. Event Grid provides this value. |
99103
| `subject` | string | Publisher-defined path to the event subject. |
100104
| `type` | string | One of the registered event types for this event source. |
101105
| `time` | string | The time the event is generated based on the provider's UTC time. |
@@ -108,7 +112,7 @@ An event has the following top-level data:
108112

109113
| Property | Type | Description |
110114
| -------- | ---- | ----------- |
111-
| `topic` | string | Full resource path to the event source. This field isn't writeable. Event Grid provides this value. |
115+
| `topic` | string | Full resource path to the event source. This field isn't writable. Event Grid provides this value. |
112116
| `subject` | string | Publisher-defined path to the event subject. |
113117
| `eventType` | string | One of the registered event types for this event source. |
114118
| `eventTime` | string | The time the event is generated based on the provider's UTC time. |

articles/event-grid/security-authorization.md

Lines changed: 18 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,22 +1,26 @@
11
---
2-
title: Azure Event Grid security and authentication
3-
description: This article describes how you can authorize access to Azure Event Grid resources using role-based access control roles.
2+
title: Event Grid Access Control with Azure RBAC
3+
description: Azure Event Grid security controls access to resources using Azure RBAC built-in and custom roles. Learn how to configure role-based permissions for Event Grid operations.
4+
#customer intent: As an IT admin, I want to understand how to control access to Azure Event Grid resources using role-based access control so that I can ensure only authorized users can perform management operations.
45
ms.topic: concept-article
5-
ms.date: 12/16/2024
6+
ms.date: 03/26/2026
7+
author: spelluru
8+
ms.author: spelluru
9+
ms.reviewer: spelluru
610
# Customer intent: I want to know how to secure access to Azure Event Grid resources.
711
---
812

913
# Authorizing access to Event Grid resources
10-
Azure Event Grid allows you to control the level of access given to different users to do various **management operations** such as list event subscriptions, create new ones, and generate keys. Event Grid uses Azure role-based access control (Azure RBAC).
14+
Azure Event Grid enables you to control the level of access different users have for various **management operations** such as listing event subscriptions, creating new ones, and generating keys. Event Grid uses Azure role-based access control (Azure RBAC).
1115

1216
## Operation types
13-
For a list of operation supported by Azure Event Grid, run the following Azure CLI command:
17+
To see a list of operations supported by Azure Event Grid, run the following Azure CLI command:
1418

1519
```azurecli-interactive
1620
az provider operation show --namespace Microsoft.EventGrid
1721
```
1822

19-
The following operations return potentially secret information, which gets filtered out of normal read operations. We recommend that you restrict access to these operations.
23+
The following operations return potentially secret information, which gets filtered out of normal read operations. Restrict access to these operations.
2024

2125
* Microsoft.EventGrid/eventSubscriptions/getFullUrl/action
2226
* Microsoft.EventGrid/topics/listKeys/action
@@ -48,9 +52,9 @@ The **Event Grid Contributor** role allows you to create and manage Event Grid r
4852

4953
If you need to specify permissions that are different than the built-in roles, create custom roles.
5054

51-
The following are sample Event Grid role definitions that allow users to take different actions. These custom roles are different from the built-in roles because they grant broader access than just event subscriptions.
55+
The following sample Event Grid role definitions grant users different permissions. These custom roles differ from the built-in roles because they grant broader access than just event subscriptions.
5256

53-
**EventGridReadOnlyRole.json**: Only allow read-only operations.
57+
- **EventGridReadOnlyRole.json**: Grants only read-only operations.
5458

5559
```json
5660
{
@@ -69,7 +73,7 @@ The following are sample Event Grid role definitions that allow users to take di
6973
}
7074
```
7175

72-
**EventGridNoDeleteListKeysRole.json**: Allow restricted post actions but disallow delete actions.
76+
- **EventGridNoDeleteListKeysRole.json**: Grants restricted post actions but disallows delete actions.
7377

7478
```json
7579
{
@@ -92,7 +96,7 @@ The following are sample Event Grid role definitions that allow users to take di
9296
}
9397
```
9498

95-
**EventGridContributorRole.json**: Allows all Event Grid actions.
99+
- **EventGridContributorRole.json**: Grants all Event Grid actions.
96100

97101
```json
98102
{
@@ -120,15 +124,15 @@ You can create custom roles with [PowerShell](../role-based-access-control/custo
120124

121125
### Encryption at rest
122126

123-
All events or data written to disk by the Event Grid service is encrypted by a Microsoft-managed key ensuring that it's encrypted at rest. Additionally, the maximum period of time that events or data retained is 24 hours in adherence with the [Event Grid retry policy](delivery-and-retry.md). Event Grid will automatically delete all events or data after 24 hours, or the event time-to-live, whichever is less.
127+
The Event Grid service encrypts all events or data written to disk by using a Microsoft-managed key, ensuring that it's encrypted at rest. Additionally, the maximum period of time that events or data are retained is 24 hours in adherence with the [Event Grid retry policy](delivery-and-retry.md). Event Grid automatically deletes all events or data after 24 hours, or the event time-to-live, whichever is less.
124128

125129
## Permissions for event subscriptions
126-
If you're using an event handler that isn't a WebHook (such as an event hub or queue storage), you need write access to that resource. This permissions check prevents an unauthorized user from sending events to your resource.
130+
If you use an event handler that isn't a WebHook (such as an event hub or queue storage), you need write access to that resource. This permissions check prevents an unauthorized user from sending events to your resource.
127131

128132
You must have the **Microsoft.EventGrid/EventSubscriptions/Write** permission on the resource that is the event source. You need this permission because you're writing a new subscription at the scope of the resource. The required resource differs based on whether you're subscribing to a system topic or custom topic. Both types are described in this section.
129133

130134
### System topics (Azure service publishers)
131-
For system topics, if you aren't the owner or contributor of the source resource, you need permission to write a new event subscription at the scope of the resource publishing the event. The format of the resource is:
135+
For system topics, if you're not the owner or contributor of the source resource, you need permission to write a new event subscription at the scope of the resource that publishes the event. The format of the resource is:
132136
`/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/{resource-provider}/{resource-type}/{resource-name}`
133137

134138
For example, to subscribe to an event on a storage account named **myacct**, you need the Microsoft.EventGrid/EventSubscriptions/Write permission on:
@@ -145,4 +149,4 @@ For example, to subscribe to a custom topic named **mytopic**, you need the Micr
145149

146150
## Related content
147151

148-
* For an introduction to Event Grid, see [About Event Grid](overview.md)
152+
* For an introduction to Event Grid, see [About Event Grid](overview.md).

0 commit comments

Comments
 (0)