Customizing login for mobile devices

Customize the login procedure for the Connections Mobile app.

About this task

If additional information needs to be displayed, or if additional authentication challenges must be presented to the mobile user during login, different steps are performed.

Procedure

  1. If a disclaimer or terms of usage needs to be displayed when a user logs in, but you do not need to record whether or not the user reads it or accepts it, then the TermsOfUsageURL setting can be used. The value of TermsOfUsageURL should point to a static HTML page. When TermsOfUsageURL is set, the Connections Mobile app displays the web page pointed to by the URL during login. When the web page is displayed, the app provides the user with options to either cancel or continue the login.
    1. Check out the mobile-config.xml file for editing. For more information about checking out the file, see the Changing Mobile configuration property values topic.
    2. Open the mobile-config.xml file in a text editor. Find the SecuritySettings section and set enabled to true.
    3. Locate the Security properties section and set enabled to true.
    4. In the TermsOfUsageURL property, specify the URL of the static HTML page to display when the user logs in.
      Note: The URL should not require authentication in order to access it.
    5. Optional: Set TermsOfUsagePromptAlways to false if you want the disclaimer or terms of usage only displayed the first time the user logs in. See TermsOfUsagePromptAlways in the Mobile configuration properties section for more details.
    6. Save and check in the mobile-config.xml file.
  2. If you wish to present additional challenge questions, or record the fact that the user accepted the disclaimer or terms of usage, then use the information page settings InfoPagePathPattern, InfoPagePositivePathPattern, and InfoPageNegativePathPattern. The information page settings allow you to redirect the login process to a service, typically a servlet, that displays an HTML page during login. This HTML page can contain additional challenge questions or record when a user accepts or rejects a disclaimer or terms of usage. The app displays the HTML page during login and does not provide any options to the user. All options on the web page, such as input answers or accept or reject options, are provided by the web page.
    During the login process, the app monitors all redirect requests, and if a redirect to a URL matching the regular expression that is provided by InfoPagePathPattern is detected, the app displays the web page at that URL in a web view. As the user interacts with the web page, the app monitors all requests to load URLs in the web view. If a URL matching the regular expression provided by InfoPagePositivePathPattern is detected, then the app dismisses the web view and continues the login process. If a URL matching the regular expression provided by InfoPageNegativePathPattern is detected, then the app dismisses the web view and fails the login.
    1. Check out the mobile-config.xml file for editing. For more information about checking out the file, see the Changing Mobile configuration property values topic.
    2. Open the mobile-config.xml file in a text editor. Find the SecuritySettings section and set enabled to true.
    3. Locate the Security properties section and set enabled to true.
    4. To enable an information page with challenge questions, specify the URL of the information page in the InfoPagePathPattern property. This is the page that is displayed in the web view.
      Note: Ensure that you already created the page that is specified by this URL.
    5. In the InfoPagePositivePathPattern property, specify the URL of the page to display when the user accepts the information or provids valid answers to additional authentication challenges. Content for this page is not required. It is not displayed to the end user. It tells the app to dismiss the web view and continue with the login process.
    6. In the InfoPageNegativePathPattern property, specify the URL of the page to display when the user answers the challenge questions incorrectly. Content for this page is not required. It is not displayed to the end user. It tells the app to dismiss the web view and fail the login.
    7. Save and check in the mobile-config.xml file.