Add change-password-mailcow driver

plugins/change-password-mailcow/driver.php

@@ -0,0 +1,74 @@
+<?php
+
+class ChangePasswordMailcowDriver
+{
+    const
+        NAME        = 'Mailcow',
+        DESCRIPTION = 'Driver to change the email account password on Mailcow.';
+
+    private $sHostName = '';
+    private $sApiToken = '';
+
+    /**
+     * @var \MailSo\Log\Logger
+     */
+    private $oLogger = null;
+
+    function __construct(\RainLoop\Config\Plugin $oConfig, \MailSo\Log\Logger $oLogger)
+    {
+        $this->oLogger = $oLogger;
+        $this->sHostName = $oConfig->Get('plugin', 'mailcow_api_hostname', '');
+        $this->sApiToken = $oConfig->Get('plugin', 'mailcow_api_token', '');
+    }
+
+    public static function isSupported() : bool
+    {
+        return true;
+    }
+
+    public static function configMapping() : array
+    {
+        return array(
+            \RainLoop\Plugins\Property::NewInstance('mailcow_api_hostname')
+                ->SetLabel('Mailcow API hostname'),
+            \RainLoop\Plugins\Property::NewInstance('mailcow_api_token')
+                ->SetLabel('API token')
+                ->SetDescription('The Read/Write API token'),
+        );
+    }
+
+    public function ChangePassword(\RainLoop\Model\Account $oAccount, string $sPrevPassword, string $sNewPassword) : bool
+    {
+        $url = 'https://'.$this->sHostName.'/api/v1/edit/mailbox';
+        $headers = [
+            'content-type' => 'application/json',
+            'accept' => 'application/json',
+            'X-API-Key' => $this->sApiToken,
+        ];
+        $body = array(
+            'items' => [ $oAccount->Email() ],
+            'attr' => [
+                'password' => (string)$sNewPassword,
+                'password2' => (string)$sNewPassword,
+            ],
+        );
+
+        $ch = curl_init($url);
+        $payload = json_encode($body);
+        curl_setopt($ch, CURLOPT_POST, 1);
+        curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
+        curl_setopt($ch, CURLOPT_HTTPHEADER, array_map(function($k, $v) {return "$k: $v";}, array_keys($headers), $headers));
+        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
+        $result = curl_exec($ch);
+        curl_close($ch);
+
+        $status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
+
+        if ($status === 200 && $result && ($res = json_decode($result, true)) && $res[0]['type'] === 'success') {
+            return true;
+        }
+
+        $this->oLogger->Write("Mailcow[Error]: Response: {$status} {$result}");
+        return false;
+    }
+}

plugins/change-password-mailcow/index.php

@@ -0,0 +1,18 @@
+<?php
+
+class ChangePasswordMailcowPlugin extends \RainLoop\Plugins\AbstractPlugin
+{
+    const
+        NAME     = 'Change Password Mailcow',
+        AUTHOR   = 'Cuttlefish',
+        VERSION  = '2.36',
+        RELEASE  = '2024-07-25',
+        REQUIRED = '2.36.0',
+        CATEGORY = 'Security',
+        DESCRIPTION = 'Extension to allow users to change their passwords through Mailcow';
+
+    public function Supported() : string
+    {
+        return 'Use Change Password plugin';
+    }
+}