Document Details
Custom Event To Hybrid Connection
❌
This page contains Windows bias
About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Bias Types:
⚠️
windows_tools
⚠️
missing_linux_example
⚠️
windows_first
Summary:
The documentation demonstrates a Windows bias primarily in the 'Create application to process events' section, where only a C#/.NET sample and Visual Studio (a Windows-centric IDE) are referenced for building the consumer application. There are no Linux or cross-platform development instructions, nor are alternative languages or tools highlighted. The prerequisite steps and CLI usage are otherwise cross-platform, but the application development steps assume a Windows environment.
Recommendations:
- Include instructions and/or sample applications for Linux and macOS users, such as using VS Code, JetBrains Rider, or command-line .NET tools (dotnet CLI) to build and run the sample.
- Provide equivalent consumer samples in other languages (e.g., Python, Node.js) that are easily runnable on Linux.
- Explicitly mention that the Azure CLI and cURL commands work on Linux, macOS, and Windows, and provide any OS-specific notes if needed.
- Add links to cross-platform development guides or samples for Azure Relay Hybrid Connections.
- Rephrase the application development steps to be IDE-agnostic or provide alternatives to Visual Studio, such as using 'dotnet build' and 'dotnet run' from the command line.
Create pull request
Scan History
| Date | Scan ID | Status | Bias Status |
|---|---|---|---|
| 2025-07-12 23:44 | #41 | in_progress | ❌ Biased |
| 2025-07-12 00:58 | #8 | cancelled | ✅ Clean |
| 2025-07-10 05:06 | #7 | processing | ✅ Clean |
Flagged Code Snippets
Notice that an [expiration date](concepts.md#event-subscription-expiration) is set for the subscription.
## Create application to process events
You need an application that can retrieve events from the hybrid connection. The [Microsoft Azure Event Grid Hybrid Connection Consumer sample for C#](https://github.com/Azure-Samples/event-grid-dotnet-hybridconnection-destination) performs that operation. You've already finished the prerequisite steps.
1. Make sure you have Visual Studio 2019 or later.
1. Clone the repository to your local machine.
1. Load HybridConnectionConsumer project in Visual Studio.
1. In Program.cs, replace `<relayConnectionString>` and `<hybridConnectionName>` with the relay connection string and hybrid connection name that you created.
1. Compile and run the application from Visual Studio.
> [!IMPORTANT]
> We use connection string to authenticate to Azure Relay namespace to keep the tutorial simple. We recommend that you use Microsoft Entra ID authentication in production environments. When using an application, you can enable managed identity for the application and assign the identity an appropriate role (Azure Relay Owner, Azure Relay Listener, or Azure Relay Sender) on the Relay namespace. For more information, see [Authenticate a managed identity with Microsoft Entra ID to access Azure Relay resources](../azure-relay/authenticate-managed-identity.md).
## Send an event to your topic
Let's trigger an event to see how Event Grid distributes the message to your endpoint. This article shows how to use Azure CLI to trigger the event. Alternatively, you can use [Event Grid publisher application](https://github.com/Azure-Samples/event-grid-dotnet-publish-consume-events/tree/master/EventGridPublisher).
First, let's get the URL and key for the custom topic. Again, use your custom topic name for `<topic_name>`.