OpenText product name changes coming to the community soon! Learn more.

Wikis - Page

Using Access Manager Connectors for SecureLogin Application Definitions

2 Likes

ISSUE:

Access Manager provides a Connector catalog that includes the BasicSSO form matching which is comparable with SecureLogin scripting. However, the catalogue is not directly usable within SecureLogin.
An alternate to the SecureLogin wizard could be the conversion from the Connector catalog to SecureLogin application definitions.

HOW TO STEPS:

  1. Download the chosen Access Manager Connector zip from the  Connector catalog
  2. Extract the ConnectorDefinition xml (IAMConnectorDefinition|NCSSConnectorDefinition)
  3. Translate the xml to SecureLogin Script definition
    • Using XSL transform from attached ScriptTransform.zip,  or
    • Following steps
      1. Take the App ID from ncss/connectorDefinition/basicSSOConnectorDefinition/loginLocationList/loginLocation[platform='DESKTOP_BROWSER']/url

      2. Take the App Name from ncss/connectorDefinition/targetApplication/name

      3. For each ncss/connectorDefinition/basicSSOConnectorDefinition/formTemplateList/formTemplate

        1. Create a Site form matching section

          Site "Login"
          EndSite
          
        2. Fill out Form matching details from formTemplate/formSelectionCriteria such as formName or when there is no form -noform

          Site "Login"
            MatchForm #1 -name "form" -id ""
          EndSite
          
          Site "Login"
            MatchForm #1 -NoForm
          EndSite
          
        3. Create field matching section
          For each 
          formTemplate/inputFieldDefinitionList/inputFieldDefinition[dataType='STRING'] include a MatchField entry and use the provided name as either a name or id.

          Site "Login"
            MatchForm #1 ...
            MatchField #1:1 -name "username"
            MatchField #1:2 -id "password"
          EndSite
          
        4. Create other matching rules Create a MatchElement for formTemplate/formSubmitOptions/actionSelectionCriteria to enable automated form submit

        MatchElement #1:0 -selector "login,.login,[name='login']"

        1. Create field filling section For each formTemplate/inputFieldDefinitionList/inputFieldDefinition[dataType='STRING'] include a TextInput entry and optionally set prompt text

          EndSite
          
          SetPrompt "Username or email"
          TextInput #1:1 $username
          SetPrompt "Password"
          TextInput #1:2 $password
          
        2. Include submitting the form If there was an element to match with actionSelectionCriteria then ClickElement #1:0 Otherwise generic page submit might be achieved with either PressInput or Submit

Example Trello, https://trello.com/login

Site "Login"
	MatchForm #1 -Id "login-form"
	MatchField #1:1 -Id "password"
	MatchField #1:2 -Id "user"
	MatchElement #1:0 -selector "#login"
EndSite
	 
SetPrompt password
TextInput #1:1 $password 
SetPrompt user
TextInput #1:2 $user
	
ClickElement #1:0
EndScript

 

Labels:

How To-Best Practice
Comment List
Related
Recommended