Tips for finding Knowledge Articles

  • - Enter just a few key words related to your question or problem
  • - Add Key words to refine your search as necessary
  • - Do not use punctuation
  • - Search is not case sensitive
  • - Avoid non-descriptive filler words like "how", "the", "what", etc.
  • - If you do not find what you are looking for the first time,reduce the number of key words you enter and try searching again.
  • - Minimum supported Internet Explorer version is IE9
Home  >
article

KB-5440: How to use the Order box for advanced Centrify Browser Extension apps

Centrify Identity Service, App Edition ,  

12 April,16 at 11:14 AM

Applies to: Centrify Identity Service

Question:

In the advanced section of Custom Centrify Browser Extension app properties, there is a section called "Order" with the following info tag:
 
This optional field is for advanced users only.

Use this field to specify the order of login if it is not username, password and submit

How is this section used?


Answer:

The "Order" box is used for login pages where the username and password fields may need to be filled in a special order, or if the username and password forms are located on separate pages (e.g. The username is entered first, then a second page is loaded with the password box).

Syntax Examples:

The Order is constructed as a syntax of an array of commands:
  • Example 1:
    1. Load the login page.
    2. Fill in the username, password and additional login ID boxes (as defined in the app properties).
    3. Click the submit button, or simulate the "Enter" key (as defined in the app properties).
    • (This is the default setting)
[
["ups"]
]

 
  • Example 2:
    1. Load the login page.
    2. Fill in the username box.
    3. Click the button with the CSS selector value of "button#idOfNextPage".
    4. Wait for the next page to load.
    5. Fill in the password box on the second page.
    6. Click the submit button.
[
["fill", "username"], 
["click", "button#idOfNextPage"], 
["waitForNewPage"], 
["fill", "password"],
["submit"]
]

 
  • Example 3:
    1. Load the login page.
    2. Fill in the username box.
    3. Wait 0.5 seconds.
    4. Fill in the password box and simulate hitting the "Enter" key.
[
["fill", "username"], 
["sleep", 500], 
["fillEnter", "password"]
]

Notes:
  • The examples above have been indented for clarity, when entering them into the app configuration, they will be entered all on one line, e.g.:
    • [["fill", "username"], ["sleep", 500], ["fillEnter", "password"]]
  • If there are any special characters like ":" in the CSS selector sections in the Order field, they will need to be double-escaped by putting a double backslash "\\" in front of the characters. For example:
    • [["click", "input#idLoginForm\\:idLoginOption\\:1"],["waitForNewPage"],["fill", "username"],["fillEnter", "password"],["ups"]]
    • (If copying the selector ID from elements already detected by the CBE Infinite App Capture function, then there will already be one backslash in front special characters - these will still need the second backslash so that they get escaped twice in Order.)
  • For additional help on determining the CSS selector of an element in a web page, see the following KB:


Additional Commands:
 
Command EntryAction Performed
["click", "button#CSS_selector_id"]Do a mouse click on the element defined in the selector field.
["waitForNewPage"]Wait for the next page to finish loading
["goto", "http://www.centrify.com"]Go to the specified URL 
["ups "]
  1. Fill in the username and password boxes (and "Additional Login Field" box, if defined).
  2. Disable auto-complete of the form
  3. Click the submit button.
["sleep"]Wait for 80 milliseconds (default value)
["sleep", ###]Wait for the specified amount of time in milliseconds.
["fill", "field-name"]Fill in the defined box with the value defined in the app configuration. Accepted values of field-name are: (Case-sensitive)
  • username
  • password
  • corpId
These labels correspond to the "User Name", "Password" and "Additional Login Field" boxes (as captured in the Advanced section of the app properties).
["fillEnter", "field-name"]Same as "fill", only after entering the defined value, it will then simulate pressing the "Enter" key on the webpage.
["submit"]Disable auto-complete of the form and click the Submit button (as captured in the Advanced section of the app properties).
["waitForNewPage", {"httpStatus": "401"}]Wait for the next page(s) to load with the given HTTP status code. This is useful for pages with URL redirects.
["header401"]Fill HTTP BASIC/NTLM username password information when prompted.
 
For additional assistance with these configurations, please contact support@centrify.com and provide the following information:
  • URL of the login page.
  • Test credentials for logging into the target site (If possible)
  • An app export of the configured web app so far:
    1. Log into Cloud Manager > Apps
    2. Right-click on the target app being configured
    3. Select "Export" 
    4. Send in the exported zip file.

Still have questions? Click here to log a technical support case, or collaborate with your peers in Centrify's Online Community.