Handling Salesforce Passkeys with ACCELQ Passkey Helper

This guide explains how to create and manage Salesforce passkeys for ACCELQ automation. For generic setup, Helper controls, CLI modes, and merge behavior, see ACCELQ Passkey Helper CLI modes.

A passkey is a secure and convenient way to sign in without typing a password. It can use a familiar verification method such as a fingerprint, face, device PIN, or security key.

ACCELQ Passkey Helper opens a controlled Chrome browser to capture passkeys and save them to the local ACCELQ Agent or prepare them for transfer to another machine.

Reference: Handling Passkeys in ACCELQ

Before you begin

• Install and configure the ACCELQ Agent on the machine that will use the passkey.
• Download and extract ACCELQ Passkey Helper. Contact ACCELQ Support for the setup link.
• Ensure you have stopped the ACCELQ Agent. This is to ensure that no runs happen on the target machine while we are trying to create passkey with the ACCELQ agent.
• Confirm that the Salesforce user is permitted to create and manage passkeys.
• Go through the documentation about how to work with ACCELQ Passkey Helper from this article before continuing with this article:
  Handling Passkeys in ACCELQ

Choose your Salesforce passkey scenario

Select the workflow that matches the current location of the Salesforce user's existing passkey.

• Case 1 : Create a Passkey for Salesforce in the ACCELQ Agent
  The Salesforce user does not have an existing passkey and you need to create the first passkey for the ACCELQ Agent on the current machine.
• Case 2: Create a Salesforce Passkey Using a saved Passkey in Password Manager Vault/Plugin
  The Salesforce user has an existing passkey in a password-manager vault(Chrome plugin), but the ACCELQ Agent on the current machine does not have its own passkey.
• Case 3: Capture a New Salesforce Passkey for Export to Another Machine
  The ACCELQ Agent on the current machine already has the Salesforce passkey and you need to create and transfer a new passkey to another machine.

Operational reminders

• Use Verify identity mode only when Salesforce requests an existing passkey.
• Switch to Capture mode before selecting Add Passkey in Salesforce.
• Use Add to Agent when the passkey is required on the current machine.
• Use Save for Export / Import when the passkey must be transferred to another machine.
• Select Close browser after confirming that the passkey was saved.
• For general Helper behavior and CLI reference, see ACCELQ Passkey Helper CLI modes.

Transfer the passkey to another machine

1. On the current machine, export the saved passkey.

   macOS or Linux

./run.sh export-saved

Windows

run.bat export-saved

2. Confirm that the exported cache is available in the auth_cache folder.
3. Download and extract ACCELQ Passkey Helper on the target machine where the other ACCELQ Agent is installed.
4. Copy the complete auth_cache folder to the ACCELQ Passkey Helper setup directory on the target machine.

5. Import the passkey into the ACCELQ Agent on the target machine.

   macOS or Linux

./run.sh import

Windows

run.bat import

The passkey is now available to the ACCELQ Agent on the target machine for ACCELQ automation.