azure-app-configuration

name	azure-app-configuration
description	Expert knowledge for Azure App Configuration development including troubleshooting, best practices, decision making, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when using feature flags, dynamic refresh, snapshots, geo-replication, or App Configuration REST APIs, and other Azure App Configuration related development tasks. Not for Azure App Service (use azure-app-service), Azure Key Vault (use azure-key-vault), Azure Automation (use azure-automation).
compatibility	Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or WebFetch to retrieve documentation.
user-invocable	false

Azure App Configuration Skill

This skill provides expert guidance for Azure App Configuration. Covers troubleshooting, best practices, decision making, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities.

How to Use This Skill

IMPORTANT for Agent: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g., L35-L120), use read_file with the specified lines. For categories with file links (e.g., [security.md](security.md)), use read_file on the linked reference file

This skill requires network access to fetch documentation content:

• Preferred: Use mcp_microsoftdocs:microsoft_docs_fetch. Returns Markdown.
• Fallback: Use WebFetch. Returns Markdown.

Category Index

Category	Lines	Description
Troubleshooting	L32-L36	Diagnosing and fixing Azure App Configuration network access issues, including connectivity failures, firewall/VNet restrictions, private endpoints, and common error patterns.
Best Practices	L37-L41	Guidance on designing and using App Configuration efficiently: key/value organization, labeling, feature flags, performance, security, and cost-optimized access patterns.
Decision Making	L42-L47	Guidance on App Configuration client library support lifecycles and how to upgrade Spring Boot apps to use App Configuration library v6.
Limits & Quotas	L48-L56	Limits on key-value retention, point-in-time reads, soft delete behavior, preview API lifecycles, and REST API throttling/quotas for Azure App Configuration.
Security	L57-L75	Securing App Configuration: encryption with customer-managed keys, Entra ID RBAC, managed identities, keys/HMAC, REST auth/authorization models, network perimeters, and Azure Policy compliance.
Configuration	L76-L94	Configuring App Configuration behavior: feature flags, filters, snapshots, geo-replication, soft delete, Kubernetes provider, emulator, dynamic refresh, and AI/chat completion settings.
Integrations & Coding Patterns	L95-L184	Patterns and code samples for integrating Azure App Configuration into .NET, Go, JavaScript, Python, AKS, Front Door, and AI apps, including dynamic config, feature flags, filters, and REST usage.
Deployment	L185-L193	Using App Configuration in CI/CD: exporting/importing settings, creating snapshots, integrating with Azure Pipelines, GitHub Actions, and Helm/Kubernetes deployment workflows.

Troubleshooting

Topic	URL
Diagnose Azure App Configuration network access errors	https://learn.microsoft.com/en-us/azure/azure-app-configuration/network-access-errors

Best Practices

Topic	URL
Apply Azure App Configuration usage best practices	https://learn.microsoft.com/en-us/azure/azure-app-configuration/howto-best-practices

Decision Making

Topic	URL
Understand support lifecycle for App Configuration client libraries	https://learn.microsoft.com/en-us/azure/azure-app-configuration/client-library-support-policy
Upgrade Spring Boot apps to App Configuration library v6	https://learn.microsoft.com/en-us/azure/azure-app-configuration/howto-convert-to-the-new-spring-boot

Limits & Quotas

Topic	URL
Use point-in-time key-value retrieval with tier limits	https://learn.microsoft.com/en-us/azure/azure-app-configuration/concept-point-time-snapshot
Understand preview API lifecycle and deprecation timelines for App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/concept-preview-api-life-cycle
Understand soft delete behavior and retention in App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/concept-soft-delete
Retention limits for App Configuration key-value revisions	https://learn.microsoft.com/en-us/azure/azure-app-configuration/rest-api-revisions
Throttling limits and quotas for App Configuration REST	https://learn.microsoft.com/en-us/azure/azure-app-configuration/rest-api-throttling

Security

