Testim Documentation

Welcome to the Testim documentation. You'll find comprehensive guides to help you get started quickly, example code snippets, and tips for being more productive. You will also find details about advanced features that allow you to customize Testim to fit your environment or special testing conditions. Don't worry, we'll support you if you get stuck. Let's jump right in!

Guides    Changelog

Salesforce Auto-Login Step

📘

This is a Testim for Salesforce feature

To learn more about Testim for Salesforce, see here.

The Salesforce auto-login step allows the test to login to the Salesforce environment (or sandbox) without the need to record login or logout steps. After you add the login step and enter the details of the environment you are testing, you can start recording your test.

📘

If your Salesforce environment is protected with 2-factor authentication, you will need your organization’s Salesforce administrator to whitelist the IP for the machine from which you are running your tests in order for the auto login step to pass.

MFA Authentication

As of Feb 1 2022 Salesforce announced it will enforce multifactor authentication (MFA) when logging in to their environment. To support automatic login using MFA, Testim has implemented a software-based authenticator that will perform MFA when the Salesforce Auto-login step is executed. To enable this feature, follow the instructions in the Setting up MFA section below.

Adding a Salesforce Auto-Login Step

To add a Salesforce auto-login step:

  1. Hover over the (arrow symbol) where you want to add the step.

The action items are displayed.

  1. Click on the “M” (Testim predefined steps).
    The Predefined steps menu opens.
  1. Click on Salesforce.
    The Salesforce menu expands.
  1. Scroll down through the menu and select Salesforce auto-login.

📘

Alternatively, you can use the search box at the top of the menu to search for Salesforce auto-login.

The Add Step window is shown.

  1. In the Name the new step field, enter a (meaningful) name for this step.
  2. If this is a shared step to be made available to reuse in this or other tests, keep the box next to Shared step selected (default), and choose a folder from the Select shared step folder list where you want this step stored. Otherwise, deselect the checkbox.
    For more information about shared steps, see Groups.
  3. Click Create Step.
  4. Hover over the step and click on the Show Properties () icon. The step is added in the Editor, and the Properties panel opens on the right-hand side.
  1. In the Login URL field, enter the login of your Salesforce environment.
  2. In the Username and Password fields, enter your login credentials.
  3. If you need to use MFA, follow the steps in the Setting up MFA section).
    The Salesforce auto-login step is configured.

Using parameters

You can use parameters which were defined in the test or suite level, in the config file, or in another step to enter your connection properties for your Salesforce environment.

📘

When using MFA, the value of the MFA secret key cannot be used as a parameter.

To use parameters to enter your connection properties:

  1. Define parameters in one of the following ways:
  2. In your Salesforce auto-login step, add the parameters to the URL, Username, and Password fields.

Setting up MFA

The setup process requires obtaining the secret key from Salesforce and entering the key into the Secret Key field in the Properties panel in Testim.
To setup MFA:

  1. Login to Salesforce and Navigate to Setup > Users > Users > and select the user for which you want to set up MFA.
  1. If you have already registered a 3rd party Authenticator app (Google Authenticator, Microsoft Authenticator etc.) under App Registration: One-Time Password Authenticator, you will need to disconnect it and then reconnect in order to obtain the secret key.
    • Under User Details, in the App Registration - One-Time Password Authenticator setting, click Disconnect.
    • If you have never registered a 3rd party Authenticator App, proceed to the next step.
  1. Under User Details, in the App Registration - One-Time Password Authenticator setting, click Connect.
  1. Login into Salesforce with your user name and password, when prompted with the following notice, select Choose another verification method.
  1. In the Choose a verification method screen, select Use verification codes from an authenticator app and click Continue.
  1. In the Connect an authenticator app screen, click I cant scan the QR code.
  1. A secret key is displayed. Copy the secret key.
  1. When adding the Salesforce Auto-Login step (see - Adding a Salesforce Login Step, in the step's Properties Panel, under Login with MFA, click the ADD KEY button.
  1. Paste the key that you have copied from Salesforce into the Your Key field and click Add.

A verification code is displayed:

  1. Go back to Salesforce and enter the verification code that was displayed into the Verification Code and click Connect.

Updated 3 months ago

Salesforce Auto-Login Step


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.