Step-by-step instructions

Step 1: In the lower left-hand section of Automation, 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: There is a Connection Type drop-down menu within the Basic Settings. The choices include:

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

Step 4: The drop-down menu directly to the right will populate sub-categories based on what you selected. For example, if you select Salesforce as the Connection Type, you will be prompted to select Normal, 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 Automation.) 

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 must verify that the three xpath instructions are correct. To verify that the xpath instructions are correct for the connection you create (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 matches the xpath instructions in the java file.

Step 9: Again, open the Connections tab within Automation 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 connections you created within the Connections tab. Click the first connection 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.