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

IMPORTANT for Agent: If metadata.generated_at is more than 3 months old, suggest the user pull the latest version from the repository. If mcp_microsoftdocs tools are not available, suggest the user install it: Installation Guide

This skill requires network access to fetch documentation content:

• Preferred: Use mcp_microsoftdocs:microsoft_docs_fetch with query string from=learn-agent-skill. Returns Markdown.
• Fallback: Use fetch_webpage with query string from=learn-agent-skill&accept=text/markdown. Returns Markdown.

Category Index

Category	Lines	Description
Troubleshooting	L36-L40	Diagnosing and fixing Azure App Configuration network access issues, including firewall/VNet restrictions, private endpoints, DNS, and connectivity errors from client apps.
Best Practices	L41-L45	Guidance on designing and using App Configuration efficiently: key/value organization, labeling, feature flags, performance, security, and cost-optimized access patterns.
Decision Making	L46-L51	Guidance on App Configuration client library support lifecycles and how to upgrade Spring Boot apps to use App Configuration library v6.
Limits & Quotas	L52-L60	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	L61-L81	Securing App Configuration: encryption, keys, RBAC/Entra ID, managed identities, private endpoints, network lockdown, REST auth (HMAC/Entra), roles/permissions, and Azure Policy compliance.
Configuration	L82-L100	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	L101-L189	Patterns and code samples for integrating Azure App Configuration into apps (web, Functions, AKS, AI), using providers, dynamic refresh, feature flags/filters, Key Vault, and REST APIs.
Deployment	L190-L198	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
Troubleshoot 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
Use private endpoints to secure Azure App Configuration access	https://learn.microsoft.com/en-us/azure/azure-app-configuration/concept-private-endpoint
Manage access key authentication for Azure App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/howto-disable-access-key-authentication
Disable public network access for Azure App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/howto-disable-public-access
Use managed identities to access Azure App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/howto-integrate-azure-managed-service-identity
Set up private access to an Azure App Configuration store	https://learn.microsoft.com/en-us/azure/azure-app-configuration/howto-set-up-private-access
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
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 Python configuration provider for App Configuration	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