{"title":"Use app key vaults with Business Central extensions","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/devenv-app-key-vault-overview/","by":"JOP-AL","license":"Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/devenv-app-key-vault-overview, MicrosoftDocs/dynamics365smb-devitpro-pb at 828b6ee (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/devenv-app-key-vault-overview","source":{"name":"Business Central developer and IT pro docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-devitpro-pb","commit":"828b6ee72fcd75755627cd6011f3d20899217ab2","date":"2026-11-19"},"checked":"2026-11-19","description":"Learn how Business Central extensions use Azure Key Vault to securely retrieve secrets in online and on-premises environments.","date":"2026-10-08","meta":{"topic":"overview"},"outline":[{"level":1,"title":"Use app key vaults with Business Central extensions","slug":"use-app-key-vaults-with-business-central-extensions","at":0,"chars":3145},{"level":2,"title":"Get started with app key vaults","slug":"get-started-with-app-key-vaults","at":1077,"chars":1735},{"level":3,"title":"Setting up and configuring Azure Key Vaults","slug":"setting-up-and-configuring-azure-key-vaults","at":1306,"chars":509},{"level":3,"title":"Developing the extensions to use secrets from Azure Key Vault","slug":"developing-the-extensions-to-use-secrets-from-azure-key-vault","at":1815,"chars":368},{"level":3,"title":"Monitoring the usage of and errors in Azure Key Vault with telemetry","slug":"monitoring-the-usage-of-and-errors-in-azure-key-vault-with-telemetry","at":2183,"chars":629},{"level":2,"title":"Related information","slug":"related-information","at":2812,"chars":333}],"text":"# Use app key vaults with Business Central extensions\n> APPLIES TO: Business Central 2020 release wave 2 and later\nSome Business Central extensions make web service calls to non-Business Central services. For example, one extension might call Azure Storage to read or write blobs. Another extension might call the extension publisher's web service to do an operation.\nThese web service calls are typically authenticated, which means the extension must provide a credential in the call. The credentials enable the other service to accept or reject the call. You can consider the credentials as a kind of secret to the extension. A secret shouldn't be leaked to customers, partners, or anybody else. So where can the extension get the secret from? Here is where Azure Key Vault is used. Azure Key Vault is a cloud service that works as a secure secrets store. It provides centralized storage for secrets, enabling you to control access and distribution of the secrets.\n> NOTE\n> For Business Central online, the app key vault feature is only supported for Marketplace extensions.\n## Get started with app key vaults\nGetting extensions to use secrets from Azure Key Vault involves two areas of work: setting up and configuring Azure Key Vaults and developing the extensions to use secrets from Azure Key Vault.\n### Setting up and configuring Azure Key Vaults\nAn extension can retrieve secrets from one or two different Azure Key Vaults. These key vaults must be created in Azure, and the Business Central service configured to access key vaults. The setup process is different for online and on-premises. Learn more in:\n Setting up App Key Vaults for Business Central online<../administration/setup-app-key-vault>\n Setting up App Key Vaults for Business Central on-premises<../administration/setup-app-key-vault-onprem>\n### Developing the extensions to use secrets from Azure Key Vault\nOnce you have an Azure Key Vault, you can develop Business Central extensions to retrieve secrets from the key vault. In short, this work involves specifying the key vault's URL and adding code to retrieve a secret from the key vault.\nSee Use app key vault secrets in extensions<devenv-app-key-vault>.\n### Monitoring the usage of and errors in Azure Key Vault with telemetry\nApp key vault telemetry gathers information about how extensions acquire secrets from Azure Key Vaults at runtime.\nThe app key vault secret process has two operations: initialization and retrieval. The telemetry data provides information about the success or failure for each of these operations. There are various conditions that cause a failure. The failure messages provide insight into the cause of the failure, helping you identify, troubleshoot, and resolve issues.\nSee App Key Vault Telemetry<../administration/telemetry-extension-key-vault-trace>.\n## Related information\nSecurity considerations with app key vaults<devenv-app-key-vault#security>\nMonitor and troubleshoot app key vaults<devenv-app-key-vault#troubleshooting>\nApp key vault telemetry<../administration/telemetry-extension-key-vault-trace>\nConfigure Business Central Server<../administration/configure-server-instance>"}