This article will outline how to configure your institutions ClickView ADI Connector to use the 'User Principal Name' (UPN) value, rather than the 'E-mail' attribute within your institution's Active Directory for ClickView Online purposes. This prevents having to populate the e-mail address field for each user account within your institutions Microsoft Active Directory.
NOTE: ClickView only recommends following this article if your institution does not have the e-mail address field within Microsoft Active Directory populated. The reason for this is the fact that the User Principal Name (UPN) value is typically not a valid e-mail address and therefore users may not be able to receive e-mails from ClickView Online as a result of using this method.
1. Navigate to your ClickView ADI connector installation directory. The default location for the installation is:
NOTE: The installation path may vary depending upon your institution's setup.
2. Open the Web.config file with notepad, as highlighted by the screenshot below.
3. Edit the string 'UserNameField' within the Web.config file to use attribute 'userprincipalname' rather than attribute 'mail'.
The default entry for the string is:
<add key="UserNameField" value="mail"/> <!-- attribute that ONLINE would use for username.
Change to entry to:
<add key="UserNameField" value="userprincipalname"/> <!-- attribute that ONLINE would use for username.
4. After the change has been made, save the Web.config file.
5. The IIS will need to be reset for the changes to take effect. To reset the service, open command prompt. To do this, click Start then click Run. Type IISReset into the text field, as per the below screenshot.
6. Click OK. A Command Prompt window will open displaying the status of the IISReset command, advising that it is attempting to stop the service, and attempting to restart it again. Once it restarts, the window will automatically close. The below screenshot shows the status displayed in the command window just before it auto closes.
This is all that is required to configure SSO to use User Principal Name rather than email for account authentication.