cdist-type__uacme_account(7)

NAME

cdist-type__uacme_account - Install uacme and register Let’s Encrypt account.

DESCRIPTION

This type is used to bootstrap acquiring certificates from the Let’s Encrypt C.A by creating an account and accepting terms of use. The cdist-type__uacme_obtain(7) type instances expect to depend on this type.

OPTIONAL PARAMETERS

confdir

An alternative configuration directory for uacme’s private keys and certificates.

admin-mail

Administrative contact email to register the account with.

acme-url

ACMEv2 server directory object URL. Lets’Encrypt is used by default.

eab-credentials

Specify RFC8555 External Account Binding credentials according to https://tools.ietf.org/html/rfc8555#section-7.3.4, in order to associate a new ACME account with an existing account in a non-ACME system such as a CA customer database. KEYID must be an ASCII string. KEY must be base64url-encoded. This is parameter is not supported by uacme < 1.6.

EXAMPLES

# Create account with default settings for the OS.
__uacme_account

# Create an account with email and custom location.
__uacme_account --confdir /opt/custom/uacme --admin-mail admin@domain.tld

SEE ALSO

cdist-type__letsencrypt_cert(7) cdist-type__uacme_obtain(7)

AUTHORS

Joachim Desroches <joachim.desroches@epfl.ch> Timothée Floure <timothee.floure@posteo.net>

COPYING

Copyright (C) 2020 Joachim Desroches. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.