Introduction

Livecube provides a secure, lightweight API that allows for open-ended authentication. When Livecube is used as part of a suite of applications, the smoothest attendee experience will be to sign in just once.

Authentication

Once the Single Sign-On capability is enabled for your Organization, your Meetings can make use of these two methods.

Enable Single Sign-On

In the Organizer Admin Tools, when editing the Meeting, select the appropriate Single Sign-On integration.

Note: Livecube will provide a secret salt for use in the second method below.

Livecube apidocs screen sso 01

Create an Attendee

Use this POST request to create the Attendee and give them access to a Meeting

POST https://yourmeeting.livecubeapp.com/sso_sign_up

POST Request Parameters

{
  email: "js@livecube.co",
  first_name: "Justin",
  last_name: "Schier",
  user_id: 2222222222
}

Successful JSON Response

{
  status: 1,
  user_id: 2222222222,
  external_id: 7777777
}

Sign In an Active Attendee

Use this GET request to sign in a previously created Attendee. This can easily be accomplished by placing a clear pixel image within your app's secure area.

GET https://yourmeeting.livecubeapp.com/sso_sign_in?id=2222222222&time=1449593279200&token=153ba03a3062eef2b8acf0ab48d9a60ca1c146ac24c40b509e5f39c51f050a08

URL Parameters

id
required

Attendee unique identifier from originating app (not Livecube).
(Alphanumeric)

Example Value:
2222222222
time
required

Unix Epoch Timestamp in Milliseconds generated by originating app server. Make sure your clocks are kept in sync. Time variance allowed is less than five minutes from atomic time.
(Numeric)

Example Value:
1449593279200
token
required

256 Bit SHA Hex Digest of the following concatenated string: salt+time+id .
Do not include the plus characters.
(Alphanumeric)

Example Value:
153ba03a3062eef2b8acf0ab48d9a60ca1c146ac24c40b509e5f39c51f050a08

Successful JSON Response

{
  status: 1
}