Added by admin, last edited by admin on Feb 24, 2010  (view change)

Labels:

Enter labels to add to this page:
Wait Image 
Looking for a label? Just start typing.

BookingBug Open API: Single Sign-On

Purpose

BookingBug's Single sign-on allows partner site to embed BookingBug within their own site and pass through authentication to save their users have to log in to two sites.

Embed a Dashboard

You can embed a BookingBug Dashboard into your own site using the following parameters :

  <iframe width=950 height=600 style="overflow:hidden" frameborder="0" src="http://uk.bookingbug.com/embed/dashboard/show?sso=#sso_string#>&affiliate_id=#affiliate#"></iframe>&nbsp;
  
parameters

sso_string and affiliate_id are an optional set of Single Sign on parameters for affiliates. This allows you to pass in user details to authenticate a user automatically. Otherwise a mini login box is shown for the user to login to BookingBug.

affiliate_id : This is your affiliate cookie id that is shown on the affiliate settings page

sso_string : This is an encrypted json string that contains secure details about the user you wish to log in as. The parameters are :

parameter description
user a users email address
password a users password
expires a time in the future when then string expires if not used - it must have been submitted in an iframe before this time
redirect_url a URL to send a user to if  the open a new window. This means that if a user opens a new window on the iframe by clicking on a link in BookingBug, rather then open a blank page with BookingBug, the user will in fact be redirected to the given URL.
This URL will be passed in a parameter of bbug_loc. This is the required path within BookingBug that the user attempted to open. The URL you set as a redirect should contain an iframe, which loads bbug_loc.

examples

There are source code examples of how to encrypt the SSO string in common languages. Simply replace the AffiliateID and AffilaiteKey with your own affiliate values

.NET Sample
Ruby Sample