Troubleshooting: Phone Mask Does Not Produce the Desired Result

Version Affected: All
 
 

Overview

Changing the phone mask regular expression on the Multi-Factor Methods tab (for example, to show 5 digits of a phone number instead of the default 4) does not produce the expected result.

 

Cause

The mask must use n for every digit that should be shown, and x for every digit that should be hidden. Any dashes in the pattern are always carried over as-is.

 

Resolution:

To resolve this:

1. Go to the Multi-Factor Methods tab, then Phone Settings, then Phone Mask (Regex).
2. Enter x for each digit to hide and n for each digit to show. The number of digits in the mask must exactly match the number of digits in the user's phone entry — for a 10-digit US number like (555)555-5555, the mask needs exactly 10 x/n characters.

To account for more than one phone number format (for example, a country code), separate each additional pattern with a comma. Within a single pattern, separate a country code from the rest of the number with a pipe (|).

For example, to mask a US number as xxx-xxn-nnnn and also mask that same number when it includes a +1 country code (showing as x|xxx-xxn-nnnn, which displays as xxxx-xx6-7890 for +1 123-456-7890), enter:

xxx-xxn-nnnn,x|xxx-xxn-nnnn

SecureAuth Knowledge Base Articles provide information based on specific use cases and may not apply to all appliances or configurations. Be advised that these instructions could cause harm to the environment if not followed correctly or if they do not apply to the current use case.

Customers are responsible for their own due diligence prior to utilizing this information and agree that SecureAuth is not liable for any issues caused by misconfiguration directly or indirectly related to SecureAuth products.