Topic	URL
Encrypt App Configuration data with customer-managed keys	https://learn.microsoft.com/en-us/azure/azure-app-configuration/concept-customer-managed-keys
Configure Entra ID RBAC for Azure App Configuration access	https://learn.microsoft.com/en-us/azure/azure-app-configuration/concept-enable-rbac
Configure network security perimeter for App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/concept-network-security-perimeter
Manage access key authentication for Azure App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/howto-disable-access-key-authentication
Use managed identities to access Azure App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/howto-integrate-azure-managed-service-identity
Configure managed identities for Azure App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/overview-managed-identity
Apply built-in Azure Policy definitions to App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/policy-reference
Configure roles and permissions for App Configuration deployments	https://learn.microsoft.com/en-us/azure/azure-app-configuration/quickstart-deployment-overview
Authenticate to App Configuration REST with Entra ID	https://learn.microsoft.com/en-us/azure/azure-app-configuration/rest-api-authentication-azure-ad
Configure HMAC authentication for App Configuration REST	https://learn.microsoft.com/en-us/azure/azure-app-configuration/rest-api-authentication-hmac
Authentication options for App Configuration REST API	https://learn.microsoft.com/en-us/azure/azure-app-configuration/rest-api-authentication-index
Use Entra RBAC for App Configuration REST authorization	https://learn.microsoft.com/en-us/azure/azure-app-configuration/rest-api-authorization-azure-ad
Authorize App Configuration REST calls with HMAC keys	https://learn.microsoft.com/en-us/azure/azure-app-configuration/rest-api-authorization-hmac
Authorization models for App Configuration REST API	https://learn.microsoft.com/en-us/azure/azure-app-configuration/rest-api-authorization-index
Azure Policy regulatory compliance controls for App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/security-controls-policy

Configuration

Topic	URL
Use configuration files with Azure App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/concept-config-file
Use and configure the Azure App Configuration emulator	https://learn.microsoft.com/en-us/azure/azure-app-configuration/emulator-overview
Configure dynamic refresh for Spring with App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/enable-dynamic-configuration-java-spring-app
Configure and interpret App Configuration feature flag telemetry	https://learn.microsoft.com/en-us/azure/azure-app-configuration/feature-flag-telemetry-reference
Configure AI agents with Azure App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/howto-ai-agent-config
Define chat completion configuration settings in App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/howto-chat-completion-config
Create and manage App Configuration snapshots	https://learn.microsoft.com/en-us/azure/azure-app-configuration/howto-create-snapshots
Configure conditional feature flags with feature filters	https://learn.microsoft.com/en-us/azure/azure-app-configuration/howto-feature-filters
Configure and manage geo-replication for Azure App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/howto-geo-replication
Configure soft delete retention and recovery for App Configuration stores	https://learn.microsoft.com/en-us/azure/azure-app-configuration/howto-recover-deleted-stores-in-azure-app-configuration
Configure targeting filters for staged feature rollouts	https://learn.microsoft.com/en-us/azure/azure-app-configuration/howto-targetingfilter
Configure telemetry for feature flags in App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/howto-telemetry
Configure time window filters for scheduled feature flags	https://learn.microsoft.com/en-us/azure/azure-app-configuration/howto-timewindow-filter
Configure and manage variant feature flags in App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/howto-variant-feature-flags
Configure Azure App Configuration Kubernetes Provider properties	https://learn.microsoft.com/en-us/azure/azure-app-configuration/reference-kubernetes-provider

Integrations & Coding Patterns

