Configure a custom topic or a domain in Azure Event Grid

This article shows how to update or configure a custom topic or a domain in Azure Event Grid.

  1. Sign in to Azure portal.

  2. In the search bar at the top, type Event Grid Topics, and then select Event Grid Topics from the drop-down list. If you are configuring a domain, search for Event Grid Domains.

    Screenshot showing the Azure port search bar to search for Event Grid topics.

  3. On the Event Grid Topics or Event Grid Domains page, select your topic or domain.

    Screenshot showing the selection of the topic in the list of Event Grid topics.

Enable to disable local authentication

  1. On the Overview page, in the Essentials section, select the current value for Local Authentication.

  2. On the Local Authentication page, select Enabled or Disabled.

    Screenshot showing the Local Authentication page.

  3. Select OK to close the Local Authentication page.

Configure public or private access

  1. On the left menu, select Networking under Settings.

  2. Select Public networks to allow all networks, including the internet, to access the resource.

    You can restrict the traffic using IP firewall rules. Specify a single IPv4 address or a range of IP addresses in Classless inter-domain routing (CIDR) notation.

    Screenshot that shows the Public network access page with Public networks selected.

  3. Select Private endpoints only to allow only private endpoint connections to access this resource. Use the Private endpoint connections tab on this page to manage connections.

    For step-by-step instructions to create a private endpoint connection, see Add a private endpoint using Azure portal.

    Screenshot that shows the Public network access page with Private endpoints only option selected.

  4. Select Save on the toolbar.

Assign managed identity

When you use Azure portal, you can assign one system assigned identity and up to two user assigned identities to an existing topic or a domain. The following procedures show you how to enable an identity for a custom topic. The steps for enabling an identity for a domain are similar.

To assign a system-assigned identity to a topic

  1. On the left menu, select Identity under Settings.

  2. In the System assigned tab, turn on the switch to enable the identity.

  3. Select Save on the toolbar to save the setting.

    Screenshot showing the Identity page for a custom topic.

To assign a user-assigned identity to a topic

  1. Create a user-assigned identity by following instructions in the Manage user-assigned managed identities article.

  2. On the Identity page, switch to the User assigned tab in the right pane, and then select + Add on the toolbar.

    Screenshot showing the User Assigned Identity tab of the Identity page.

  3. In the Add user managed identity window, follow these steps:

    1. Select the Azure subscription that has the user-assigned identity.
    2. Select the user-assigned identity.
    3. Select Add.
  4. Refresh the list in the User assigned tab to see the added user-assigned identity.

You can use similar steps to enable an identity for an Event Grid domain.

Configure data residency

  1. On the left menu, select Configuration under Settings.

    1. For Data residency, select whether you don't want any data to be replicated to another region (Regional) or you want the metadata to be replicated to a predefined secondary region (Cross-Geo).

    The Cross-Geo option allows Azure-initiated failover to the paired region in case of a region failure. For more information, see Server-side geo disaster recovery in Azure Event Grid. Azure-initiated failover is exercised by Azure in rare situations to fail over Event Grid resources from an affected region to the corresponding geo-paired region. This process doesn't require an intervention from user. Azure reserves right to make a determination of when this path will be taken. The mechanism doesn't involve a user consent before the user's topic or domain is failed over. For more information, see How do I recover from a failover?.

    If you select the Regional option, you may define your own disaster recovery plan.

    Screenshot showing the Configuration page with data residency settings.

  2. After updating the setting, select Apply to apply changes.

Next steps

Learn more about what Event Grid can help you do:

See the following samples to learn about publishing events to and consuming events from Event Grid using different programming languages.