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 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 the below variables from query string to fetch the data from the query string. These are

• passkey - for MD5 encrypted password
• sso_xxxxxxx (SSO Key) - A SSO Key is associated with a question that you can create.

                                                  Or

• 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 the first "single textbox" question in your survey dashboard)

You need to provide these variables with the survey URL/iframe src, 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 variables like this in URL/ iframe src:

                                                 Or

Passkey

If you have any trouble implementing the SSO on your website, please contact support for assistance.

SSO Key

An SSO Key is attached to a question. When you create a question, the key is generated automatically. 

To Get an SSO Key

Step 1: Open the survey in the editor mode and click "+Add Question." Select any of the following question types: Email, Name, Address, or Phone question.

Step 2: Click Advanced to view the SSO key.

That is all about the SSO feature in ProProfs Survey Maker.