Load configuration from Azure Front Door in client applications (preview)

Integrating Azure App Configuration with Azure Front Door enables your client applications to retrieve configuration from edge locations worldwide, ensuring optimal performance at any scale. The integration process involves the following steps:

1. Create configuration data in Azure App Configuration - Define your application's key-values, feature flags, or snapshots in Azure App Configuration.

2. Connect Azure App Configuration to Azure Front Door - Configure the connection between your App Configuration store and Azure Front Door through the Azure portal. The portal provides a guided experience to set up the Azure Front Door endpoint. Set up Azure Front Door to connect to App Config

3. Connect application to Azure Front Door - Configure your client application to retrieve configuration from the Azure Front Door endpoint using the App Configuration provider. The provider handles anonymous authentication and dynamic configuration updates. This document explains how to set up this connection.

4. Deploy and manage configuration - Deploy your application to production. Your clients now retrieve configuration from the nearest Azure Front Door edge location automatically. Update configuration values in Azure App Configuration as needed - changes propagate globally based on your configured Azure Front Door cache expiration time without requiring application updates or redeployments.

Client application samples

The following code demonstrates how to load configuration from Azure Front Door. The application retrieves all keys starting with an "App1:" prefix and checks for updates every minute. When the application requests updates, Azure Front Door returns cached values, if possible, otherwise it retrieves fresh configuration from App Configuration service.

Replace {YOUR-AFD-ENDPOINT} with your Azure Front Door endpoint, which looks something like https://xxxx.azurefd.net.

builder.Configuration.AddAzureAppConfiguration(options =>
{
    options.ConnectAzureFrontDoor(new Uri("{YOUR-AFD-ENDPOINT}"))
            .Select("App1:*")
            .ConfigureRefresh(refreshOptions =>
            {
                refreshOptions.RegisterAll()
                    .SetRefreshInterval(TimeSpan.FromMinutes(1));
            });
});

import { loadFromAzureFrontDoor } from "@azure/app-configuration-provider";

const appConfig = await loadFromAzureFrontDoor("{YOUR-AFD-ENDPOINT}", {
    selectors: [{
        keyFilter: "App1:*"
    }],
    refreshOptions: {
        enabled: true,
        refreshIntervalInMs: 60_000
    }
});

const yoursetting = appConfig.get("App1:Version");

Troubleshooting

Configuration doesn't load

• Verify Azure Front Door endpoint URL is correctly configured in application code.
• Check for warnings in the App Config Portal and fix the issues if any.

Configuration doesn't refresh

• Verify that both the application refresh interval and Azure Front Door cache TTL are properly configured. For details on configuration refresh timing, see Caching behavior in hyperscale configuration.

Language availability

Related content

• Hyperscale configuration for client applications
• Setup Azure Front Door to connect to App Config
• Learn more about Azure Front Door
• Monitor Azure Front Door performance