Edit

Share via

Custom ___domain names for Event Grid namespace's MQTT and HTTP host names

The Event Grid namespace is automatically assigned an HTTP hostname at the time of creation. If MQTT is enabled on the namespace, the MQTT hostname is also assigned to the namespace. Your clients use these host names to communicate with the Event Grid namespace.

You can assign your custom ___domain names to your Event Grid namespace’s MQTT and HTTP host names, along with the default host names. Custom ___domain configurations not only help you to meet your security and compliance requirements, but also eliminates the need to modify your clients that are already linked to your ___domain.

High-level steps

To use custom domains for namespaces, follow these steps:

  1. Add DNS entries to point your custom ___domain to the Event Grid namespace endpoint.
  2. Enable managed identity on your Event Grid namespace.
  3. Create an Azure Key Vault account that hosts the server certificate for your custom ___domain.
  4. Add role assignment in Azure Key Vault for the namespace’s managed identity.
  5. Associate your Event Grid namespace with the custom ___domain, specifying your custom ___domain name, certificate name, and key vault instance reference.
  6. The Event Grid namespace generates a TXT record that you use to prove ownership of the custom ___domain.
  7. Prove your ___domain ownership by creating a TXT record based on the value that Event Grid generated in the previous step.
  8. Event Grid validates the TXT records of the custom ___domain before activating the custom ___domain for your clients’ usage.
  9. Your clients can connect to the Event Grid namespace through the custom ___domain.

Limitations

  • Custom ___domain configuration is unique per region across MQTT and HTTP host names.
  • Custom ___domain configuration can't be identical for the MQTT and HTTP host names under the same namespace.
  • Custom ___domain configuration can't clash with any MQTT or HTTP hostname for any namespace in the same region.

Next step

For step-by-step instructions, see Assign custom ___domain names to Event Grid namespace's MQTT and HTTP host names.