How to enable system-assigned managed identity for Azure Spring Cloud application
This article applies to: ✔️ Java ✔️ C#
Managed identities for Azure resources provide an automatically managed identity in Azure Active Directory to an Azure resource such as your Azure Spring Cloud application. You can use this identity to authenticate to any service that supports Azure AD authentication, without having credentials in your code.
This article shows how to enable and disable system-assigned managed identities for an Azure Spring Cloud app, using the Azure portal and CLI (available from version 0.2.4).
Add a system-assigned identity
Creating an app with a system-assigned identity requires setting an additional property on the application.
Using Azure portal
To set up a managed identity in the Azure portal, first create an app, and then enable the feature.
- Create an app in the portal as you normally would. Navigate to it in the portal.
- Scroll down to the Settings group in the left navigation pane.
- Select Identity.
- Within the System assigned tab, switch Status to On. Select Save.
Using Azure CLI
You can enable system-assigned managed identity during app creation or on an existing app.
Enable system-assigned managed identity during creation of an app
The following example creates an app named app_name with a system-assigned managed identity, as requested by the
az spring-cloud app create -n app_name -s service_name -g resource_group_name --assign-identity
Enable system-assigned managed identity on an existing app
az spring-cloud app identity assign command to enable the system-assigned identity on an existing app.
az spring-cloud app identity assign -n app_name -s service_name -g resource_group_name
Obtain tokens for Azure resources
An app can use its managed identity to get tokens to access other resources protected by Azure Active Directory, such as Azure Key Vault. These tokens represent the application accessing the resource, not any specific user of the application.
You may need to configure the target resource to allow access from your application. For example, if you request a token to access Key Vault, make sure you have added an access policy that includes your application's identity. Otherwise, your calls to Key Vault will be rejected, even if they include the token. To learn more about which resources support Azure Active Directory tokens, see Azure services that support Azure AD authentication.
Azure Spring Cloud shares the same endpoint for token acquisition with Azure Virtual Machine. We recommend using Java SDK or spring boot starters to acquire a token. See How to use VM token for various code and script examples and guidance on important topics such as handling token expiration and HTTP errors.
Recommended: use Java SDK or spring boot starters to get tokens. See the samples in the Next Steps.
Disable system-assigned identity from an app
Removing a system-assigned identity will also delete it from Azure AD. Deleting the app resource automatically removes system-assigned identities from Azure AD.
Using Azure portal
To remove system-assigned managed identity from an app that no longer needs it:
- Sign in to the Azure portal using an account associated with the Azure subscription that contains the Azure Spring Cloud instance.
- Navigate to the desired Virtual Machine and select Identity.
- Under System assigned/Status, select Off and then select Save:
Using Azure CLI
To remove system-assigned managed identity from an app that no longer needs it, use the following command:
az spring-cloud app identity remove -n app_name -s service_name -g resource_group_name