How Does the Single Sign-on (SSO) Feature Work?

Our Single Sign-On (SSO) feature lets your survey automatically identify users who are already logged into your website. This feature is used when you have embedded a survey on your site or when you have information about the user such as their name, email id, user id and password that you wish to pass to the survey. That way respondents do not need to enter their name, email id, user id or even the password to access the survey as these are automatically identified.

Why is Single Sign-On Required?

This feature is also very useful when you have a large number of users who have already logged into your website or have identifying information on a large number of users. By using Single Sign-On, users are automatically identified by the survey (without the user being asked for their name, email id, user id, password, etc) and when as the survey author you review the report, you would see who took your survey. This prevents survey takers from re-entering their information each time to take the survey and makes the overall system more secure as users are identified by the system rather than trusting the user to enter the correct identifying information.

Integrating SSO When You Embed Surveys On Your Website

Let's take an example of your website URL (link) where you have embedded the survey. 

We use four variables from query string to fetch the user data from the query string. These are

• user_name - for username
• user_email - for user's email address
• custom_field - for collecting any additional user details that you want (the question type to be used for this is "single textbox" in your survey dashboard)
• passkey - for MD5 encrypted password

You need to provide these four variables with the survey page url, where you embedded the survey. 

For example:

You have embedded the survey on the website page:  http://www.mywebsite.com/survey/page.html

Then add the four variables like this:

Once you're done with the above steps, the survey will automatically fetch the username and email address from the URL.