Create a Passkey for Salesforce in the ACCELQ Agent – ACCELQ

This article explains how to create and capture the first Salesforce passkey for an ACCELQ Agent using ACCELQ Passkey Helper.

Use this article when the Salesforce user does not have a registered passkey and the ACCELQ Agent on the current machine requires a passkey for automation.

To learn about the other supported Salesforce passkey workflows, see Handling Salesforce Passkeys with ACCELQ Passkey Helper.

For a detailed overview of ACCELQ Passkey Helper, including its modes and CLI options, see ACCELQ Passkey Helper CLI modes.

Step 1: Start ACCELQ Passkey Helper

Open Command Prompt or Terminal in the extracted ACCELQ Passkey Helper directory and run the command for your operating system.

macOS or Linux

./run.sh browser

Windows

run.bat browser

ACCELQ Passkey Helper opens a controlled Chrome browser. Load the Salesforce URL in the controlled browser.

Step 2: Log in to Salesforce in the controlled browser

During login, you may be asked to verify your identity using email, Salesforce Authenticator, or another configured method. Complete the required steps to sign in to Salesforce manually.

Step 3: Initiate a request to add a new passkey for the Salesforce user

Navigate to Profile icon → Settings.

Search for “Passkeys” in the Quick Find box. Click the “Add Passkey” button.

After you click the “Add Passkey” button, Salesforce may ask you to authenticate again using an existing configured method to complete two-factor authentication (2FA), such as an email OTP or a Salesforce Authenticator push notification. Complete the authentication.

After completing authentication, you are redirected to the “Create a Passkey” page.

Step 4: Enable ACCELQ Passkey Helper and select Capture mode

Turn on the toggle in the top-right corner of ACCELQ Passkey Helper and select “Capture mode”

Step 5: Create the passkey and add save the captured passkey

With Capture mode selected, ACCELQ Passkey Helper handles the passkey-creation request from Salesforce.

Click the “Create Passkey” button in Salesforce.

Salesforce displays the newly registered passkey with a timestamp.

To make the captured passkey available for ACCELQ automation on the current machine, click Add to Agent. The passkey is stored in the ACCELQ Agent and is available for automation runs on that machine.

Step 6: Close the controlled browser

Click “Close browser” to close the controlled browser safely.

Step 7: Close the controlled browser

Click “Close browser” to close the controlled browser safely.

Enable passkey authentication during ACCELQ automation

After saving the application’s passkey in the ACCELQ Agent, to use a passkey stored in the ACCELQ Agent during an automated run:

Configure the Login Action

Use Invoke Browser to open the application URL.
Immediately after it, add Enable Virtual Authentication on Web Browser.
Include the Login Action in the Scenario setup for each applicable test case.

Command behavior

The Enable Virtual Authentication on Web Browser command:

Enables virtual authentication for all browsers that are already open and any browser opened later in the same test case.
Automatically restores passkeys and security-key sign-ins stored in the ACCELQ Agent, allowing registered sign-ins to be reused across runs.