/ 
StartCom-API-0.2
River stage zero No dependents
/ StartAPI

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>