Versions Compared

Key

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

...

To connect via single-sign on, the external system will need to construct a querystring with the following contents:

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 

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

See Secure Tokens for SSO and Demographic Sync

TimeStamp 

A time stamp generated to establish the authentication token. 

See Secure Tokens for SSO and Demographic Sync

Token 

The encrypted token. 

See Secure Tokens for SSO and Demographic Sync

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 here (New in LearningBuilder™ 7.18)

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.

...