How to generate a Single Sign On URL?

The Single Sign On (SSO) method described below allows you to securely log your users to the Agendize dashboard. To do so, you will need to generate the URL below with the following URL parameters:


https://app.agendize.com/sso/1.0/sso


Note: please replace app.agendize.com by the server name you use.


Name

Description

Required

email

Account email

Y
ts

Timestamp in milliseconds (number of milliseconds since 1970/01/01)

Y
t

Session timeout, defined together and configured by Agendize - for now this is hard coded to “600000”.

N

mac

HMAC SHA-256 value calculated by concatenating email, ts and t as the message, using the user account’s SSO token as the key. 

mac = Hmac(HmacSHA256, email + ts + t, user_sso_token)

Y

errorPage

Personalized error page, where the user will be redirected in case of error.

N


HMAC generator page

In order to assist with validation of the SSO generation code, your team can use an HMAC generator page created by Agendize to compare against the value generated by code. On this page, you’ll only need to enter the email address, timestamp and user SSO token in order to generate a working SSO URL and compare it to the URL generated by the code: 


http://app.agendize.com/apps/resellers/generator.jsp 


Note: please replace app.agendize.com by the server name you use.


Sample URL

https://app.agendize.com/sso/1.0/sso?email=xxx@acne.com&ts=1387917862182&mac=a0939fece83fb9909730f67071f0b9259a7313f77043fca62a043a432a1a6a5a&errorPage=http://www.agendize.com?error


Note: please replace app.agendize.com by the server name you use.