Capture a New Salesforce Passkey for Export to Another Machine – ACCELQ

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.

Note: If the other machine where this new passkey is required has a graphical user interface (UI), we recommend launching AQ Passkey Helper on that machine and using the Add to Agent option to create and save the passkey directly to the target ACCELQ Agent instead of exporting and importing it manually.

Refer to Create a Passkey for Salesforce in the ACCELQ Agent for the direct passkey creation workflow.

Use the export/import workflow described in this article only when the passkey cannot be created and added directly to the target ACCELQ Agent, such as when the Agent is installed on a Linux machine without a graphical user interface (UI).

To learn about the other supported Salesforce passkey workflows, see Choose your Salesforce passkey scenario.

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

To transfer the captured passkey to the target machine, follow the instructions in the Transfer the passkey to another machine section of the article below:
Handling Salesforce Passkeys with ACCELQ Passkey Helper