Knowledgebase

Search:     Advanced search

Configuring External Authentication Components for TestTrack RM Reviewer

Article ID: 295  |  Last updated: 23 Dec, 2014

External authentication systems can be integrated with the Seapine License Server to allow users to log in to Seapine products using their existing authentication system credentials. Web servers that host TestTrack RM Reviewer require custom pages to support external authentication for logging in and entering electronic signatures. The following information includes the function calls required for these custom pages.

Note: After creating the external authentication pages, refer to the Seapine License Server Admin help for information about installing them and enabling external authentication.

TestTrack RM Reviewer uses JavaScript calls to provide authentication credentials. Custom external authentication pages are required for logging in and entering electronic signatures. The URL for these pages must be added to the application configuration file on the web server.

Note: External authentication credentials must be base64 encoded to prevent data corruption when sent to the Seapine License Server.

Login pages

Use the following JavaScript callbacks added to the window object in the custom authentication login pages.

window.loggedInCallback(credentials);

window.cancelCallback();

To submit the login, call window.loggedInCallback to pass the base64-encoded credentials as the parameter.

Example

<script language="javascript">

<!--

window.onbeforeunload = function () {

   window.cancelCallback();

};

function prepareAndSubmit () {

   var name = document.theForm.uname.value,

      val = base64.encode(name);

   window.onbeforeunload = null;

   window.loggedInCallback(val);

   window.close();

}

-->

</script>

Electronic signature pages

Use the following callbacks added to the window object in the custom electronic signature pages.

window.eSignedCallback(credentials, reason);

window.cancelCallback();

A property for the signature testimony must be added to the window object. This property is set with the certification and testimony statement configured in the TestTrack project.

window.eSigTestimony();

To submit the signature, call window.eSignedCallback to pass base64-encoded credentials as the parameter.

Example

<script language="javascript">

<!--

window.onbeforeunload = function () {

   window.cancelCallback();

};

function prepareAndSubmit () {

   var name = document.theForm.uname.value,

      val = base64.encode(name),

      reason = document.theForm.reason.value;

   window.onbeforeunload = null;

   window.eSignedCallback(val, reason);

   window.close();

}

-->

</script>

Configuration file properties

Add the URL for the external authentication pages to the rmweb-config.js file in the HTML files directory on the web server. For example:

RMWebConfig.loginUrl = 'path/to/esig/page.html'

RMWebConfig.eSigUrl = 'path/to/login/page.html'

Article ID: 295  |   Last updated: 23 Dec, 2014
Tags
external authentication

Also listed in
folder TestTrack

Prev   Next
Changing the License Server to a Service     License Server Functions Incorrectly After Upgrading to Windows...