Merge pull request #263172 from mrm9084/main

Azure Spring Cloud App Configuration Updates

Author: prmerger-automator[bot]

articles/azure-app-configuration/enable-dynamic-configuration-java-spring-app.md

@@ -123,7 +123,7 @@ Then, open the *pom.xml* file in a text editor and add a `<dependency>` for `spr
 <dependency>
     <groupId>com.azure.spring</groupId>
     <artifactId>spring-cloud-azure-appconfiguration-config-web</artifactId>
-    <version>5.4.0</version>
+    <version>5.8.0</version>
 </dependency>
 ```
 
@@ -133,7 +133,7 @@ Then, open the *pom.xml* file in a text editor and add a `<dependency>` for `spr
 <dependency>
     <groupId>com.azure.spring</groupId>
     <artifactId>spring-cloud-azure-appconfiguration-config-web</artifactId>
-    <version>4.10.0</version>
+    <version>4.14.0</version>
 </dependency>
 ```
 

articles/azure-app-configuration/enable-dynamic-configuration-java-spring-push-refresh.md

@@ -70,7 +70,7 @@ In this tutorial, you learn how to:
             <dependency>
             <groupId>com.azure.spring</groupId>
             <artifactId>spring-cloud-azure-dependencies</artifactId>
-            <version>5.5.0</version>
+            <version>5.8.0</version>
             <type>pom</type>
             <scope>import</scope>
             </dependency>
@@ -84,7 +84,6 @@ In this tutorial, you learn how to:
     <dependency>
         <groupId>com.azure.spring</groupId>
         <artifactId>spring-cloud-azure-appconfiguration-config-web</artifactId>
-        <version>4.10.0</version>
     </dependency>
 
     <!-- Adds the Ability to Push Refresh -->
@@ -98,7 +97,7 @@ In this tutorial, you learn how to:
             <dependency>
             <groupId>com.azure.spring</groupId>
             <artifactId>spring-cloud-azure-dependencies</artifactId>
-            <version>4.11.0</version>
+            <version>4.14.0</version>
             <type>pom</type>
             <scope>import</scope>
             </dependency>
@@ -115,7 +114,7 @@ In this tutorial, you learn how to:
    mvn com.microsoft.azure:azure-webapp-maven-plugin:2.5.0:config
    ```
 
-1. Open bootstrap.properties and configure Azure App Configuration Push Refresh and Azure Service Bus
+1. Open bootstrap.properties and configure Azure App Configuration Push Refresh.
 
    ```properties
    # Azure App Configuration Properties
@@ -201,7 +200,10 @@ Event Grid Web Hooks require validation on creation. You can validate by followi
     :::image type="content" source="./media/event-subscription-view-webhook.png" alt-text="Web Hook shows up in a table on the bottom of the page." :::
 
 > [!NOTE]
-> When subscribing for configuration changes, one or more filters can be used to reduce the number of events sent to your application. These can be configured either as [Event Grid subscription filters](../event-grid/event-filtering.md) or [Service Bus subscription filters](../service-bus-messaging/topic-filters.md). For example, a subscription filter can be used to only subscribe to events for changes in a key that starts with a specific string.
+> When subscribing for configuration changes, one or more filters can be used to reduce the number of events sent to your application. These can be configured either as [Event Grid subscription filters](../event-grid/event-filtering.md). For example, a subscription filter can be used to only subscribe to events for changes in a key that starts with a specific string.
+
+> [!NOTE]
+> If you have multiple instances of your application running, you can use the `appconfiguration-refresh-bus` endpoint which requires setting up Azure Service Bus, which is used to send a message to all instances of your application to refresh their configuration. This is useful if you have multiple instances of your application running and want to ensure that all instances are updated with the latest configuration. This endpoint isn't available unless you have `spring-cloud-bus` as a dependency with it configured. See the [Azure Service Bus Spring Cloud Bus documentation](/azure/developer/java/spring-framework/using-service-bus-in-spring-applications) for more information. The service bus connection only needs to be set up and the Azure App Configuration library will handle sending and receiving the messages.
 
 ## Verify and test application
 

articles/azure-app-configuration/howto-convert-to-the-new-spring-boot.md

@@ -45,7 +45,7 @@ All of the group and artifact IDs in the Azure libraries for Spring Boot have be
         <dependency>
         <groupId>com.azure.spring</groupId>
         <artifactId>spring-cloud-azure-dependencies</artifactId>
-        <version>5.5.0</version>
+        <version>5.8.0</version>
         <type>pom</type>
         <scope>import</scope>
         </dependency>
@@ -78,7 +78,7 @@ All of the group and artifact IDs in the Azure libraries for Spring Boot have be
         <dependency>
         <groupId>com.azure.spring</groupId>
         <artifactId>spring-cloud-azure-dependencies</artifactId>
-        <version>4.11.0</version>
+        <version>4.14.0</version>
         <type>pom</type>
         <scope>import</scope>
         </dependency>
