How to configure a single sign-on connection

Step-by-step instructions

Step 1: In the lower left-hand section of Provar, click the Test Settings tab. Several sub-tabs will appear such as Connections, Mobile Apps, Browser Providers, etc. Open the Connections sub-tab and click the plus sign to create a new connection.

Step 2: Enter a Connection Name.

Step 3: Within the Basic Settings, there is a Connection Type drop down menu. The choices include:

• Database
• Messaging
• Google
• Microsoft
• Generic Web Service
• Salesforce
• UI Testing
• Single Sign-On (SSO)

Step 4: Based on what you selected, the drop down menu directly to the right will populate sub-categories. For example, if you select Salesforce as the Connection Type, you will be prompted to select Normal Salesforce Connection, Salesforce Communities Connection or Salesforce Portal Connection.

Step 5: Enter your Username and Password for the selected Connection Type. For example, if you selected Salesforce, you should enter your existing single-sign on Username and Password for Salesforce. Click OK.

Step 6: Open a new internet browser and navigate to the website homepage associated with the SSO connection you are creating. (For example, https://login.salesforce.com.)

Step 7: Import the SSOFile.java provided here and place it within the src > pageobjects folder. (Hint: The src folder is located within the Navigator tab of Provar.) 

package pageobjects;

import java.util.Map;
import java.util.concurrent.TimeUnit;

import org.openqa.selenium.By;
import org.openqa.selenium.ElementNotVisibleException;
import org.openqa.selenium.JavascriptExecutor;
import org.openqa.selenium.WebDriver;

import com.provar.core.model.base.api.IRuntimeConfiguration;
import com.provar.core.testapi.ILoginPage;
import com.provar.core.testapi.ILoginResult;
import com.provar.core.testapi.SfLoginResult;
import com.provar.core.testapi.annotations.Page;

@Page(title = "SSO Login Page", connection = "SSO")
public class SSOFile implements ILoginPage {

  @Override
  public ILoginResult doLogin(IRuntimeConfiguration runtimeConfiguration, WebDriver driver,
      Map<String, String> credentials) {

    // Get the user name and password.
    String userName = credentials.get(CREDENTIAL_USER);
    String password = credentials.get(CREDENTIAL_PASSWORD);

    // Submit the SSO form.
    driver.findElement(By.xpath("//input[@id='username']")).sendKeys(userName);
    driver.findElement(By.xpath("//input[@id='password']")).sendKeys(password);
    driver.findElement(By.xpath("//input[@id='Login']")).click();

    try {
      Thread.sleep(5000);
    } catch (InterruptedException e) {
      e.printStackTrace();
    }

    String currentUrl = driver.getCurrentUrl();
    int lightningPos = currentUrl.indexOf(".lightning.force.com");
    if (lightningPos > 0) {

      JavascriptExecutor jsExec = (JavascriptExecutor) driver;

      String classicUrl = currentUrl.substring(0, lightningPos) + ".my.salesforce.com/provardisco";
      String script = "window.open('" + classicUrl + "', 'provardisco')";
      jsExec.executeScript(script);
      try {
        Thread.sleep(5000);
      } catch (InterruptedException e) {
        e.printStackTrace();
      }
      driver.switchTo().window("provardisco");
    }

    // Return the result.
    return new SfLoginResult(true, null, driver);
  }

}

Step 8: You may need to make a few edits to this file. Within the // Submit the SSO form section of the syntax, you will need to verify that the three xpath instructions are correct. To verify that the xpath instructions are correct for the connection you are creating (e.g. Salesforce), toggle back to login.salesforce.com. Place your cursor on the Username field and right-click to select Inspect.

When inspected, the Username field is associated with id=’username’, the Password field is associated with id=’password’ and the Login button is associated with id=’login’ which match the xpath instructions in the java file.

Step 9: Open the Connections tab within Provar once again and click the plus sign to create a new connection. Enter the Connection Name (e.g. SSO) and select Single Sign-on (SSO) and Generic SSO (Page Object-based).

Step 10: Enter the Base URL, such as https://login.salesforce.com. Within the Page Object field, enter pageobjects.SSOFile. Check Debug. Click OK. You should now see both of the connections that you created within the Connections tab. Click the first connection that you created, TestAdmin and click the edit button (which is to the right of the create a new connection tab.)

Step 11: Open the Advanced Settings. Within the Sign-On Connection drop down menu, select SSO. Click OK.

Hey, you’re done!