New prop for DatabaseUsers, mysql_settings, used to specify auth_plugin (#79)

Also new method to reset user's authentication

Author: nicholi

DigitalOcean.API.Tests/Clients/DatabasesClientTest.cs

@@ -200,6 +200,18 @@ public void CorrectRequestForRemoveUser() {
             factory.Received().ExecuteRaw("databases/{id}/users/{name}", parameters, null, Method.DELETE);
         }
 
+        [Fact]
+        public void CorrectRequestForResetUserAuth() {
+            var factory = Substitute.For<IConnection>();
+            var client = new DatabasesClient(factory);
+
+            var body = new Models.Requests.DatabaseResetUserAuth();
+            client.ResetUserAuth("1", "name", body);
+
+            var parameters = Arg.Is<List<Parameter>>(list => (string)list[0].Value == "1" && (string)list[1].Value == "name");
+            factory.Received().ExecuteRequest<DatabaseUser>("databases/{id}/users/{username}/reset_auth", parameters, body, "user", Method.POST);
+        }
+
         [Fact]
         public void CorrectRequestForAddDatabase() {
             var factory = Substitute.For<IConnection>();

DigitalOcean.API/Clients/DatabasesClient.cs

@@ -256,6 +256,18 @@ public Task RemoveUser(string databaseId, string username) {
             return _connection.ExecuteRaw("databases/{id}/users/{name}", parameters, null, Method.DELETE);
         }
 
+        /// <summary>
+        /// To reset the MySQL authentication method for a user.
+        /// Note: Resetting user authentication is not supported for PostgreSQL and Redis clusters.
+        /// </summary>
+        public Task<DatabaseUser> ResetUserAuth(string databaseId, string username, Models.Requests.DatabaseResetUserAuth resetAuth) {
+            var parameters = new List<Parameter> {
+                new Parameter("id", databaseId, ParameterType.UrlSegment),
+                new Parameter("username", username, ParameterType.UrlSegment)
+            };
+            return _connection.ExecuteRequest<DatabaseUser>("databases/{id}/users/{username}/reset_auth", parameters, resetAuth, "user", Method.POST);
+        }
+
         /// <summary>
         /// Resize a database cluster
         /// </summary>

DigitalOcean.API/Clients/IDatabasesClient.cs

@@ -94,6 +94,12 @@ public interface IDatabasesClient {
         /// </summary>
         Task RemoveUser(string databaseId, string username);
 
+        /// <summary>
+        /// To reset the MySQL authentication method for a user.
+        /// Note: Resetting user authentication is not supported for PostgreSQL and Redis clusters.
+        /// </summary>
+        Task<DatabaseUser> ResetUserAuth(string databaseId, string username, Models.Requests.DatabaseResetUserAuth resetAuth);
+
         /// <summary>
         /// Add a new database to an existing cluster
         /// </summary>

DigitalOcean.API/Models/Requests/DatabaseResetUserAuth.cs

@@ -0,0 +1,11 @@
+using Newtonsoft.Json;
+
+namespace DigitalOcean.API.Models.Requests {
+    public class DatabaseResetUserAuth {
+        /// <summary>
+        /// An object containing additional configuration details for MySQL cluster users.
+        /// </summary>
+        [JsonProperty("mysql_settings")]
+        public MySqlSettings MySqlSettings { get; set; }
+    }
+}

DigitalOcean.API/Models/Requests/DatabaseUser.cs

@@ -7,5 +7,11 @@ public class DatabaseUser {
         /// </summary>
         [JsonProperty("name")]
         public string Name { get; set; }
+
+        /// <summary>
+        /// An object containing additional configuration details for MySQL clusters.
+        /// </summary>
+        [JsonProperty("mysql_settings")]
+        public MySqlSettings MySqlSettings { get; set; }
     }
 }

DigitalOcean.API/Models/Requests/MySqlSettings.cs

@@ -0,0 +1,14 @@
+using Newtonsoft.Json;
+
+namespace DigitalOcean.API.Models.Requests {
+    public class MySqlSettings {
+        /// <summary>
+        /// A string specifying the authentication method to be used for connections to the MySQL user account.
+        /// The valid values are "mysql_native_password" or "caching_sha2_password".
+        /// If excluded when creating a new user, the default for the version of MySQL in use will be used.
+        /// As of MySQL 8.0, the default is "caching_sha2_password."
+        /// </summary>
+        [JsonProperty("auth_plugin")]
+        public string AuthPlugin { get; set; }
+    }
+}

DigitalOcean.API/Models/Responses/DatabaseUser.cs

@@ -1,3 +1,5 @@
+using Newtonsoft.Json;
+
 namespace DigitalOcean.API.Models.Responses {
     public class DatabaseUser {
         /// <summary>
@@ -14,5 +16,11 @@ public class DatabaseUser {
         /// A randomly generated password for the database user.
         /// </summary>
         public string Password { get; set; }
+
+        /// <summary>
+        /// An object containing additional configuration details for MySQL clusters.
+        /// </summary>
+        [JsonProperty("mysql_settings")]
+        public MySqlSettings MySqlSettings { get; set; }
     }
 }

DigitalOcean.API/Models/Responses/MySqlSettings.cs

@@ -0,0 +1,12 @@
+using Newtonsoft.Json;
+
+namespace DigitalOcean.API.Models.Responses {
+    public class MySqlSettings {
+        /// <summary>
+        /// A string specifying the authentication method in use for connections to the MySQL user account.
+        /// The valid values are "mysql_native_password" or "caching_sha2_password".
+        /// </summary>
+        [JsonProperty("auth_plugin")]
+        public string AuthPlugin { get; set; }
+    }
+}