Added rotate key endpoint for connections

Author: tanya732

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

@@ -4,6 +4,7 @@
 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;
@@ -425,9 +426,12 @@ public Request<Void> updateEnabledClients(String connectionId, List<EnabledClien
     }
 
     /**
-     *
+     * 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<ConnectionKeys> getKeys(String connectionId) {
+    public Request<List<ConnectionKeys>> getKeys(String connectionId) {
         Asserts.assertNotNull(connectionId, "connection id");
 
         String url = baseUrl
@@ -437,8 +441,26 @@ public Request<ConnectionKeys> getKeys(String connectionId) {
                 .addPathSegment("keys")
                 .build()
                 .toString();
-        return new BaseRequest<>(client, tokenProvider, url, HttpMethod.GET, new TypeReference<ConnectionKeys>() {
+        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/json/mgmt/connections/ConnectionKeys.java

@@ -1,12 +1,9 @@
 package com.auth0.json.mgmt.connections;
 
-import com.fasterxml.jackson.annotation.JsonFormat;
 import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
 import com.fasterxml.jackson.annotation.JsonInclude;
 import com.fasterxml.jackson.annotation.JsonProperty;
 
-import java.util.Date;
-
 @JsonIgnoreProperties(ignoreUnknown = true)
 @JsonInclude(JsonInclude.Include.NON_NULL)
 public class ConnectionKeys {
@@ -37,97 +34,184 @@ public class ConnectionKeys {
     @JsonProperty("current")
     private Boolean current;
 
-    @JsonFormat(shape = JsonFormat.Shape.STRING)
     @JsonProperty("current_since")
-    private Date currentSince;
+    private String currentSince;
 
     @JsonProperty("next")
     private Boolean next;
 
+    /**
+     * Getter for the Key ID (kid).
+     * @return the Key ID (kid).
+     */
     public String getKid() {
         return kid;
     }
 
+    /**
+     * Setter for the Key ID (kid).
+     * @param kid the Key ID (kid).
+     */
     public void setKid(String kid) {
         this.kid = kid;
     }
 
+    /**
+     * Getter for the algorithm used by the key.
+     * @return the algorithm used by the key.
+     */
     public String getAlgorithm() {
         return algorithm;
     }
 
+    /**
+     * Setter for the algorithm used by the key.
+     * @param algorithm the algorithm used by the key.
+     */
     public void setAlgorithm(String algorithm) {
         this.algorithm = algorithm;
     }
 
+    /**
+     * Getter for the key use (e.g., "sig" for signature).
+     * @return the key use.
+     */
     public String getKeyUse() {
         return keyUse;
     }
 
+    /**
+     * Setter for the key use.
+     * @param keyUse the key use (e.g., "sig" for signature).
+     */
     public void setKeyUse(String keyUse) {
         this.keyUse = keyUse;
     }
 
+    /**
+     * Getter for the subject distinguished name (DN).
+     * @return the subject DN.
+     */
     public String getSubjectDn() {
         return subjectDn;
     }
 
+    /**
+     * Setter for the subject distinguished name (DN).
+     * @param subjectDn the subject DN.
+     */
     public void setSubjectDn(String subjectDn) {
         this.subjectDn = subjectDn;
     }
 
+    /**
+     * Getter for the certificate associated with the key.
+     * @return the certificate.
+     */
     public String getCert() {
         return cert;
     }
 
+    /**
+     * Setter for the certificate associated with the key.
+     * @param cert the certificate.
+     */
     public void setCert(String cert) {
         this.cert = cert;
     }
 
+    /**
+     * Getter for the fingerprint of the key.
+     * @return the fingerprint.
+     */
     public String getFingerprint() {
         return fingerprint;
     }
 
+    /**
+     * Setter for the fingerprint of the key.
+     * @param fingerprint the fingerprint.
+     */
     public void setFingerprint(String fingerprint) {
         this.fingerprint = fingerprint;
     }
 
+    /**
+     * Getter for the thumbprint of the key.
+     * @return the thumbprint.
+     */
     public String getThumbprint() {
         return thumbprint;
     }
 
