Single Sign On with TutorCruncher

What is Single Sign On?

Single sign on allows our users to log in to other systems using TutorCruncher. An example of this would be signing into other applications using your Google or Facebook credentials.

In our case, you can set a link from TutorCruncher to another system accessible from the menu, which passes arguments to the other system containing the users information. A working example of this is available at the link below.

Click here to see an example of TutorCruncher's SSO.

How do I set up SSO in TutorCruncher?

Before you start you will need to make sure the system you want to allow SSO with works with TutorCruncher.

Go to System > Settings > Single Sign-on > View existing SSO, and click 'Add SSO Config'. On the next form you have a set of fields that must be filled in:

Token Variables

TutorCruncher supplies the following variables in SSO tokens:

Key Description
id id of the user, unique for each user
nm first and last name of the user
rt role type, Administrator, Contractor (eg. tutor) or ServiceRecipient (eg. student)
ts unix timestamp when the user clicked the link, aka "now"
tz the user's timezone name, this maybe null if no user or branch timezone is configured <[1]
br_id branch id, the id of the branch the user clicked the link from, generally there's one branch per company but there can be more
br_nm branch name
apt_id appointment(lesson) id, unique for each appointment (only available when the SSO link was followed from an appointment)
apt_nm name or topic of the appointment (only available when the SSO link was followed from an appointment)
apt_st unix timestamp for the start datetime of the appointment (only available when the SSO link was followed from an appointment)
apt_fn unix timestamp for the finish datetime of the appointment (only available when the SSO link was followed from an appointment)

<[1] timezones are provided as ISO timezone names eg. America/New_York, see the "YZ" column here.

If you have any questions regarding SSO, contact support@tutorcruncher.com, or there is more information regarding how to use SSO available at our example here.