In some situations, you may wish to track which respondents have responded to a survey. To capture this identifying information, you will first need to set up a survey requiring HawkID authentication. The steps below will walk you through the process of setting up a HawkID authenticated survey which will capture identifying information about the respondent.
Note: If you would like to require HawkID authentication, but do NOT wish to capture identifying information about the respondents, please see article 3906.
Capturing Identifying Information During Authentication:
- From the Survey tab, click the Survey Flow link at the top of the page
- From the Survey Flow page, click the +Add a New Element Here link
- From the list of options available to add, click the Authenticator button
- From Authentication Type, select SSO
- Remove the checkmark next to "Associate Respondent With Panel"
- Place a checkmark next to "Capture Respondent Identifying Info", then click the "Add Embedded Data..." when link the appears.
- You will then need to insert the attribute you wish to capture in the "Embedded Data To Set" field, and the object identifier in the "Field from SSO" field. Available attributes are as follows:
For example, if you would like to capture the HawkID of a respondent, you would put "Username" in the Embedded Data to Set field, and the corresponding object identifier (as shown in the screen capture in Figure 1 below).
Embedded Data to Set: Field From SSO: Username urn:oid:188.8.131.52.4.1.59184.108.40.206.6 First Name urn:oid:220.127.116.11 Last Name urn:oid:18.104.22.168 urn:oid:0.9.2342.19200300.100.1.3 User type urn:oid:22.214.171.124.4.1.59126.96.36.199.9
- From the SSO Type, select Shibboleth
- Click Move (under the blue authentication box), and drag the blue box up to the top of the survey flow (this should be the first item in your survey flow if you wish to have them authenticate to access the survey).
Your settings should appear similar to those in the screen capture below.
- Click the Save Flow button at the bottom of the screen.
You will now be able to view the respondent's captured identifying information in your survey results.
Figure 1: Screen capture of correct settings for capturing HawkID (username)