+    /**
+     * Setter for the thumbprint of the key.
+     * @param thumbprint the thumbprint.
+     */
     public void setThumbprint(String thumbprint) {
         this.thumbprint = thumbprint;
     }
 
+    /**
+     * Getter for the PKCS#8 representation of the key.
+     * @return the PKCS#8 representation.
+     */
     public String getPkcs() {
         return pkcs;
     }
 
+    /**
+     * Setter for the PKCS#8 representation of the key.
+     * @param pkcs the PKCS#8 representation.
+     */
     public void setPkcs(String pkcs) {
         this.pkcs = pkcs;
     }
 
+    /**
+     * Getter for whether the key is currently active.
+     * @return true if the key is current, false otherwise.
+     */
     public Boolean getCurrent() {
         return current;
     }
 
+    /**
+     * Setter for whether the key is currently active.
+     * @param current true if the key is current, false otherwise.
+     */
     public void setCurrent(Boolean current) {
         this.current = current;
     }
 
-    public Date getCurrentSince() {
+    /**
+     * Getter for the timestamp when the key became current.
+     * @return the timestamp in ISO 8601 format.
+     */
+    public String getCurrentSince() {
         return currentSince;
     }
 
-    public void setCurrentSince(Date currentSince) {
+    /**
+     * Setter for the timestamp when the key became current.
+     * @param currentSince the timestamp in ISO 8601 format.
+     */
+    public void setCurrentSince(String currentSince) {
         this.currentSince = currentSince;
     }
 
+    /**
+     * Getter for whether there is a next key available.
+     * @return true if there is a next key, false otherwise.
+     */
     public Boolean getNext() {
         return next;
     }
 
+    /**
+     * Setter for whether there is a next key available.
+     * @param next true if there is a next key, false otherwise.
+     */
     public void setNext(Boolean next) {
         this.next = next;
     }

src/main/java/com/auth0/json/mgmt/connections/RotateKey.java

@@ -0,0 +1,46 @@
+package com.auth0.json.mgmt.connections;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonInclude;
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+@JsonIgnoreProperties(ignoreUnknown = true)
+@JsonInclude(JsonInclude.Include.NON_NULL)
+public class RotateKey {
+    @JsonProperty("cert")
+    private String cert;
+    @JsonProperty("kid")
+    private String kid;
+
+    /**
+     * Returns the certificate used for the key rotation.
+     * @return the certificate as a String.
+     */
+    public String getCert() {
+        return cert;
+    }
+
+    /**
+     * Sets the certificate used for the key rotation.
+     * @param cert the certificate as a String.
+     */
+    public void setCert(String cert) {
+        this.cert = cert;
+    }
+
+    /**
+     * Returns the Key ID (kid) of the key being rotated.
+     * @return the Key ID as a String.
+     */
+    public String getKid() {
+        return kid;
+    }
+
+    /**
+     * Sets the Key ID (kid) of the key being rotated.
+     * @param kid the Key ID as a String.
+     */
+    public void setKid(String kid) {
+        this.kid = kid;
+    }
+}

src/test/java/com/auth0/client/MockServer.java

@@ -50,6 +50,8 @@ public class MockServer {
     public static final String MGMT_CONNECTION_SCIM_TOKENS = "src/test/resources/mgmt/connection_scim_tokens.json";
     public static final String MGMT_CONNECTION_SCIM_TOKEN = "src/test/resources/mgmt/connection_scim_token.json";
     public static final String MGMT_ENABLED_CLIENTS_FOR_CONNECTION = "src/test/resources/mgmt/enabled_clients_for_connection.json";
+    public static final String MGMT_CONNECTION_KEY = "src/test/resources/mgmt/connection_key.json";
+    public static final String MGMT_ROTATE_KEY = "src/test/resources/mgmt/rotate_key.json";
     public static final String MGMT_DEVICE_CREDENTIALS_LIST = "src/test/resources/mgmt/device_credentials_list.json";
     public static final String MGMT_DEVICE_CREDENTIALS = "src/test/resources/mgmt/device_credentials.json";
     public static final String MGMT_GRANTS_LIST = "src/test/resources/mgmt/grants_list.json";