Merge branch 'master' into dependabot/github_actions/gradle/gradle-build-action-3.5.0

Author: tanya732

.version

@@ -1 +1 @@
-2.19.0
+2.23.0

CHANGELOG.md

@@ -1,5 +1,36 @@
 # Change Log
 
+## [2.23.0](https://github.com/auth0/auth0-java/tree/2.23.0) (2025-07-14)
+[Full Changelog](https://github.com/auth0/auth0-java/compare/2.22.0...2.23.0)
+
+**Added**
+- Added organization support for Change Password [\#726](https://github.com/auth0/auth0-java/pull/726) ([tanya732](https://github.com/tanya732))
+- Fix: Resource Server Scopes [\#725](https://github.com/auth0/auth0-java/pull/725) ([tanya732](https://github.com/tanya732))
+
+## [2.22.0](https://github.com/auth0/auth0-java/tree/2.22.0) (2025-06-20)
+[Full Changelog](https://github.com/auth0/auth0-java/compare/2.21.0...2.22.0)
+
+**Added**
+- Added support for connectionKeys Endpoint [\#721](https://github.com/auth0/auth0-java/pull/721) ([tanya732](https://github.com/tanya732))
+
+## [2.21.0](https://github.com/auth0/auth0-java/tree/2.21.0) (2025-05-30)
+[Full Changelog](https://github.com/auth0/auth0-java/compare/2.20.0...2.21.0)
+
+**Added**
+- SDK Limit M2M Java Support [\#708](https://github.com/auth0/auth0-java/pull/708) ([tanya732](https://github.com/tanya732))
+- Added support for GET/PATCH Connection Endpoints  [\#718](https://github.com/auth0/auth0-java/pull/718) ([tanya732](https://github.com/tanya732))
+- Added support for EmailTemplate [\#720](https://github.com/auth0/auth0-java/pull/720) ([tanya732](https://github.com/tanya732))
+
+**Fixed**
+- Updated EnabledConnection [\#719](https://github.com/auth0/auth0-java/pull/719) ([tanya732](https://github.com/tanya732))
+
+## [2.20.0](https://github.com/auth0/auth0-java/tree/2.20.0) (2025-05-06)
+[Full Changelog](https://github.com/auth0/auth0-java/compare/2.19.0...2.20.0)
+
+**Fixed**
+- Fixed POST/PATCH connection endpoints [\#710](https://github.com/auth0/auth0-java/pull/710) ([tanya732](https://github.com/tanya732))
+- Fix log event [\#711](https://github.com/auth0/auth0-java/pull/711) ([tanya732](https://github.com/tanya732))
+
 ## [2.19.0](https://github.com/auth0/auth0-java/tree/2.19.0) (2025-03-28)
 [Full Changelog](https://github.com/auth0/auth0-java/compare/2.18.0...2.19.0)
 

README.md

@@ -34,14 +34,14 @@ Add the dependency via Maven:
 <dependency>
   <groupId>com.auth0</groupId>
   <artifactId>auth0</artifactId>
-  <version>2.19.0</version>
+  <version>2.23.0</version>
 </dependency>
 ```
 
 or Gradle:
 
 ```gradle
-implementation 'com.auth0:auth0:2.19.0'
+implementation 'com.auth0:auth0:2.23.0'
 ```
 
 ### Configure the SDK

src/main/java/com/auth0/client/auth/AuthAPI.java

@@ -525,6 +525,31 @@ public Request<Void> resetPassword(String email, String connection) {
      * @return a Request to execute.
      */
     public Request<Void> resetPassword(String clientId, String email, String connection) {
+        return resetPassword(clientId, email, connection, null);
+    }
+
+    /**
+     * Request a password reset for the given client ID, email, database connection and organization ID. The response will always be successful even if
+     * there's no user associated to the given email for that database connection.
+     * i.e.:
+     * <pre>
+     * {@code
+     * try {
+     *      authAPI.resetPassword("CLIENT-ID", "me@auth0.com", "db-connection", "ORGANIZATION-ID").execute().getBody();
+     * } catch (Auth0Exception e) {
+     *      //Something happened
+     * }
+     * }
+     * </pre>
+     *
+     * @see <a href="https://auth0.com/docs/api/authentication#change-password">Change Password API docs</a>
+     * @param clientId   the client ID of your client.
+     * @param email      the email associated to the database user.
+     * @param connection the database connection where the user was created.
+     * @param organization the organization ID where the user was created.
+     * @return a Request to execute.
+     */
+    public Request<Void> resetPassword(String clientId, String email, String connection, String organization) {
         Asserts.assertNotNull(email, "email");
         Asserts.assertNotNull(connection, "connection");
 
@@ -538,6 +563,7 @@ public Request<Void> resetPassword(String clientId, String email, String connect
         request.addParameter(KEY_CLIENT_ID, clientId);
         request.addParameter(KEY_EMAIL, email);
         request.addParameter(KEY_CONNECTION, connection);
+        request.addParameter(KEY_ORGANIZATION, organization);
         return request;
     }
 

src/main/java/com/auth0/client/mgmt/ConnectionsEntity.java

@@ -1,8 +1,10 @@
 package com.auth0.client.mgmt;
 
 import com.auth0.client.mgmt.filter.ConnectionFilter;
+import com.auth0.client.mgmt.filter.EnabledClientsFilter;
 import com.auth0.json.mgmt.connections.*;
 import com.auth0.net.BaseRequest;
+import com.auth0.net.EmptyBodyRequest;
 import com.auth0.net.Request;
 import com.auth0.net.VoidRequest;
 import com.auth0.net.client.Auth0HttpClient;
@@ -370,4 +372,95 @@ public Request<Void> checkConnectionStatus(String connectionId){
 
         return new VoidRequest(client, tokenProvider, url, HttpMethod.GET);
     }
+
+    /**
+     * Get the enabled clients for a connection.
+     * A token with scope read:connections is needed.
+     * @see <a href="https://auth0.com/docs/api/management/v2#!/connections/get-connection-clients">https://auth0.com/docs/api/management/v2#!/connections/get-connection-clients</a>
+     * @param filter the filter to use. Can be null.
+     * @return a Request to execute.
+     */
+    public Request<EnabledClientResponse> getEnabledClients(String connectionId, EnabledClientsFilter filter) {
+        Asserts.assertNotNull(connectionId, "connection id");
+
+        HttpUrl.Builder builder = baseUrl
+            .newBuilder()
+            .addPathSegments("api/v2/connections")
+            .addPathSegment(connectionId)
+            .addPathSegment("clients");
+
+        if (filter != null) {
+            for (Map.Entry<String, Object> e : filter.getAsMap().entrySet()) {
+                builder.addQueryParameter(e.getKey(), String.valueOf(e.getValue()));
+            }
+        }
+        String url = builder.build().toString();
+        return new BaseRequest<>(client, tokenProvider, url, HttpMethod.GET, new TypeReference<EnabledClientResponse>() {
+        });
+    }
+
+    /**
+     * Update the enabled clients for a connection.
+     * A token with scope update:connections is needed.
+     * @see <a href="https://auth0.com/docs/api/management/v2#!/connections/patch-clients">https://auth0.com/docs/api/management/v2#!/connections/patch-clients</a>
+     *
+     * @param connectionId the connection id.
+     * @param enabledClientRequests      the enabled client request to set.
+     * @return a Request to execute.
+     */
+    public Request<Void> updateEnabledClients(String connectionId, List<EnabledClientRequest> enabledClientRequests){
+        Asserts.assertNotNull(connectionId, "connection id");
+        Asserts.assertNotEmpty(enabledClientRequests, "enabled client Request");
+
+        String url = baseUrl
+                .newBuilder()
+                .addPathSegments("api/v2/connections")
+                .addPathSegment(connectionId)
+                .addPathSegments("clients")
+                .build()
+                .toString();
+
+        VoidRequest request = new VoidRequest(client, tokenProvider, url, HttpMethod.PATCH);
+        request.setBody(enabledClientRequests);
+        return request;
+    }
+
+    /**
+     * Get the Connection Keys.
+     * A token with scope read:connections_keys is needed.
+     * @param connectionId the connection id.
+     * @return a Request to execute.
+     */
+    public Request<List<ConnectionKeys>> getKeys(String connectionId) {
+        Asserts.assertNotNull(connectionId, "connection id");
+
+        String url = baseUrl
+                .newBuilder()
+                .addPathSegments("api/v2/connections")
+                .addPathSegment(connectionId)
+                .addPathSegment("keys")
+                .build()
+                .toString();
+        return new BaseRequest<>(client, tokenProvider, url, HttpMethod.GET, new TypeReference<List<ConnectionKeys>>() {
+        });
+    }
+
+    /** * Rotate the Connection Keys.
+     * A token with scope create:connections_keys and update:connections_keys is needed.
+     * @param connectionId the connection id.
+     * @return a Request to execute.
+     */
+    public Request<RotateKey> rotateKey(String connectionId) {
+        Asserts.assertNotNull(connectionId, "connection id");
+
+        String url = baseUrl
+                .newBuilder()
+                .addPathSegments("api/v2/connections")
+                .addPathSegment(connectionId)
+                .addPathSegments("keys/rotate")
+                .build()
+                .toString();
+
+        return new EmptyBodyRequest<>(client, tokenProvider, url, HttpMethod.POST, new TypeReference<RotateKey>() {});
+    }
 }

src/main/java/com/auth0/client/mgmt/EmailTemplatesEntity.java

@@ -28,6 +28,9 @@ public class EmailTemplatesEntity extends BaseManagementEntity {
     public static final String TEMPLATE_CHANGE_PASSWORD = "change_password";
     public static final String TEMPLATE_PASSWORD_RESET = "password_reset";
     public static final String TEMPLATE_MFA_OOB_CODE = "mfa_oob_code";
+    public static final String TEMPLATE_VERIFY_EMAIL_BY_CODE = "verify_email_by_code";
+    public static final String TEMPLATE_RESET_EMAIL_BY_CODE = "reset_email_by_code";
+    public static final String TEMPLATE_USER_INVITATION = "user_invitation";
 
     EmailTemplatesEntity(Auth0HttpClient client, HttpUrl baseUrl, TokenProvider tokenProvider) {
         super(client, baseUrl, tokenProvider);

src/main/java/com/auth0/client/mgmt/filter/EnabledClientsFilter.java

@@ -0,0 +1,28 @@
+package com.auth0.client.mgmt.filter;
+
+public class EnabledClientsFilter extends BaseFilter {
+    /**
+     * Include the {@code from} parameter to specify where to start the page selection. Only applicable for endpoints that
+     * support checkpoint pagination.
+     *
+     * @param from the ID from which to start selection. This can be obtained from the {@code next} field returned from
+     *             a checkpoint-paginated result.
+     * @return this filter instance.
+     */
+    public EnabledClientsFilter withFrom(String from) {
+        parameters.put("from", from);
+        return this;
+    }
+
+    /**
+     * Include the {@code take} parameter to specify the amount of results to return per page. Only applicable for endpoints that
+     * support checkpoint pagination.
+     *
+     * @param take the amount of entries to retrieve per page.
+     * @return this filter instance.
+     */
+    public EnabledClientsFilter withTake(int take) {
+        parameters.put("take", take);
+        return this;
+    }
+}

src/main/java/com/auth0/exception/RateLimitException.java

@@ -1,5 +1,7 @@
 package com.auth0.exception;
 
+import com.auth0.net.TokenQuotaBucket;
+
 import java.util.Map;
 
 /**
@@ -16,6 +18,10 @@ public class RateLimitException extends APIException {
     private final long remaining;
     private final long reset;
 
+    private TokenQuotaBucket clientQuotaLimit;
+    private TokenQuotaBucket organizationQuotaLimit;
+    private long retryAfter;
+
     private static final int STATUS_CODE_TOO_MANY_REQUEST = 429;
 
     public RateLimitException(long limit, long remaining, long reset, Map<String, Object> values) {
@@ -56,4 +62,119 @@ public long getReset() {
         return reset;
     }
 
+    /**
+     * Getter for the client quota limit.
+     * @return The client quota limit or null if missing.
+     */
+    public TokenQuotaBucket getClientQuotaLimit() {
+        return clientQuotaLimit;
+    }
+
+    /**
+     * Getter for the organization quota limit.
+     * @return The organization quota limit or null if missing.
+     */
+    public TokenQuotaBucket getOrganizationQuotaLimit() {
+        return organizationQuotaLimit;
+    }
+
+    /**
+     * Getter for the retry after time in seconds.
+     * @return The retry after time in seconds or -1 if missing.
+     */
+    public long getRetryAfter() {
+        return retryAfter;
+    }
+
+    /**
+     * Builder class for creating instances of RateLimitException.
+     */
+    public static class Builder {
+        private long limit;
+        private long remaining;
+        private long reset;
+        private TokenQuotaBucket clientQuotaLimit;
+        private TokenQuotaBucket organizationQuotaLimit;
+        private long retryAfter;
+        private Map<String, Object> values;
+
+        /**
+         * Constructor for the Builder.
+         * @param limit The maximum number of requests available in the current time frame.
+         * @param remaining The number of remaining requests in the current time frame.
+         * @param reset The UNIX timestamp of the expected time when the rate limit will reset.
+         */
+        public Builder(long limit, long remaining, long reset) {
+            this.limit = limit;
+            this.remaining = remaining;
+            this.reset = reset;
+        }
+
+        /**
+         * Constructor for the Builder.
+         * @param limit The maximum number of requests available in the current time frame.
+         * @param remaining The number of remaining requests in the current time frame.
+         * @param reset The UNIX timestamp of the expected time when the rate limit will reset.
+         * @param values The values map.
+         */
+        public Builder(long limit, long remaining, long reset, Map<String, Object> values) {
+            this.limit = limit;
+            this.remaining = remaining;
+            this.reset = reset;
+            this.values = values;
+        }
+
+        /**
+         * Sets the client quota limit.
+         * @param clientQuotaLimit The client quota limit.
+         * @return The Builder instance.
+         */
+        public Builder clientQuotaLimit(TokenQuotaBucket clientQuotaLimit) {
+            this.clientQuotaLimit = clientQuotaLimit;
+            return this;
+        }
+
+        /**
+         * Sets the organization quota limit.
+         * @param organizationQuotaLimit The organization quota limit.
+         * @return The Builder instance.
+         */
+        public Builder organizationQuotaLimit(TokenQuotaBucket organizationQuotaLimit) {
+            this.organizationQuotaLimit = organizationQuotaLimit;
+            return this;
+        }
+
+        /**
+         * Sets the retry after time in seconds.
+         * @param retryAfter The retry after time in seconds.
+         * @return The Builder instance.
+         */
+        public Builder retryAfter(long retryAfter) {
+            this.retryAfter = retryAfter;
+            return this;
+        }
+
+        /**
+         * Sets the values map.
+         * @param values The values map.
+         * @return The Builder instance.
+         */
+        public Builder values(Map<String, Object> values) {
+            this.values = values;
+            return this;
+        }
+
+        public RateLimitException build() {
+            RateLimitException exception = (this.values != null)
+                ? new RateLimitException(this.limit, this.remaining, this.reset, this.values)
+                : new RateLimitException(this.limit, this.remaining, this.reset);
+
+            exception.clientQuotaLimit = this.clientQuotaLimit;
+            exception.organizationQuotaLimit = this.organizationQuotaLimit;
+            exception.retryAfter = this.retryAfter;
+
+            return exception;
+        }
+    }
+
 }