Capture a New Salesforce Passkey for Export to Another Machine

Use this flow when the ACCELQ Agent on the current machine already contains a passkey for the Salesforce user and you need to create a separate passkey for an ACCELQ Agent on another machine.

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 a 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.

Step 2: Log in to Salesforce using the existing Agent passkey

Load the Salesforce URL in the controlled Chrome browser.

Turn on the toggle in the top-right corner of ACCELQ Passkey Helper and select Verify identity mode.

Enter the Salesforce username and click Log In. Salesforce then prompts you to authenticate using the saved passkey. Because the passkey is stored in the ACCELQ Agent and Verify identity mode is selected, ACCELQ Passkey Helper automatically supplies the passkey and completes the login.

Confirm that you have successfully signed in to Salesforce.

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 Add Passkey, Salesforce may ask you to verify your identity again using the previously registered passkey. Confirm that Verify identity mode remains selected in ACCELQ Passkey Helper.

If Salesforce requests the existing passkey, ACCELQ Passkey Helper automatically uses the passkey stored in the ACCELQ Agent to authenticate the user. After authentication succeeds, Salesforce redirects you to the Create a Passkey page.

Step 4: Switch to Capture mode

Before creating the new passkey, switch ACCELQ Passkey Helper from Verify identity mode to Capture mode.

Step 5: Create the passkey and save it for transfer

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.

Because the captured passkey is intended for another machine, click Save for Export / Import. The passkey is stored in the Helper’s saved folder and is not added to the ACCELQ Agent on the current machine.
 

Step 6: Close the controlled browser

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

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.