Share via


Add support for an Azure Front Door (AFD)

Important

Azure Intelligent Recommendations Retirement and Migration Plan

Azure Intelligent Recommendations will be retired on March 31, 2026.

We're retiring the product due to changes in strategy and focus with the onset of the copilot era. Currently, there are no equivalent services available within the Microsoft stack, so we can't offer a migration plan to a similar service.

Next steps:

  • Identify or build an alternative.
  • Migrate all your traffic to the chosen alternative.
  • Stop calling the Recommendations endpoint before the shutdown date.
  • Delete all service endpoints, modeling, and IR accounts in the Azure portal before the shutdown date.

We'll continue to monitor and maintain Azure Intelligent Recommendations during the retirement period. After the product is retired, we'll keep the service data for three months before deleting it.

This article describes how to add an Azure Front Door to your Intelligent Recommendations (IR) service.

AFD setup

The CDN setup process consists of these general steps:

  1. Add a front-end host.
  2. Configure a backend pool.
  3. Set up rules for routing.

Add a front-end host

For information on how to set up Azure Front Door Service, see Quickstart: Create a Front Door for a highly available global web application.

Configure a back end pool in Azure Front Door Service

To configure a back end pool in Azure Front Door Service, follow these steps.

  1. Add <IR-Endpoint-URL> to a back end pool as a custom host that has a backend host header that is the same as <IR-Endpoint-URL>.
  2. Under Load balancing, leave the default values.
  3. Disable health checks for the back end pool.

The following illustration shows the Add a back end dialog box in Azure Front Door Service with the back end host name entered.

Add a back end pool dialog box.

The following illustration shows the Add a back end pool dialog box in Azure Front Door Service with the default load balancing values.

Be sure to disable Health Probes when setting up your own Azure Front Door service for IR account.

Add a back end pool dialog box continued.

Set up rules in Azure Front Door Service

To set up a routing rule in Azure Front Door Service, follow these steps.

  1. Add a routing rule.
  2. In the Name field, enter default.
  3. In the Accepted protocol field, select HTTP and HTTPS.
  4. In the Frontend hosts field, enter <IR-account-Name>.azurefd.net.
  5. Under Patterns to match, in the upper field, enter /*.
  6. Under Route Details, set the Route type option to Forward.
  7. In the Backend pool field, select ecom-backend.
  8. In the Forwarding protocol field group, select the Match request option.
  9. Set the URL rewrite option to Disabled.
  10. Set the Caching option to Disabled.

For detailed instructions on adding a custom domain to your Azure Front Door, see Add a custom domain to your Front Door.

Your CDN should now be correctly configured so that it can be used with your IR service.

See also

Deploy Intelligent Recommendations
Use data contracts to share data
Intelligent Recommendations API