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 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), Azure Policy (use azure-policy).
compatibility	Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
metadata	{"generated_at":"2026-04-05","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 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

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

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