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>
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