zerossl/cli-client

Create certificates and CSRs locally and easy in the CLI using newest PHP OpenSSL features and ZeroSSL for signing.

v0.6.2 2022-06-08 13:29 UTC

Requires

• php: >=8.1
• ext-curl: *
• ext-openssl: *

GPL-3.0-or-later

• David Stöckl

README

Get signed and valid SSL certificates, create CSRs and the corresponding private keys directly from the command line in usually less than a minute. Easy, secure, fast.

Beta notice

This software is in an early beta stage, feedback is being gathered. Although most things should work there might be unexpected errors or problems. Please report any bugs you may encounter or even better create an MR to fix them.

Use cases

• Downloader: Download ZeroSSL certificates and convert them to any required format (e.g. .der, .pem, .p12, .pfx)
• Generator: Automate the creation of a huge amount of certificates with the ZeroSSL API (can be used as a library / standalone toolkit)
• Generator: Everything except for certificate creation and domain validation will happen in your local system
• Generator: Can be used as a free tool for CSR creation
• Generator: Can be used as a free tool for self-signed certificate creation

How to get an API key for creating valid SSL certificates signed by ZeroSSL

1. Go to: https://zerossl.com/
2. Create a free account
3. Within your dashboard navigate to developer and get your API key
4. Now you can create valid SSL certificates with ZeroSSL

Requirements

• PHP 8.1 or higher
• PHP OpenSSL extension (https://www.php.net/manual/en/book.openssl.php)
• PHP CURL extension (https://www.php.net/manual/de/book.curl.php)
• Optional: Composer (PHP dependency manager, only needed for development, used for autoloading, https://getcomposer.org/)

Components

• Generator: Get a signed SSL certificate in the command line from scratch in less than a minute
• Downloader: Download ZeroSSL certificates in any format which might be required
• CSR Tool: Advanced tool for CSR generation (under construction)
• Certificate Converter: Certificate format conversion tool (under construction)

Errors

The script will display native PHP errors with the stack trace in case something goes wrong. In order to understand what is not working check the first line of the error output. Most likely you will have a ConfigurationException, which means you have to adjust your input.

Usage as a library

Note: This is not yet completely ready, be free to make MRs for improvement.

Including in custom PHP scripts

Create an options object: $options = new ZeroSSL\CliClient\Dto\Options()

Run: $certificateData = RequestProcessor::generate($options,true);

Have a look at the RequestProcessor objects for the functions you need to achieve what you actually want.