Topic	URL
React to App Configuration changes using Event Grid	https://learn.microsoft.com/en-us/azure/azure-app-configuration/concept-app-configuration-event
Enable dynamic configuration in Aspire with App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/enable-dynamic-configuration-aspire
Enable dynamic configuration in ASP.NET Core with App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/enable-dynamic-configuration-aspnet-core
Enable dynamic configuration in ASP.NET (.NET Framework) with App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/enable-dynamic-configuration-aspnet-netfx
Use dynamic configuration in Azure Functions with App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/enable-dynamic-configuration-azure-functions-csharp
Enable dynamic configuration in AKS using App Configuration Kubernetes Provider	https://learn.microsoft.com/en-us/azure/azure-app-configuration/enable-dynamic-configuration-azure-kubernetes-service
Implement dynamic configuration in .NET Framework with App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/enable-dynamic-configuration-dotnet
Use dynamic configuration in .NET background services with App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/enable-dynamic-configuration-dotnet-background-service
Implement dynamic configuration in .NET with App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/enable-dynamic-configuration-dotnet-core
Implement push-based dynamic configuration in .NET with App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/enable-dynamic-configuration-dotnet-core-push-refresh
Enable dynamic configuration in Go Gin web apps with App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/enable-dynamic-configuration-gin-web-app
Enable dynamic configuration in Go console apps with App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/enable-dynamic-configuration-go-console-app
Use push refresh for dynamic configuration in Java Spring	https://learn.microsoft.com/en-us/azure/azure-app-configuration/enable-dynamic-configuration-java-spring-push-refresh
Enable dynamic configuration in JavaScript with Azure App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/enable-dynamic-configuration-javascript
Enable dynamic configuration in Python with Azure App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/enable-dynamic-configuration-python
Implement feature flags in .NET with App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/feature-management-dotnet-reference
Implement feature flags in Go with App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/feature-management-go-reference
Implement feature flags in JavaScript with App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/feature-management-javascript-reference
Implement feature flags in Python with App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/feature-management-python-reference
Integrate Azure App Configuration with Azure Front Door	https://learn.microsoft.com/en-us/azure/azure-app-configuration/how-to-connect-azure-front-door
Implement custom feature filters in Spring Boot with App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/how-to-feature-filters-spring-boot
Load app settings via Front Door from App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/how-to-load-azure-front-door-configuration-provider
Use targeting filter in Python with App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/how-to-targeting-filter-python
Use feature flag telemetry in ASP.NET Core with App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/how-to-telemetry-aspnet-core
Use variant feature flags in Spring Boot with App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/how-to-variant-feature-flags-spring-boot
Integrate .NET Agent Framework with Azure App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/howto-ai-agent-config-dotnet
Load Agent Framework YAML configs from App Configuration in Python	https://learn.microsoft.com/en-us/azure/azure-app-configuration/howto-ai-agent-config-python
Configure App Configuration data change notifications with Event Grid	https://learn.microsoft.com/en-us/azure/azure-app-configuration/howto-app-configuration-event
Implement custom feature filters in ASP.NET Core with App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/howto-feature-filters-aspnet-core
Implement custom feature filters in Go Gin with App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/howto-feature-filters-go
Implement custom feature filters in Node.js with App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/howto-feature-filters-javascript
Implement custom feature filters in Python with App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/howto-feature-filters-python
Use targeting filter in ASP.NET Core with App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/howto-targetingfilter-aspnet-core
Use targeting filter in Go Gin with App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/howto-targetingfilter-go
Use targeting filter in Node.js with App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/howto-targetingfilter-javascript
Use feature flag telemetry in Node.js with App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/howto-telemetry-javascript
Use feature flag telemetry in Python with App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/howto-telemetry-python
Use time window feature filters in Python applications	https://learn.microsoft.com/en-us/azure/azure-app-configuration/howto-time-window-filter-python
Use time window feature filters in ASP.NET Core	https://learn.microsoft.com/en-us/azure/azure-app-configuration/howto-timewindow-filter-aspnet-core
Use time window feature filters in Go Gin	https://learn.microsoft.com/en-us/azure/azure-app-configuration/howto-timewindow-filter-go
Use time window feature filters in Node.js	https://learn.microsoft.com/en-us/azure/azure-app-configuration/howto-timewindow-filter-javascript
Use variant feature flags in ASP.NET Core with App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/howto-variant-feature-flags-aspnet-core
Use variant feature flags in Go Gin with App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/howto-variant-feature-flags-go
Use variant feature flags in Node.js with App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/howto-variant-feature-flags-javascript
Use variant feature flags in Python with App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/howto-variant-feature-flags-python
Integrate Azure App Configuration with .NET Aspire solutions	https://learn.microsoft.com/en-us/azure/azure-app-configuration/quickstart-aspire
Integrate Azure App Configuration with ASP.NET Core	https://learn.microsoft.com/en-us/azure/azure-app-configuration/quickstart-aspnet-core-app
Integrate Azure App Configuration with Azure Functions (C#)	https://learn.microsoft.com/en-us/azure/azure-app-configuration/quickstart-azure-functions-csharp
Use Azure App Configuration Kubernetes Provider with AKS apps	https://learn.microsoft.com/en-us/azure/azure-app-configuration/quickstart-azure-kubernetes-service
Use chat completion configuration in a .NET AI app	https://learn.microsoft.com/en-us/azure/azure-app-configuration/quickstart-chat-completion-dotnet
Use chat completion configuration in a Go AI app	https://learn.microsoft.com/en-us/azure/azure-app-configuration/quickstart-chat-completion-go
Use Azure App Configuration for chat completion in Python	https://learn.microsoft.com/en-us/azure/azure-app-configuration/quickstart-chat-completion-python
Integrate Azure App Configuration with .NET Framework apps	https://learn.microsoft.com/en-us/azure/azure-app-configuration/quickstart-dotnet-app
Integrate Azure App Configuration with .NET console apps	https://learn.microsoft.com/en-us/azure/azure-app-configuration/quickstart-dotnet-core-app
Use Azure App Configuration feature flags in Aspire apps	https://learn.microsoft.com/en-us/azure/azure-app-configuration/quickstart-feature-flag-aspire
Use Azure App Configuration feature flags in ASP.NET Core	https://learn.microsoft.com/en-us/azure/azure-app-configuration/quickstart-feature-flag-aspnet-core
Add Azure App Configuration feature flags to Azure Functions	https://learn.microsoft.com/en-us/azure/azure-app-configuration/quickstart-feature-flag-azure-functions-csharp
Add Azure App Configuration feature flags to .NET apps	https://learn.microsoft.com/en-us/azure/azure-app-configuration/quickstart-feature-flag-dotnet
Add Azure App Configuration feature flags to .NET background services	https://learn.microsoft.com/en-us/azure/azure-app-configuration/quickstart-feature-flag-dotnet-background-service
Add Azure App Configuration feature flags to Go console apps	https://learn.microsoft.com/en-us/azure/azure-app-configuration/quickstart-feature-flag-go-console
Add Azure App Configuration feature flags to Go Gin web apps	https://learn.microsoft.com/en-us/azure/azure-app-configuration/quickstart-feature-flag-go-gin
Add Azure App Configuration feature flags to JavaScript apps	https://learn.microsoft.com/en-us/azure/azure-app-configuration/quickstart-feature-flag-javascript
Add Azure App Configuration feature flags to Python apps	https://learn.microsoft.com/en-us/azure/azure-app-configuration/quickstart-feature-flag-python
Use Azure App Configuration Go provider in console apps	https://learn.microsoft.com/en-us/azure/azure-app-configuration/quickstart-go-console-app
Use Azure App Configuration with Go Gin web applications	https://learn.microsoft.com/en-us/azure/azure-app-configuration/quickstart-go-web-app
Use Azure App Configuration from JavaScript SDK	https://learn.microsoft.com/en-us/azure/azure-app-configuration/quickstart-javascript
Use Azure App Configuration JavaScript provider in Node.js apps	https://learn.microsoft.com/en-us/azure/azure-app-configuration/quickstart-javascript-provider
Use Azure App Configuration from Python SDK	https://learn.microsoft.com/en-us/azure/azure-app-configuration/quickstart-python
Use Azure App Configuration Python provider in apps	https://learn.microsoft.com/en-us/azure/azure-app-configuration/quickstart-python-provider
Use .NET configuration provider for App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/reference-dotnet-provider
Use Go provider with Azure App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/reference-go-provider
Use JavaScript configuration provider for App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/reference-javascript-provider
Use Azure App Configuration Python provider for centralized settings	https://learn.microsoft.com/en-us/azure/azure-app-configuration/reference-python-provider
Automatically reload Key Vault secrets via App Configuration in .NET	https://learn.microsoft.com/en-us/azure/azure-app-configuration/reload-key-vault-secrets-dotnet
Call Azure App Configuration data-plane REST APIs	https://learn.microsoft.com/en-us/azure/azure-app-configuration/rest-api
Ensure consistency using App Configuration REST sync tokens	https://learn.microsoft.com/en-us/azure/azure-app-configuration/rest-api-consistency
HTTP headers reference for App Configuration REST API	https://learn.microsoft.com/en-us/azure/azure-app-configuration/rest-api-headers
Work with key-values in App Configuration REST API	https://learn.microsoft.com/en-us/azure/azure-app-configuration/rest-api-key-value
Manage App Configuration keys via REST API	https://learn.microsoft.com/en-us/azure/azure-app-configuration/rest-api-keys
Use labels with Azure App Configuration REST API	https://learn.microsoft.com/en-us/azure/azure-app-configuration/rest-api-labels
Lock and unlock key-values via App Configuration REST	https://learn.microsoft.com/en-us/azure/azure-app-configuration/rest-api-locks
Manage App Configuration snapshots via REST API	https://learn.microsoft.com/en-us/azure/azure-app-configuration/rest-api-snapshot
API versioning rules for App Configuration REST	https://learn.microsoft.com/en-us/azure/azure-app-configuration/rest-api-versioning
Integrate App Configuration Key Vault references in ASP.NET Core	https://learn.microsoft.com/en-us/azure/azure-app-configuration/use-key-vault-references-dotnet-core
Use App Configuration Key Vault references in Python apps	https://learn.microsoft.com/en-us/azure/azure-app-configuration/use-key-vault-references-python-provider
Use App Configuration Key Vault references in Spring Boot	https://learn.microsoft.com/en-us/azure/azure-app-configuration/use-key-vault-references-spring-boot

Deployment

Topic	URL
Export App Configuration settings using Azure Pipelines	https://learn.microsoft.com/en-us/azure/azure-app-configuration/azure-pipeline-export-task
Import configuration into App Configuration using Azure Pipelines	https://learn.microsoft.com/en-us/azure/azure-app-configuration/azure-pipeline-import-task
Create App Configuration snapshots with Azure Pipelines	https://learn.microsoft.com/en-us/azure/azure-app-configuration/azure-pipeline-snapshot-task
Integrate Azure App Configuration into CI/CD pipelines	https://learn.microsoft.com/en-us/azure/azure-app-configuration/integrate-ci-cd-pipeline
Use App Configuration with Kubernetes deployments via Helm	https://learn.microsoft.com/en-us/azure/azure-app-configuration/integrate-kubernetes-deployment-helm
Sync GitHub configuration files to App Configuration via GitHub Actions	https://learn.microsoft.com/en-us/azure/azure-app-configuration/push-kv-github-action