oneuptime/oneuptime-gl-manager/README.md
2021-11-28 10:31:17 +01:00

1.4 KiB

oneuptime-gl-manager

Manages SSL Certificate issuance and renewal for Greenlock on OneUptime platform.

Saves global and per-site config to a local File Sytem (current).

Install

npm install --save oneuptime-gl-manager

Usage

Initialize the Manager

Greenlock.create({
    ...
    manager: "oneuptime-gl-manager",
    configDir: "./greenlock.d",
    packageRoot: __dirname
    ...
});

Site Management

By "site" we mean a primary domain and, optionally, secondary domains, to be listed on an ssl certificate, along with any configuration that is necessary for getting and renewing those certificates.

Add a sites - domains and SSL certificates

greenlock.add({
    subject: 'example.com',
    altnames: ['example.com', 'www.example.com'],
});

View site config

greenlock.get({
    servername: 'www.example.com',
    wildname: '*.example.com',
});

Update site config

greenlock.update({
    subject: 'www.example.com',
    challenges: {
        'dns-01': {
            module: 'acme-dns-01-ovh',
            token: 'xxxx',
        },
    },
});

Remove a site

To stop automatic renewal of SSL certificates for a particular site. You to restart renewal you must use add().

greenlock.remove({
    subject: 'example.com',
});