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, Key Vault integration, or CI/CD with App Configuration, and other Azure App Configuration related development tasks. Not for Azure App Service (use azure-app-service), Azure Functions (use azure-functions), Azure Key Vault (use azure-key-vault), Azure Portal (use azure-portal).
compatibility	Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
metadata	{"generated_at":"2026-08-09","generator":"docs2skills/1.0.0"}

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 connectivity failures, firewall/VNet restrictions, private endpoints, and common error patterns.
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, retention, and lifecycle rules for App Configuration: snapshots, soft delete, key-value revision retention, preview API deprecation, and REST throttling quotas.
Security	L61-L83	Securing App Configuration: encryption, RBAC/Entra ID, keys/HMAC, REST authz models, managed identities, private endpoints, network perimeter, and Azure Policy compliance.
Configuration	L84-L102	Configuring App Configuration behavior: files, emulator, dynamic refresh, feature flags/filters/telemetry, snapshots, geo-replication, soft delete, Kubernetes, Front Door, and AI/chat settings.
Integrations & Coding Patterns	L103-L183	Patterns and code for integrating App Configuration into .NET/Go/JS/Python apps, dynamic refresh, feature flags/filters/telemetry, Kubernetes, Key Vault, and using REST/SDK providers.
Deployment	L184-L192	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 snapshots in Azure App Configuration	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 Azure App Configuration 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 Azure App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/concept-network-security-perimeter
Configure private endpoints for Azure App Configuration	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 access for Azure App Configuration stores	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
Associate Azure App Configuration with a network security perimeter	https://learn.microsoft.com/en-us/azure/azure-app-configuration/howto-set-up-network-security-perimeter
Set up private access to Azure App Configuration	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

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 Azure App Configuration feature flag telemetry	https://learn.microsoft.com/en-us/azure/azure-app-configuration/feature-flag-telemetry-reference
Configure Azure App Configuration integration with Front Door	https://learn.microsoft.com/en-us/azure/azure-app-configuration/how-to-connect-azure-front-door
Configure AI agents via Azure App Configuration	https://learn.microsoft.com/en-us/azure/azure-app-configuration/howto-ai-agent-config
Configure chat completion 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

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

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