Hosted Help Desk Authentication API
Configuring single sign-on with your existing Web-apps and websites
(aka "remote login")
If your infrastructure supports SAML single-sign-on protocol, please read this article, otherwise, continue reading
Our Hosted helpdesk supports the "autologin" feature just like the downloadable version of the helpdesk. This feature allows users to be pre-authenticated automatically (by your parent website for example) without entering their username and password. The "autologin" feature is targeted at developers and administrators, who integrate the Hosted HelpDesk software into their existing websites and applications. If the user is already authenticated on your parent website (for instance) here's how you redirect him to the helpdesk application:
- No matter if a user is already present in the helpdesk database or not, use this link format:
http://Helpdesk_Url/User/AutoLogin?username=xxx&email=yyy&userHash=HASH. The helpdesk will either create a new user account or use the existing one.
- In the URL above
Helpdesk_Urlis the full helpdesk URL (for example "foo.jitbit.com/helpdesk/" if you're using the hosted version),
usernameis the user's username,
HASHis calculated as follows:
MD5(name + email + shared-secret + day + month). The "shared secret" is specified in the helpdesk's admin panel. Remember to specify a "strong" secret, at least 10 characters (the longer the better). The
monthvalues should be the current day of month, and current month formatted as TWO DIGITS, so "January 1st" should become "0101".
You can optionally add
LastName=xxxparameters to the URL, so the newly-created helpdesk user will have the First/Last names pre-set. You can also pass
CompanyName=xxxso the auto-created user will have a company assigned
&ReturnUrl=%2fhelpdesk%2fUser%2fProfile(for example). The URL can be relative or absolute.