Versions Compared

Old Version 5

changes.mady.by.user Steve Ross

Saved on

compared with

New Version 6

changes.mady.by.user Seth Petry-Johnson

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Single Sign-On Implementation

Implementing Implementation requires the following components:

  1. A visual protocol within An ability for the AMS/CRM to navigate send users to LearningBuilder™ (e.g., a link or button that directs visitors to LearningBuilder™);

  2. A mechanism to generate an authentication token (see section 4);

  3. A mechanism to send token and user identity to LearningBuilder™ through a query string;

  4. A URL to redirect users to when sign-on succeeds (optional);

  5. A URL to redirect users to when sign-on fails (optional); and

  6. A URL to redirect users to when signing off.

...

https://[YourSite].LearningBuilder.com/account/sso?UniqueId=[UID]&t=[TimeStamp]&token=[Token]&SuccessURL=[SuccessURL]&FailureURL=[FailureURL]&bypassDemographics=[bypass]

Component

Explanation 

Comment 

YourSite

A LearningBuilder™ sub-domain, usually the client’s acronym. 

Custom URLs are acceptable. 

UID UID

The identifier of the visitor attempting to sign on to LearningBuilder™ through the external system. 

See Secure Tokens. 

TimeStamp TimeStamp

A time stamp generated to establish the authentication token. 

See Secure Tokens. 

Token Token

The encrypted token. 

See Secure Tokens. 

SuccessURL

The landing page when sign-on is successful.   This is useful if you want the user to land on a page other than their default landing page.  A list of supported Success URLs is found on the Jump Links page. 

Optional.  If the URL to redirect to is for a page outside of LearningBuilder™, then the provided URL must be fully qualified, i.e. begin with 'HTTP://'.  If not provided, the user will be taken to their default landing page. 

FailureURL 

The landing page of the external system when sign-in is not successful. 

Optional.  If not provided, the user will be taken to the default error page. 

bypassDemographics

Set to "true" if you are not using the Demographic Synchronization Service , or are testing and want to bypass it.

Optional. If true, the demographics synchronization will be skipped.

...

When the user logs off of LearningBuilder™, they are redirected to the LogOffURL. This URL is specified through configuration of LearningBuilder™ and must be provided to the technical team during system configurations.  

In addition, a CustomLoginUrl (new in LearningBuilder 7.22.0) can be defined which Users will be redirected to upon login when they do not have an active session. When not specified, it defaults to /account/login/. -->

Please create a Support Ticket to make changes to the LogOffURL and CustomLoginUrl and CustomLoginUrl.