|
|
|
@ -50,25 +50,20 @@ options:
|
|
|
|
description:
|
|
|
|
description:
|
|
|
|
- "The email address associated with this account."
|
|
|
|
- "The email address associated with this account."
|
|
|
|
- "It will be used for certificate expiration warnings."
|
|
|
|
- "It will be used for certificate expiration warnings."
|
|
|
|
required: false
|
|
|
|
|
|
|
|
default: null
|
|
|
|
|
|
|
|
acme_directory:
|
|
|
|
acme_directory:
|
|
|
|
description:
|
|
|
|
description:
|
|
|
|
- "The ACME directory to use. This is the entry point URL to access
|
|
|
|
- "The ACME directory to use. This is the entry point URL to access
|
|
|
|
CA server API."
|
|
|
|
CA server API."
|
|
|
|
- "For safety reasons the default is set to the Let's Encrypt staging server.
|
|
|
|
- "For safety reasons the default is set to the Let's Encrypt staging server.
|
|
|
|
This will create technically correct, but untrusted certificates."
|
|
|
|
This will create technically correct, but untrusted certificates."
|
|
|
|
required: false
|
|
|
|
|
|
|
|
default: https://acme-staging.api.letsencrypt.org/directory
|
|
|
|
default: https://acme-staging.api.letsencrypt.org/directory
|
|
|
|
agreement:
|
|
|
|
agreement:
|
|
|
|
description:
|
|
|
|
description:
|
|
|
|
- "URI to a terms of service document you agree to when using the
|
|
|
|
- "URI to a terms of service document you agree to when using the
|
|
|
|
ACME service at C(acme_directory)."
|
|
|
|
ACME service at C(acme_directory)."
|
|
|
|
required: false
|
|
|
|
|
|
|
|
default: 'https://letsencrypt.org/documents/LE-SA-v1.1.1-August-1-2016.pdf'
|
|
|
|
default: 'https://letsencrypt.org/documents/LE-SA-v1.1.1-August-1-2016.pdf'
|
|
|
|
challenge:
|
|
|
|
challenge:
|
|
|
|
description: The challenge to be performed.
|
|
|
|
description: The challenge to be performed.
|
|
|
|
required: false
|
|
|
|
|
|
|
|
choices: [ 'http-01', 'dns-01', 'tls-sni-02']
|
|
|
|
choices: [ 'http-01', 'dns-01', 'tls-sni-02']
|
|
|
|
default: 'http-01'
|
|
|
|
default: 'http-01'
|
|
|
|
csr:
|
|
|
|
csr:
|
|
|
|
@ -85,24 +80,20 @@ options:
|
|
|
|
- "The data to validate ongoing challenges."
|
|
|
|
- "The data to validate ongoing challenges."
|
|
|
|
- "The value that must be used here will be provided by a previous use
|
|
|
|
- "The value that must be used here will be provided by a previous use
|
|
|
|
of this module."
|
|
|
|
of this module."
|
|
|
|
required: false
|
|
|
|
|
|
|
|
default: null
|
|
|
|
|
|
|
|
dest:
|
|
|
|
dest:
|
|
|
|
description: The destination file for the certificate.
|
|
|
|
description: The destination file for the certificate.
|
|
|
|
required: true
|
|
|
|
required: true
|
|
|
|
aliases: ['cert']
|
|
|
|
aliases: ['cert']
|
|
|
|
fullchain:
|
|
|
|
fullchain:
|
|
|
|
description: Include the full certificate chain in the destination file.
|
|
|
|
description: Include the full certificate chain in the destination file.
|
|
|
|
required: false
|
|
|
|
|
|
|
|
default: false
|
|
|
|
default: false
|
|
|
|
version_added: 2.4
|
|
|
|
version_added: 2.5
|
|
|
|
remaining_days:
|
|
|
|
remaining_days:
|
|
|
|
description:
|
|
|
|
description:
|
|
|
|
- "The number of days the certificate must have left being valid.
|
|
|
|
- "The number of days the certificate must have left being valid.
|
|
|
|
If C(cert_days < remaining_days), then it will be renewed.
|
|
|
|
If C(cert_days < remaining_days), then it will be renewed.
|
|
|
|
If the certificate is not renewed, module return values will not
|
|
|
|
If the certificate is not renewed, module return values will not
|
|
|
|
include C(challenge_data)."
|
|
|
|
include C(challenge_data)."
|
|
|
|
required: false
|
|
|
|
|
|
|
|
default: 10
|
|
|
|
default: 10
|
|
|
|
'''
|
|
|
|
'''
|
|
|
|
|
|
|
|
|
|
|
|
|