: Add Let's Encrypt (ACMEv2)
Focus
Focus

Add Let's Encrypt (ACMEv2)

Table of Contents

Add Let's Encrypt (ACMEv2)

Before You Begin

You're going to need a few things to complete the CA configuration.

DNS Provider Details

The Let's Encrypt CA in Next-Gen Trust Security uses DNS Certificate Authority Authorization (CAA). Next-Gen Trust Security supports the following DNS providers. Review the section for your DNS provider to see what information Next-Gen Trust Security requires.

AWS Route 53

The account you use must have read, create, update, delete, and save permission.
  • Access Key ID
  • Secret Access Key
  • Hosted Zone ID

Azure

The account you use must have read, create, update, delete, and save permission.
  • Subscription ID
  • Resource Group
  • Client Secret
  • Client ID
  • Tenant ID
Note: For additional information on Azure DNS requirements, refer to Reference: Azure DNS.

Cloudflare

  • For email and global API Key authentication type:
    • Account email
    • Global API Key
  • For DNS and zone tokens authentication type:
    • Edit zone API token
    • Read zone API token

F5 Distributed Cloud Services

The API Token that is created for use with Next-Gen Trust Security on F5 Distributed Cloud should be in the same namespace where the DNS is hosted.
The DNS account you use must have read, write, update, and delete permissions for the API token.
  • API Token
  • Group Name
  • XC Tenant Shortname

Google Cloud

The account you use must have read, create, update, delete, and save permission.
  • Service account JSON file
Note: For additional information on Google Cloud DNS requirements, refer to Reference: Google Cloud DNS.
VSatellite
All ACMEv2 CAs require a VSatellite. If you already have a VSatellite installed, it will be available for you to select during configuration.
If not, you'll be able to set up a VSatellite during configuration. Just be sure to have a machine ready that meets the system requirements before you start.

To Set up the CA

Step 1: Set up the Connection

  1. Sign in to Next-Gen Trust Security.
  2. Click Configuration > Certificate Authorities.
  3. Click New > Let's Encrypt (ACMEv2).
  4. Enter a Name for this CA as it should appear in Next-Gen Trust Security.
  5. From the Server URL drop-down, select either the production or staging URL.
    Note: These URLs are provided by Let's Encrypt and can't be changed. The Custom ACMEv2 CA in Next-Gen Trust Security allows you to enter custom server URLs if needed.
  6. Select a VSatellite. If you don’t have one deployed yet, click Deploy a VSatellite, and follow the steps to deploy a new VSatellite.
    To take advantage of high availability for certificate issuance and management, select a primary VSatellite that belongs to a high availability group. The system will automatically choose a healthy VSatellite from that group to initiate operations. This helps ensure reliability even if one VSatellite becomes temporarily unavailable.
  7. Click Test Connection.
  8. After the connection is successful, click Next.

Step 2: Enter Additional Information

  1. Enter the Email address of the person or team responsible for certificates issued by this CA.
  2. Review and agree to the Terms and Conditions.
  3. Click Next.

Step 3: Enter DNS Provider Details

  1. From the DNS Provider drop-down, select a DNS provider.
  2. Complete the credential fields for your provider.
  3. Click Test Connection.
  4. Click Done.
After completing the configuration, you're returned to the Certificate Authorities page.

What's Next

This CA is now ready to be added to one or more certificate issuing templates. To do this, select this CA when creating certificate issuing templates.