Introduction to SSL certificates introduction

Learn about the self-service tools Cloud Manager provides you to install and manage SSL (Secure Socket Layer) certificates.

What are SSL certificates? overview

Businesses and organizations use SSL (Secure Socket Layer) certificates to secure their websites and allow their customers to place trust in them. To use the SSL protocol, a web server requires an SSL certificate.

When an entity, such as an organization or business, requests a certificate from a Certificate Authority (CA), the CA completes a verification process. This process can range from verifying domain name control to collecting company registration documents and subscriber agreements. After an entity’s information is verified, the CA signs their public key using the CA’s private key. Because all major Certificate Authorities have root certificates in web browsers, the entity’s certificate is linked through a chain of trust, and the web browser recognizes it as a trusted certificate.

IMPORTANT
Cloud Manager does not provide SSL certificates or private keys. These parts must be obtained from a Certification Authority, a trusted third-party organization. Some well-known Certificate Authorities include DigiCert, Let’s Encrypt, GlobalSign, Entrust, and Verisign.

Manage certificates with Cloud Manager cloud-manager

Cloud Manager offers self-service tools to install and manage SSL certificates, ensuring site security for your users. Cloud Manager supports two models for managing your certificates.

Model
Description
A
Adobe managed SSL certificate (DV)
Cloud Manager lets users configure DV (Domain Validation) certificates that that are provided by Adobe for quick domain setup.
B
Customer managed SSL certificate (OV/EV)
Cloud Manager offers a platform TLS (Transport Layer Security) service to let you manage OV and EV SSL certificates that you own and private keys from third-party Certificate Authorities, such as Let’s Encrypt.

Both models offer the following general features for managing your certificates:

  • Each Cloud Manager environment can use multiple certificates.
  • A private key may issue multiple SSL certificates.
  • The platform TLS service routes requests to the customer’s CDN service based on the SSL certificate used to terminate and the CDN service that hosts that domain.
IMPORTANT
To add and associate a custom domain with an environment, you must have a valid SSL certificate that covers the domain.

Adobe managed (DV) SSL certificates adobe-managed

DV certificates are the most basic level of SSL certification and are often used for testing purposes or for securing websites with basic encryption. DV certificates are available in both production programs and sandbox programs.

After the DV certificate is created, Adobe renews it automatically every three months, unless it is deleted.

Customer managed OV/EV SSL certificates customer-managed

OV and EV certificates offer CA-validated information. Such information helps users assess whether the website owner, email sender, or digital signatory of code or PDF documents can be trusted. DV certificates do not allow such ownership verification.

OV and EV additionally offer these features over DV certificates in Cloud Manager.

  • Multiple environments can use an OV/EV certificate. That is, it can be added once, but used multiple times.
  • Each OV/EV certificate typically contains multiple domains.
  • Cloud Manager accepts wildcard OV/EV certificates for a domain.
TIP
If you have multiple custom domains, you may not want to upload a certificate each time you add a new domain. In that case, you could benefit from obtaining a single certificate that covers multiple domains.
NOTE
If two certificates cover the same domain are installed, the one that is more exact is applied.
For example, if your domain is dev.adobe.com and you have one certificate for *.adobe.com and another for dev.adobe.com, the more specific one (dev.adobe.com) is used.

Requirements for customer managed OV/EV SSL certificates requirements

If you choose to add your own customer managed OV/EV SSL certificate, it must meet the following requirements:

  • AEM as a Cloud Service accepts certificates that conform with OV (Organization Validation) or EV (Extended Validation) policy.
    • Cloud Manager does not support adding your own DV (Domain Validation) certificates.
  • Any certificate must be an X.509 TLS certificate from a trusted Certificate Authority with a matching 2048-bit RSA private key.
  • Self-signed certificates are not accepted.

Format for customer managed certificates certificate-format

SSL certificate files must be in PEM format to be installed with Cloud Manager. Common file extensions of the PEM format include .pem,. crt, .cer, and .cert.

The following openssl commands can be used to convert non-PEM certificates.

  • Convert PFX to PEM

    code language-shell
    openssl pkcs12 -in certificate.pfx -out certificate.cer -nodes
    
  • Convert P7B to PEM

    code language-shell
    openssl pkcs7 -print_certs -in certificate.p7b -out certificate.cer
    
  • Convert DER to PEM

    code language-shell
    openssl x509 -inform der -in certificate.cer -out certificate.pem
    
TIP
Adobe recommends that you validate the integrity of your certificate locally using a tool such as openssl verify -untrusted intermediate.pem certificate.pem before attempting to install it using Cloud Manager.

Limitation on number of installed SSL certificates limitations

At any given time, Cloud Manager allows a maximum of 50 installed SSL certificates. These certificates can be associated with one or more environments across your program and also include any expired certificates.

If you have reached the limit, review your certificates and consider deleting any expired certificates. Or, group multiple domains in the same certificate since a certificate can cover multiple domains (up to 100 SANs).

Learn more learn-more

A user with the necessary permissions can use Cloud Manager to manage SSL certificates for a program. See the following documents for more details on using these features.

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab