You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/event-hubs/authorize-access-azure-active-directory.md
+3-3Lines changed: 3 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -22,7 +22,7 @@ When a security principal (a user, or an application) attempts to access an Even
22
22
23
23
The authentication step requires that an application request contains an OAuth 2.0 access token at runtime. If an application is running within an Azure entity such as an Azure VM, a virtual machine scale set, or an Azure Function app, it can use a managed identity to access the resources. To learn how to authenticate requests made by a managed identity to Event Hubs service, see [Authenticate access to Azure Event Hubs resources with Microsoft Entra ID and managed identities for Azure Resources](authenticate-managed-identity.md).
24
24
25
-
The authorization step requires that one or more Azure roles be assigned to the security principal. Azure Event Hubs provides Azure roles that encompass sets of permissions for Event Hubs resources. The roles that are assigned to a security principal determine the permissions that the principal will have. For more information about Azure roles, see [Azure built-in roles for Azure Event Hubs](#azure-built-in-roles-for-azure-event-hubs).
25
+
The authorization step requires that one or more Azure roles be assigned to the security principal. Azure Event Hubs provides Azure roles that encompass sets of permissions for Event Hubs resources. The roles that are assigned to a security principal determine the permissions that the principal has. For more information about Azure roles, see [Azure built-in roles for Azure Event Hubs](#azure-built-in-roles-for-azure-event-hubs).
26
26
27
27
Native applications and web applications that make requests to Event Hubs can also authorize with Microsoft Entra ID. To learn how to request an access token and use it to authorize requests for Event Hubs resources, see [Authenticate access to Azure Event Hubs with Microsoft Entra ID from an application](authenticate-application.md).
28
28
@@ -37,8 +37,8 @@ Azure provides the following Azure built-in roles for authorizing access to Even
37
37
| Role | Description |
38
38
| ---- | ----------- |
39
39
|[Azure Event Hubs Data owner](../role-based-access-control/built-in-roles.md#azure-event-hubs-data-owner)| Use this role to give complete access to Event Hubs resources. |
40
-
|[Azure Event Hubs Data sender](../role-based-access-control/built-in-roles.md#azure-event-hubs-data-sender)| Use this role to give the send access to Event Hubs resources. |
41
-
|[Azure Event Hubs Data receiver](../role-based-access-control/built-in-roles.md#azure-event-hubs-data-receiver)| Use this role to give the consuming/receiving access to Event Hubs resources. |
40
+
|[Azure Event Hubs Data sender](../role-based-access-control/built-in-roles.md#azure-event-hubs-data-sender)| Use this role to allow the security principal to send events to Event Hubs resources. |
41
+
|[Azure Event Hubs Data receiver](../role-based-access-control/built-in-roles.md#azure-event-hubs-data-receiver)| Use this role to allow the security principal to receive events from Event Hubs resources. |
42
42
43
43
For Schema Registry built-in roles, see [Schema Registry roles](schema-registry-concepts.md#azure-role-based-access-control).
Copy file name to clipboardExpand all lines: articles/event-hubs/overview-emulator.md
+25-22Lines changed: 25 additions & 22 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,43 +1,46 @@
1
1
---
2
-
title: Overview of the Azure Event Hubs emulator
3
-
description: This article describes benefits, features, limitations, and other overview information for the Azure Event Hubs emulator.
2
+
title: Azure Event Hubs Emulator Overview
3
+
description: Learn about the Azure Event Hubs emulator, a local development tool for testing Event Hubs apps offline with cost efficiency and isolated environments.
4
+
#customer intent: As a developer, I want to understand the Azure Event Hubs emulator so that I can test Event Hubs applications locally.
4
5
ms.topic: article
5
6
ms.author: Saglodha
6
-
ms.date: 05/06/2024
7
+
ms.date: 07/25/2025
8
+
ms.custom:
9
+
- ai-gen-docs-bap
10
+
- ai-gen-description
11
+
- ai-seo-date:07/25/2025
7
12
---
8
13
9
14
10
-
# Overview of the Azure Event Hubs emulator
15
+
# Azure Event Hubs emulator overview
11
16
12
-
The Azure Event Hubs emulator offers a local development experience for the Event Hubs service. You can use the emulator to develop and test code against the service in isolation, free from cloud interference.
17
+
The **Azure Event Hubs emulator** is a local development tool designed to help developers test and prototype Event Hubs applications in an offline, cost-effective, and isolated environment. The emulator simulates the Event Hubs service locally, which enables faster development cycles, eliminates cloud-related costs, and provides a controlled testing environment. This article provides an overview of the emulator's benefits, features, limitations, and usage guidelines to help you get started.
13
18
14
19
## Benefits
15
20
16
-
The primary advantages of using the emulator are:
21
+
The primary advantages of using the emulator are:
17
22
18
-
-**Local development**: The emulator provides a local development experience, so you can work offline and avoid network latency.
19
-
-**Cost efficiency**: With the emulator, you can test your applications without incurring any cloud usage costs.
20
-
-**Isolated testing environment**: You can test your code in isolation, to help ensure that other activities in the cloud don't affect the tests.
21
-
-**Optimized inner development loop**: You can use the emulator to quickly prototype and test your applications before deploying them to the cloud.
23
+
-**Local development**: The emulator provides a local development experience, so you can work offline and avoid network latency.
24
+
-**Cost efficiency**: With the emulator, you can test your applications without incurring any cloud usage costs.
25
+
-**Isolated testing environment**: You can test your code in isolation, to help ensure that other activities in the cloud don't affect the tests.
26
+
-**Optimized inner development loop**: You can use the emulator to quickly prototype and test your applications before deploying them to the cloud.
22
27
23
-
> [!NOTE]
24
-
> The Event Hubs emulator is available under the [Microsoft Software License Terms](https://github.com/Azure/azure-event-hubs-emulator-installer/blob/main/EMULATOR_EULA.md).
25
28
26
29
## Features
27
30
28
-
The emulator provides these features:
31
+
The emulator provides these features:
29
32
30
-
-**Containerized deployment**: It runs as a Docker container (Linux based).
31
-
-**Cross-platform compatibility**: You can use it on any platform, including Windows, macOS, and Linux.
32
-
-**Configurability**: You can manage the number of event hubs, partitions, and other entities by using the JSON supplied configuration.
33
-
-**Streaming support**: It supports streaming events using Kafka and Advanced Message Queuing Protocol (AMQP).
33
+
-**Containerized deployment**: It runs as a Docker container (Linux based).
34
+
-**Cross-platform compatibility**: You can use it on any platform, including Windows, macOS, and Linux.
35
+
-**Configurability**: You can manage the number of event hubs, partitions, and other entities by using the JSON supplied configuration.
36
+
-**Streaming support**: It supports streaming events using Kafka and Advanced Message Queuing Protocol (AMQP).
34
37
-**Observability**: It provides observability features, including console and file logging.
35
38
36
39
## Known limitations
37
40
38
41
The current version of the emulator has the following limitations:
39
42
40
-
- When using Kafka, only producer and consumer APIs are compatible with Event Hubs emulator.
43
+
- When you use Kafka, only producer and consumer APIs are compatible with Event Hubs emulator.
41
44
- Under Kafka configuration, `securityProtocol` and `saslmechanism` can only have the following values:
@@ -49,14 +52,14 @@ The current version of the emulator has the following limitations:
49
52
> [!NOTE]
50
53
> After a container restart, data and entities don't persist in the emulator.
51
54
52
-
## Differences from the cloud service
55
+
## Differences between the emulator and cloud service
53
56
54
57
Because the Event Hubs emulator is meant only for development and test purposes, there are functional differences between the emulator and the cloud service.
55
58
56
59
The emulator doesn't support these high-level features:
57
60
58
61
- Azure features like virtual network integration, Microsoft Entra ID integration, activity logs, and a UI portal
59
-
- Event Hubs capture
62
+
- Event Hubs Capture
60
63
- Resource governance features like application groups
61
64
- Autoscale capabilities
62
65
- Geo-disaster recovery capabilities
@@ -70,7 +73,7 @@ The emulator doesn't support these high-level features:
70
73
71
74
## Usage quotas
72
75
73
-
Like the Event Hubs cloud service, the emulator provides the following quotas for usage:
76
+
Like Event Hubs on Azure, the emulator provides the following quotas for usage:
74
77
75
78
| Property| Value| User configurable within limits
76
79
| ----|----|----
@@ -81,7 +84,7 @@ Like the Event Hubs cloud service, the emulator provides the following quotas fo
81
84
| Maximum size of an event being published to an event hub (batch/nonbatch) |1 MB |No
82
85
| Minimum event retention time | 1 hr | No
83
86
84
-
These limits are enforced by the emulator. While some values are configurable using config.json, you cannot exceed the listed maximums. Any configuration changes must be made before starting the emulator.
87
+
Emulator enforces these limits. While some values are configurable using config.json, you can't exceed the listed maximums. Any configuration changes must be made before starting the emulator.
0 commit comments