Test using PFX certificates

You can upload and install .pfx (Personal Information Exchange) certificates on BrowserStack Live to test websites and workflows that require client-certificate authentication.

Use cases

Testing with .pfx certificates is useful in scenarios such as:

• Testing websites that require a valid client certificate for authentication.
• Verifying workflows that depend on certificate-based access.
• Conducting compatibility checks for advisory portals that require authentication.
• Ensuring that certificate installation works across different operating systems and browsers.

Supported operating systems and browsers

The following operating systems and browsers support .pfx certificates:

Important considerations

• You can upload up to five .pfx certificates in a single test session.
• Uploaded certificates persist across test sessions, but you must install them each time you start a new test session.
• BrowserStack Live stores uploaded certificates securely and retains them for 30 days from the upload date.
• You cannot uninstall or delete installed certificates during an ongoing test session. You must restart the session to delete them.
• You can delete uploaded certificates that are not installed in an ongoing test session.

Upload .pfx certificates

You must first upload a certificate to BrowserStack to use it in a test session. You can upload up to five certificates in a single session.

To upload a .pfx certificate:

1. Log in to the Live dashboard.
2. On the Live dashboard, select the OS version and browser to start your test session. For supported OS and browser combinations, refer to the supported operating systems and browsers section.
3. In the Live vertical toolbar, click Settings.
4. In the Settings prompt, click Configuration profiles.
   The Configuration profiles prompt appears.
5. In the Configuration profiles prompt, click Upload certificates.
6. From your local machine, select the .pfx certificate that you want to upload.
   The certificate is uploaded and appears in the Configuration profiles prompt.
   

Install .pfx certificates

Once uploaded, you can install the .pfx certificates during a test session. For information on how to upload certificates, see Upload .pfx certificates.

To install a .pfx certificate:

1. Log in to the Live dashboard.
2. On the Live dashboard, select the OS version and browser to start your test session. For supported OS and browser combinations, refer to the supported operating systems and browsers section.
3. In the Live vertical toolbar, click Settings.
   
4. In the Settings prompt, click Configuration profiles.
   
5. In the Configuration profiles prompt, click Install next to the certificate you want to install.
   
6. Enter the password associated with the .pfx certificate.
   
7. Click Install.
   A banner appears confirming that the certificate is installed for the current session and the certificate status in the Configuration profiles prompt changes to Installed.
   

Delete .pfx certificates

You can delete any uploaded certificate that has not been installed during an ongoing test session. To delete an installed certificate, restart the session and then follow these steps.

To delete an uninstalled .pfx certificate:

1. Log in to the Live dashboard.
2. On the Live dashboard, select the OS version and browser to start your test session. For supported OS and browser combinations, refer to the supported operating systems and browsers section.
3. In the Live vertical toolbar, click Settings.
   
4. In the Settings prompt, click Configuration profiles.
   
5. In the Configuration profiles prompt, click the trash can icon (🗑️) next to the certificate you want to delete.
   
   A banner confirms that the certificate is deleted, and it is removed from the list of uploaded certificates.