Skip to main content

Switch your browser used for sign-in

DigiCert ONE​​ Clients 1.9.0 and later uses your operating system (OS) default browser to sign in to DigiCert ONE, except in specific scenarios. Versions earlier than 1.9.0 use the in-app browser and can’t be configured to use your default browser.

Using your default browser lets you use browser features such as:

  • Password managers

  • One-time password (OTP) generators

  • Other browser-based authentication tools

Use this guide to learn how to configure version 1.9.0 or later to use the in-app browser instead of your default browser.

Before you begin

Ensure that you’re using DigiCert ONE Clients version 1.9.0 or later.

Switch to the in-app browser

The ability to switch your browser doesn’t appear in the app menu. If you prefer to use the in-app browser for sign in, you can configure this by editing the local configuration file.

  1. Open the config.json file on your computer:

    [Your HOME]\.digicert-ucpc\config.json
  2. In the backends section, add the following setting:

    Example:

    "dconeForceInAppSignin": true
    

    Astuce

    If you’re adding this setting after an existing property, make sure the previous line ends with a comma (,).

  3. Save the file.

  4. Restart the DigiCert ONE​​ Clients app.

Note

Note:

  • The .digicert-ucpc folder is hidden by default. If you can’t find it, enable the option to show hidden files and folders in your operating system.

  • Changes to config.json don’t take effect until DigiCert ONE Clients is restarted.

DigiCert ONE Clients version 1.9.0 uses your default OS browser.

To restore the default settings:

  1. Delete the config.json file:

    [Your HOME]\.digicert-ucpc\config.json
  2. Restart the DigiCert ONE​​ Clients app.

When DigiCert ONE Clients automatically uses the in-app browser

DigiCert ONE​​ Clients automatically opens the in-app browser in the following situations.

When your sign-in method uses client certificate authentication

If your sign-in method uses client certificate authentication, DigiCert ONE​​ Clients completes the sign-in process in the in-app browser.

Even if sign-in starts in your default browser, DigiCert ONE​​ Clients must establish its own authenticated session when you return to the application. Using the in-app browser provides a consistent sign-in experience and prevents you from being prompted to authenticate with your client certificate multiple times.

When you're using older Software Trust Manager client tools

DigiCert ONE​​ Clients uses the in-app browser when you're using a version of a Software Trust Manager client tool that doesn't support OAuth.

The following versions use the in-app browser:

Client tool

Version

SMCTL

Earlier than 1.65.0

PKCS11

Earlier than 1.65.0

KSP

Earlier than 1.65.0

CSP

Earlier than 1.65.0

Smartcard daemon (SCD)

Earlier than 1.7.0

OpenSSL provider

Earlier than 1.1.0

Notation plugin

Earlier than 1.1.0

DigiCert ONE​​ Clients detects whether the installed version of the client tool supports OAuth and switches browsers automatically. No manual configuration is required.

Known issue: Sign-in page stopped loading in Microsoft Edge

In rare cases, when Microsoft Edge is your operating system's default browser, the DigiCert ONE sign-in page may stop loading before sign in is complete.

To complete the sign-in process

  1. Refresh the DigiCert ONE sign-in page in Microsoft Edge.

  2. If the sign-in page still does not load, choose one of the following options:

    1. Set another browser, such as Google Chrome, as your operating system's default browser, and then restart the sign-in process from DigiCert ONE Clients.

    2. Configure DigiCert ONE Clients to use the in-app browser. See Switch to in-app browser.

  3. Sign in to DigiCert ONE.