The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

NAME

StartAPI - apply for and retrieve ssl certificates from StartCom

VERSION

0.1

SYNOPSIS

 StartAPI <apply|retrieve> [OPTIONS]

OPTIONS

--clientcert CCERT

Mandatory. Sets the path to the client certificate file.

--clientkey CKEY

Mandatory. Sets the path to the client key file.

--tokenID TOKEN

Mandatory. Sets the API token.

--orderid ID

Mandatory when retrieving certificate. Selects the order id of the certificate.

--csr CSR

Mandatory when applying for a certificate. Sets the path to the csr file.

--domain DOMAIN

Mandatory when applying for a certificate. Sets the domain name. Can be set multiple times.

--type TYPE

Optional. Sets the certificate type (DVSSL, IVSSL, OVSSL or EVSSL). Defaults to DVSSL.

--output FILE

Optional. Saves the certificate + intermediate to FILE. If not set, the certificates will be sent to STDOUT.

DESCRIPTION

Applies for or retrieves ssl certificates from StartCom.

EXAMPLES

apply for a new certificate

 $ h=test.yourdomain.example

 $ openssl req -new -newkey rsa:4096 -nodes \
     -keyout ${h}.key -out ${h}.csr -subj "/CN=${h}"
 $ StartAPI apply -c ccert.pem -k ccert.key -i tk_123456789 \
     --csr ${h}.csr -d ${h} -o ${h}.pem

retrieve certificate

 $ StartAPI retrieve -c ccert.pem -k ccert.key -i tk_123456789 \
     --orderid 11111111-2222-3333-4444-555555555555

DEPENDENCIES

AUTHOR

Philippe Kueck <projects at unixadm dot org>