This project is just a simple script to simplify installing new Acme.SH certificates into ISPconfig using their SoapServer.
Requirements:
- php7+ with soap and openssl module enabled
- git (preffered), curl or wget ( to download the project )
- acme.sh
- ISPConfig
- Any code editor you are comfortable with
Installation
- Git clone or download the project onto your server (
git clone https://github.com/Aperture-Development/ISPConfig-AcmeSH.git <output path>
) - Open the
acmesh_ispconfig.php
file and edit the top part with your environment data ( look below to see how to setup ISPConfig ) - Save and close the file
ISPConfig setup
- Log into ISPConfig
- Select "System" > "Remote Users" and "Add new user"
- Create a new remote user with the permissions "Server functions", "Sites Domain functions", "Sites Aliasdomain functions", "Sites Subdomain functions" and "Client functions"
If you do not want to specify your ISPConfig username or password inside the file, you can use the --username
and --password
parameters to use temporary environment variables.
Basic Usage:
acmesh_ispconfig.php -d <domain> [-d <domain>...]
Advanced Parameters:
Usage: acmesh_ispconfig.php [OPTIONS]
Options:
-d, --domain DOMAIN pass DOMAIN to be updated ( required )
-h, --help display this help message and exit ( optional )
-s, --service provide services to be reloaded after the certificate has been updated ( optional )
-u, --username the ISPConfig API username ( optional )
-p, --password the ISPConfig API password ( optional )
-l, --uri the ISPConfig remote URI ( optional )
-r, --reloadcmd the reload cmd to be used to restart services ( optional )
Automatically run the script after renewing a certificate:
When you issue the certificate you need to provide the --renew-hook
parameter to run the php script after your certificate has been sucessfully renewed.
Example parameter: acme.sh --issue -d example.com --renew-hook "/path/to/script/acmesh_ispconfig.php -d example.com -s dovecot -s postfix"
More informations can be found here: https://github.com/acmesh-official/acme.sh/wiki/Using-pre-hook-post-hook-renew-hook-reloadcmd
This project has been developed by Aperture Development and is licenced under by-sa 4.0.
You can find more informations about the licence terms inside the LICENSE file