cert-manager/docs/reference/issuers/acme/http01.rst
2018-07-25 11:30:53 +01:00

35 lines
997 B
ReStructuredText

=========================
HTTP01 Challenge Provider
=========================
In order to allow HTTP01 challenges to be solved, we must enable the HTTP01
challenge provider on our Issuer resource.
This is done through setting the ``http01`` field on the ``issuer.spec.acme``
stanza. Cert-manager will then attempt to solve ACME HTTP-01 challenges by
using Ingress resources
.. code-block:: yaml
:linenos:
:emphasize-lines: 7, 11
apiVersion: certmanager.k8s.io/v1alpha1
kind: Issuer
metadata:
name: example-issuer
spec:
acme:
email: user@example.com
server: https://acme-staging-v02.api.letsencrypt.org/directory
privateKeySecretRef:
name: example-issuer-account-key
http01: {}
.. note::
Let's Encrypt does not support issuing wildcard certificates with HTTP-01 challenges.
To issue wildcard certificates, you must use the DNS-01 challenge.
.. todo::
Write a full description of how HTTP01 challenge validation works