What Is the Single Sign-On (SSO) Feature & How Does It Work?

Single Sign-On (SSO) in ProProfs Quiz Maker allows your quiz to automatically identify users who are already logged in to your website. This eliminates the need for quiz takers to manually enter details such as name, email, user ID, or password.

SSO is especially useful when your quiz is embedded on your website or when you already have user information that you want to pass directly to the quiz.

Why is Single Sign-On Required?

This feature is useful when users are already logged into your website or when you have their data. With Single Sign-On, users are automatically identified by the quiz without entering details like name, email, user ID, or password. As a result, reports accurately show who took the quiz, eliminate repeated data entry, and improve security by relying on system-based identification instead of user input.

Benefits:

• Accurate User Identification: Capture reliable user data without depending on manual input.

• Faster Quiz Access: Reduce friction and improve completion rates by removing extra steps.

• Improved Security: Authenticate users through your system instead of relying on entered credentials.

Example:

A company embeds a quiz on its employee portal. Since employees are already logged in, their details are automatically passed to the quiz using SSO, allowing them to start the assessment instantly without entering any information again.

Integrating SSO When You Link to Quizzes Hosted at ProProfs.com When you link to quizzes that ProProfs is hosting for you, you can pass the following variables to the URL:

• user_name - for username
• user_email - for the user's email address
• user_id - for the user's ID (this variable will remain the same even if you have renamed the ID)
• passkey - for MD5-encrypted password
• cq_xxxxxxx (SSO Key) - An SSO Key is associated with a custom question you can create.

Integrating SSO When You Embed Quizzes On Your Website

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

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

• user_name - for username
• user_email - for the user's email address
• user_id - for user's ID (this variable will remain the same even if you have renamed ID)
• passkey - for MD5 encrypted password
• cq_xxxxxxx (SSO Key) - An SSO Key is associated with a custom question you can create.

You need to provide these variables with the quiz URL/iframe source where you embedded the quiz. 

For example:

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

Then add variables in URL/ iframe src:

What is Passkey?

Passkey is an option to allow authorized users to access password-protected quizzes without any password requirement.

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

SSO Key

An SSO Key is attached to a custom question. When you create a custom question, the key is generated automatically. Furthermore, the SSO Key is updated every time you change its corresponding question, no matter how big or small.

Here's how you can create a custom question to get an SSO Key:

Step 1: Go to a quiz's Settings >> Security.

Step 2: Scroll to the option Ask My Own Question and enable it. You can then add the following question types:

• Choose from list
• Write in textbox
• Multiple Choice
• Select Date

Step 3: Enter the question and its answers. Save when you're done, and you can see the SSO Key at the bottom of the question, as shown in the screenshot below. You can similarly add more questions.

Related Articles:

ProProfs REST API Guide

How To Auto-enroll Learners To Classroom Using API

How To Track Progress Of Learners In My Systems Using API