Custom TLS certificates with a VIP CSR
A certificate signing request (CSR) from VIP can be generated in order to obtain a custom certificate from a Certificate Authority (CA). A CSR generated by VIP contains the necessary information, plus VIP’s authorization, that the CA needs to process a TLS certificate.
Prerequisite
- Installing a TLS certificate for a domain in the VIP Dashboard requires a user to have at minimum an Org member role or an App write role for that application.
- In order to successfully install a generated custom TLS certificate, it must meet all of the requirements.
Access the custom certificate installer
- Navigate to the VIP Dashboard.
- Select the environment that the domain points to (e.g., Production, Develop) from the dropdown located at the upper left of the dashboard.
- Select “Domains & Certs” from the sidebar navigation at the left of the screen.
- Add the domain by selecting the “Add Domain” button in the upper right if it does not yet appear in the Domains list.
- A button labeled “Install Certificate” will be displayed to the right of newly added domains in the Domains panel.
- Select the “Install Certificate” button to access and select the “Custom Certificate” option in the dropdown.

Generate a Certificate Signing Request (CSR)
- Select the “Create New CSR” tab.
- Complete the requested information for each field and select “Generate CSR“.

Create your certificate
Copy or download the generated CSR and provide the CSR to a Certificate Authority.

Upload your certificate
Once the Certificate Authority has generated and provided a certificate and a chain of trusted certificates, resume the installation process.
- Navigate to the VIP Dashboard.
- Select “Domains & Certs” from the sidebar navigation at the left of the screen.
- A button labeled “Install Certificate” will be displayed to the right of newly added domains in the Domains panel.
- Select the “Install Certificate” button to access and select the “Custom Certificate” option in the dropdown.
- Choose one of the following methods to add the certificates to the form fields:
- Copy and paste the contents of the certificates into each form field (Certificate and Trusted Certificate(s)).
- If all parts of the complete certificate chain are contained in a single PEM file, select the linked text “Select a PEM file” to upload the file source from the local machine.
- Select “Continue“.
- Follow the instructions to “Activate a custom certificate” found below.

Activate a custom certificate
The installation of a TLS certificate is not complete until it has been activated for a domain.
Choose your domains
After uploading a certificate chain:
- Click on the dropdown below the “Domains” label.
- Select the domain for which the new custom TLS certificate is being installed.
- Select “Activate Certificates“.

Confirm the certificate is working
- New TLS certificates may require up to 10 minutes to be enabled for a domain.
- Use a free online TLS testing tool such as SSLShopper or DigiCert.
- Browsers such as Firefox and Chrome provide tools for checking if a site’s connection is secure.
Last updated: October 04, 2023