Requirements and Authentication for Selenium Web Checks

Requirements for Selenium Web Checks

• To record a browser transaction, you need one of the following:
  • Selenium IDE Firefox
    For more information, see Selenium IDE from Firefox Browser Add-ons.
  • Standalone Selenium IDE Extension
    For more information, see 4.0.1-beta.14 Assets from SeleniumHQ.
• Manage permissions for all listed resources in the Resource Tab.
• Access permission to the Synthetics Monitoring for adding the new synthetic web test.
• An active collector should be configured with the grid URL.

Authentication for Selenium Web Checks

You can add authentication to your Synthetics Web Checks with the following actions:

• Parameterizing the appropriate credentials inside the Selenium .side file
  This can be accomplished after you record your browser transaction by modifying the .side file with the appropriate authentication.
• Specifying the credentials when uploading the Web check to LogicMonitor
  You can specify the credentials in a step of the Synthetics Website Test wizard in your LogicMonitor portal

Credentials consist of a username and password if you are using multi-factor authentication (MFA) token. LogicMonitor leverages the existing variable substitution in Selenium IDE to securely inject your authentication information.

Recording a Browser Transaction

Follow the Getting Started instructions from Selenium to record a browser transaction.

When complete, save your .side file in a location you can access for uploading to LogicMonitor.

Adding Authentication to the Browser Recording

To add authentication, you must parameterize the credentials in the Selenium .side file by replacing each instance of username, password, and token with the appropriate variable substitution.

Variables can be substituted in Selenium IDE text fields by surrounding a variable name with ${}. For example, to substitute the value of the variable myVar into the condition of an if statement would look similar to the following:
${myVar} === "a".

For more information, see Selenium’s Conditional Branching documentation.

LogicMonitor uses the following special variables to substitute your credentials username, password, and token respectively:

• credential.username 
• credential.password
• credential.token

Downloading the SIDE file

You can download the SIDE file used for your Synthetics Web Check.

1. In LogicMonitor, navigate to Resources > select Synthetics resource.
2. Select (Manage Resource Options) . 
3. Select Download SIDE file.