Add password driver for the gandi.net mail API

plugins/password/README

@@ -53,6 +53,7 @@
  2.1.27. dovecot_passwdfile
  2.1.28. Mailcow
  2.1.29. LDAP Samba Active Directory (ldap_samba_ad)
+ 2.1.30. gandi (gandi.net mail-API)
  2.2.    Password Strength Drivers
  2.2.1.  Zxcvbn
  2.2.2.  Have I been pwned? (pwned)
@@ -427,6 +428,21 @@
  Uses configuration for other LDAP drivers.
 
 
+ 2.1.30. gandi
+ ---------------------------
+
+ Driver to change the user's password via gandi.net mail-API. A password driver is also
+ included that checks the password strength according to the official gandi.net documentation.
+ See https://api.gandi.net/docs/email/ for more information.
+
+ In order to work, the following configuration options must be set appropriately:
+ Password driver:
+    * password_username_format = %u
+    * password_algorithm = sha512-crypt
+ Password strength driver:
+    * password_minimum_score = 2
+
+
  2.2. Password Strength Drivers
  ------------------------------
 

plugins/password/config.inc.php.dist

@@ -513,3 +513,20 @@ $config['password_dovecot_passwdfile_path'] = '/etc/mail/imap.passwd';
 // ----------------------
 $config['password_mailcow_api_host'] = 'localhost';
 $config['password_mailcow_api_token'] = '';
+
+
+// GANDI-API Driver options
+// ------------------------
+// The domain-to-personal-access-token/domain-to-api-key configuration required for authentication.
+// This can take various forms depending on your needs.
+//     (1) The raw Personal-Access-Token/API-key or an array containing the key-value mapping.
+//         $config['password_gandi_keys'] = 'your-personal-access-token-or-api-key';
+//         $config['password_gandi_keys'] = array(
+//             'example.com' => 'first-personal-access-token-or-api-key',
+//             'foo.com' => 'second-personal-access-token-or-api-key',
+//         );
+//     (2) The absolute path to a file containing either the raw Personal-Access-Token/API-key or a key-value mapping in JSON format.
+//         $config['password_gandi_keys'] = '/absolute/path/to/somewhere';
+//
+// Note: For security reasons, it is recommended to use the second option.
+$config['password_gandi_keys'] = null;