Test the Integration between Salesforce and BeyondTrust Remote Support

 

You must purchase this integration separately from both your BeyondTrust software and your Salesforce solution. For more information, contact BeyondTrust sales.

The following steps take place in Salesforce.com and BeyondTrust and are provided to ensure that the integration works properly. Troubleshooting suggestions are provided with each step in case of failure.

Test Session Key Generation

Generate Session Key

  1. Log into the BeyondTrust representative console, and then log into Salesforce.com with the same account. If BeyondTrust and Salesforce.com use different authentication systems, manually assign your BeyondTrust user to your Salesforce.com user via the User Layout in Salesforce.com.
  2. Open a case in Salesforce.com.
  3. To test client-side session key generation, click the BeyondTrust Session Key button. This should launch the BeyondTrust representative console, subsequently opening the session key dialog box.
  4. To test server-side session key generation, click the Generate Session Key button. This should launch a window within Salesforce.com that displays the session key information. In case of failure, make sure the following are true:
    1. The Salesforce.com user account is mapped to a BeyondTrust user account as described in this guide.
    2. The Salesforce.com API user connection test completes successfully.
    3. The BeyondTrust Hostname, Username, and Password fields are set correctly in Salesforce.com under Configuration.

Test BeyondTrust Session Import

BeyondTrust Session Import

  1. Log into Salesforce.com as an ITIL user or an admin. Use the BeyondTrust Session Key or Generate Session Key button as described above to start a BeyondTrust session.
  2. End the session from the representative console and close any surveys and/or session end messages on the representative and/or customer sides of the session.
  3. Refresh the Salesforce.com case from which the session key was generated, scroll down, and check the BeyondTrust Sessions list. There should be an entry for the recent session. If not, make sure the following are true:
    1. The API user connection test completes successfully.
    2. There are no BeyondTrust errors reported for your Salesforce.com instance in the BeyondTrust /login > Management > Outbound Events list.
    3. Make sure no errors are shown in Salesforce.com under the Error Logs tab, which can be seen when the BeyondTrust Integration tab is selected.

Test Session Key Generation (for Lightning UX only)

Generate Session Key

  1. Log into the BeyondTrust representative console, and then log into Salesforce.com with the same account. If BeyondTrust and Salesforce.com use different authentication systems, manually assign your BeyondTrust user to your Salesforce.com user via the user layout in Salesforce.com
  2. Ensuring that you are in the Salesforce Lightning UX, open a case in Salesforce.com.
  3. Click the Session Key tab. You should see the Session Key, the Session Key URL, and the Email Session Key button.
  4. Additionally, you should see a Generate Session Key button that can be used to generate a session key (client-side) with the BeyondTrust representative console.
  5. Click the Generate Session Key button. This should launch the BeyondTrust representative console, subsequently opening the session key dialog box.