NetScaler – Enhanced Authentication Feedback Template

Reading Time: 2 minutes

Table of Contents

Overview

Enabling the enhanced Authentication Feedback on NetScaler’s AAA gives Endusers a better understanding of WHAT is wrong with their credentials (Username, Password, OTP) but is also a lack of security, as potential password spraying attacks getting simple answers if the username exists, for example.

The goal here was to create a better understanding for users – without a big lack of security.
Also, enhanced authentication feedback is a AAA global setting, which isn’t great when using different NetScaler Gateway’s / AAA Portals for different customer needs.

Configuration

The following pre-configured java script files per language will modify just a few of the default auth-feedback messages. In my opinion a great mix of “The user has some more informations than default” and “It’s not that default easy regarding IT-Security to get more informations”:

Function / Error Case:Displayed message on NS-Portal to Enduser:
User not foundIncorrect user name or password
Password wrongIncorrect user name or password
Password change does not comply with password policyCould not update your password. The password must meet the length, complexity and history requirements of the domain.
OTP / MFA wrongPossibly incorrect OTP
User is locked (by AAA)You have exceeded the maximum login attempts, your account is now locked. Please wait 15 minutes for automatic unlock.
User is disabledIncorrect user name or password
User wrongIncorrect user name or password

So basically the Endusers only getting an enhanced Feedback when MFA / OTP is wrong or when they have to change their password and it’s not matching with the password complexity. These two failure reasons causing many helpdesk-tickets, as the default “Try again after some time or contact your help desk” isn’t helping in any way. The same is for a locked user (depends on your max login attempts and failed login timeout settings on NetScaler) to show HOW long the auto-unlock takes.

You can change the behavior by Portal Theme – but my goal was to bring a new default which should work with every existing – and automatically with every future theme – all based on RfWebUI.

In the folder /var/netscaler/logon/LogonPoint/receiver/js/localization are the different language files located – depending on the language of the Endusers browser, which are used by all RfWebUI-based Portal Themes:

Here are the pre-defined files for download, just replace with yours and enable the Enhanced Auth-Feedback in AAA global settings. You can continue with customizing to your needs. My files are using english output for every browser-language (English, german, spanish, french and italian)

Blog_EnhancedAuthTemplates

I have adjusted the following lines, which no longer comply with the standard from NetScaler:

  • 351 – 367
  • 430
  • 439

Summary

I hope that Quickpost will give you a simple template to lower helpdesk-tickets from your Endusers.

Leave a Reply

Your email address will not be published. Required fields are marked *