Professional > Interview scripting > Sample management > Sample management facilities > Authentication of inbound respondents > Authentication failed
 
Authentication failed
When you activate a project that uses sample management, you can specify:
The web page that UNICOM Intelligence Interviewer - Server displays when a respondent fails authentication.
The web page that UNICOM Intelligence Interviewer - Server displays when a respondent who failed authentication attempts authentication again.
The web page that UNICOM Intelligence Interviewer - Server displays when authentication rejects a respondent because, for example, he or she has been rejected by quota control.
Like the authentication page, you can specify these web pages as UNICOM Intelligence Interviewer - Server templates or as URLs. The templates must be UNICOM Intelligence Interviewer - Server templates, whereas the URLs must point to a web page. However, you are strongly recommended to use only templates for the retry-authentication page. This page works just like the authentication page, and you can optionally use the same template for both the authentication page and the retry-authentication page.
If you define these pages using UNICOM Intelligence Interviewer - Server templates, UNICOM Intelligence Interviewer - Server can insert some text at a specified position. You define the position using the <mrDisplayText> tag, and you define the text to be displayed in the Sample Management script using the DisplayText interview property. This means that you can display different texts in different situations; for example, explaining why authentication has failed.
The details of the web pages are held as interview properties and can be accessed from the sample management script. This means that you can change these details when necessary from within the script; for example, if you want to display one authentication-failed page when authentication fails because the respondent enters an incorrect ID and a different one when the authentication fails because the respondent has already completed the interview.
By default, a respondent can attempt authentication six times. However, you can optionally change the number of times a respondent can attempt authentication in the script by setting the MaxAuthRetries interview property. By default, this property is set to 5.
See also
Authentication of inbound respondents