Manage Windows web certificates
Under Assets and Setup > Admin > Web Certificates, cloud admins can view and manage Windows web certificates, also known as SSL/TLS certificates, for desktop web devices. Web certificates are digital files that ensure the identity and security of a website, secure the online communication between a client and a server, and help establish trust between users and servers.
The Web Certificates tab displays a table that lists details for the uploaded certificates, including file name, certificate authority, description, and whether the certificate is auto-installed.
The top left corner shows the number of certificates displayed in the table. Above the table, a toolbar provides access to common actions: Edit, Delete, and Download certificate. You can also search for specific certificates.
To learn how to access the Web Certificates view and how to upload, edit, delete, and download a certificate, watch this video or review the instructions following the video.
Click a task to view its steps.
-
On the Perfecto landing page, under Assets & Setup, click ACCOUNT SETUP.
-
In the Assets and Setup view, click Admin.
By default, the Admin view opens on the Users tab.
-
Click the Web Certificates tab.
-
At the bottom right, click the upload icon .
-
In the Open dialog box, browse to the file you want to upload, select it, and click Open.
The following file types are supported: .crt, .cer, .pem
-
In the Upload certificate dialog box, do the following:
-
From the Store name list, select the Certificate Authority (CA) that issued the certificate:
-
CA: Certificate store for intermediate certificate authorities (CAs)
-
My: Certificate store for personal certificates
-
Root: Certificate store for trusted root certificate authorities (CAs)
-
-
If you want to enable automatic installation for this certificate, turn on the Auto install option.
When this option is enabled, Perfecto automatically installs the certificate on any Windows desktop web device you open. When this option is turned off, you can install certificates as part of your automation tests.
-
Enter a Description.
-
Click UPLOAD.
-
-
In the toolbar above the table, click Edit.
-
In the Edit certificate dialog box, do any of the following:
-
Change the store name.
-
Turn the auto-install option on or off.
-
Modify the description.
-
Click SAVE.
-
-
In the toolbar above the table, click Delete.
-
In the Delete certificate dialog box, to confirm your action, click YES.
-
In the table, select a certificate.
-
On the toolbar above the table, click Download.
-
Follow the prompts in your browser.
To install web certificates that are not installed automatically, add the installCertificates capability to your automation tests, as shown in the following code snippet.
DesiredCapabilities capabilities = new DesiredCapabilities();
capabilities.setCapability("installCertificates", List.of("c1.pem","c2.crt"));
To learn more, see Web machine configuration capabilities.
Error codes
When working with web certificates, you may encounter the following error codes.
Error code | Message | Solution |
---|---|---|
180 |
The value of the capability: INSTALL_CERTIFICATES should be set to a list of strings. | Update the capability value in your automation test to be a list of strings. |
181 |
Failed to start session - WFA-500-0181 - At least one of the certificates referenced in the request does not exist. | One or more certificates are missing. If they are not listed in the Web Certificates view, upload them. |
182 |
Failed to install certificates. | This is a generic error. Try again. If the installation continues to fail, contact Perfecto Support. |