Sign-On link for backoffice users

Created by Julien Pauthier, Modified on Wed, 14 Jun, 2023 at 9:28 AM by Julien Pauthier

How to generate a temporary Sign On URL?

The Sign On 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

Note: here is a PHP script to generate such SSO URL.

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 with the server name you use.