@@ -120,6 +120,37 @@ spring.cloud.azure.appconfiguration.stores[0].monitoring.feature-flag-refresh-in
 
 The property `spring.cloud.azure.appconfiguration.stores[0].feature-flags.label` has been removed. Instead, you can use `spring.cloud.azure.appconfiguration.stores[0].feature-flags.selects[0].label-filter` to specify a label filter.
 
+## Using Client Customizers
+
+`ConfigurationClientCustomizer` and `SecretClientCustomizer` are used to customize the `ConfigurationClient` and `SecretClient` instances. You can use them to modify the clients before they're used to connect to App Configuration. This allows for using any credential type supported by the [Azure Identity library](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity/README.md#credential-classes). You can also modify the clients to set a custom `HttpClient` or `HttpPipeline`.
+
+```java
+import com.azure.core.credential.TokenCredential;
+import com.azure.data.appconfiguration.ConfigurationClientBuilder;
+import com.azure.identity.AzureCliCredential;
+import com.azure.identity.AzureCliCredentialBuilder;
+import com.azure.identity.ChainedTokenCredential;
+import com.azure.identity.ChainedTokenCredentialBuilder;
+import com.azure.identity.EnvironmentCredentialBuilder;
+import com.azure.identity.ManagedIdentityCredential;
+import com.azure.identity.ManagedIdentityCredentialBuilder;
+import com.azure.spring.cloud.appconfiguration.config.ConfigurationClientCustomizer;
+
+public class ConfigurationClientCustomizerImpl implements ConfigurationClientCustomizer {
+
+    @Override
+    public void customize(ConfigurationClientBuilder builder, String endpoint) {
+        AzureCliCredential cliCredential = new AzureCliCredentialBuilder().build();
+        String managedIdentityClientId = System.getenv("MANAGED_IDENTITY_CLIENT_ID");
+        ManagedIdentityCredential managedIdentityCredential = new ManagedIdentityCredentialBuilder()
+            .clientId(managedIdentityClientId).build();
+        ChainedTokenCredential credential = new ChainedTokenCredentialBuilder().addLast(cliCredential)
+            .addLast(managedIdentityCredential).build();
+        builder.credential(credential);
+    }
+}
+```
+
 ## Possible conflicts with Spring Cloud Azure global properties
 
 [Spring Cloud Azure common configuration properties](/azure/developer/java/spring-framework/configuration) enable you to customize your connections to Azure services. The new App Configuration library will pick up any global or App Configuration setting that's configured with Spring Cloud Azure common configuration properties. Your connection to App Configuration will change if the configurations are set for another Spring Cloud Azure library.

articles/azure-app-configuration/quickstart-feature-flag-spring-boot.md

@@ -73,7 +73,7 @@ To create a new Spring Boot project:
             <dependency>
             <groupId>com.azure.spring</groupId>
             <artifactId>spring-cloud-azure-dependencies</artifactId>
-            <version>5.5.0</version>
+            <version>5.8.0</version>
             <type>pom</type>
             <scope>import</scope>
             </dependency>
@@ -102,7 +102,7 @@ To create a new Spring Boot project:
             <dependency>
             <groupId>com.azure.spring</groupId>
             <artifactId>spring-cloud-azure-dependencies</artifactId>
-            <version>4.11.0</version>
+            <version>4.14.0</version>
             <type>pom</type>
             <scope>import</scope>
             </dependency>

articles/azure-app-configuration/quickstart-java-spring-app.md

@@ -51,7 +51,7 @@ To install the Spring Cloud Azure Config starter module, add the following depen
         <dependency>
         <groupId>com.azure.spring</groupId>
         <artifactId>spring-cloud-azure-dependencies</artifactId>
-        <version>5.5.0</version>
+        <version>5.8.0</version>
         <type>pom</type>
         <scope>import</scope>
         </dependency>
@@ -72,7 +72,7 @@ To install the Spring Cloud Azure Config starter module, add the following depen
         <dependency>
         <groupId>com.azure.spring</groupId>
         <artifactId>spring-cloud-azure-dependencies</artifactId>
-        <version>4.11.0</version>
+        <version>4.14.0</version>
         <type>pom</type>
         <scope>import</scope>
         </dependency>

articles/azure-app-configuration/use-feature-flags-spring-boot.md

@@ -62,7 +62,7 @@ The easiest way to connect your Spring Boot application to App Configuration is
         <dependency>
         <groupId>com.azure.spring</groupId>
         <artifactId>spring-cloud-azure-dependencies</artifactId>
-        <version>5.5.0</version>
+        <version>5.8.0</version>
         <type>pom</type>
         <scope>import</scope>
         </dependency>
@@ -83,7 +83,7 @@ The easiest way to connect your Spring Boot application to App Configuration is
         <dependency>
         <groupId>com.azure.spring</groupId>
         <artifactId>spring-cloud-azure-dependencies</artifactId>
-        <version>4.11.0</version>
+        <version>4.14.0</version>
         <type>pom</type>
         <scope>import</scope>
         </dependency>