Configurable User Verification Dialog

The Beyond Identity Platform Authenticator for Windows and Mac added the ability to configure the user verification dialog text in version 2.103.3 and above. Below are the details of how to configure for each platform:

 

Windows

On Windows the default user verification dialog looks like the following:

 

In Windows the user verification dialog text can be modified using either the registry or the BIConfigure command. Both methods are equivalent and interchangeable.

 

Set the user verification dialog text using the registry

To customize the Windows user verification dialog text using the registry perform the following steps:

1. Open the Registry Editor and go to HKEY_LOCAL_MACHINE\SOFTWARE\Policies.
2. If it doesn't already exist, add the following sub keys:
   BeyondIdentity\Authenticator
3. Add the following value to the Authenticator key:
   VerifyText (STRING)
4. Set the VerifyText value to the text you want to be displayed. 
5. Close the Registry.

Clear the user verification dialog text using the registry

To reset the Windows user verification dialog text to the default using the registry perform the following steps:

1. Open the Registry Editor and go to HKEY_LOCAL_MACHINE\SOFTWARE\Policies\BeyondIdentity\Authenticator.
2. Delete the VerifyText registry value.
3. Close the Registry.

Set the user verification dialog text using BIConfigure

To configure the user verification dialog text through the BIConfigure command line utility perform the following steps:

System Install:

1. Open a command prompt with Administrator privileges.
2. Enter the command:

 "C:\Program Files\BeyondIdentity\Tools\BIConfigure" –set-verify-text "<text>"

3. Example:

"C:\Program Files\BeyondIdentity\Tools\BIConfigure" --set-verify-text "Please verify it’s really you. Your biometric data will not be shared or captured during this process."

 

User Install:

1. Open a command prompt with Administrator privileges.
2. Enter the command:

"C:\Users\<user>\AppData\Local\Programs\BeyondIdentity\Tools\BIConfigure" –set-verify-text "<text>"

3. Example:

"C:\Users\joe.user\AppData\Local\Programs\BIConfigure" --set-verify-text "Please verify it’s really you. Your biometric data will not be shared or captured during this process."

 

Get the user verification dialog text using BIConfigure

To retrieve the current user verification dialog text using the BIConfigure command line utility perform the following steps:

 

System Install:

1. Open a command prompt with Administrator privileges.
2. Enter the command:

 "C:\Program Files\BeyondIdentity\Tools\BIConfigure" –get-verify-text

3. Example:

"C:\Program Files\BeyondIdentity\Tools\BIConfigure" --get-verify-text

User Install:

1. Open a command prompt with Administrator privileges.
2. Enter the command:                                                                                                                           "C:\Users\<user>\AppData\Local\Programs\BeyondIdentity\Tools\BIConfigure" –get-verify-text
3. Example:

"C:\Users\joe.user\AppData\Local\Programs\BIConfigure" --get-verify-text 

 

Clear the user verification dialog text using BIConfigure

To reset the user verification dialog text to the default using the BIConfigure command line utility perform the following steps:

 

System Install:

1. Open a command prompt with Administrator privileges.
2. Enter the command:

 "C:\Program Files\BeyondIdentity\Tools\BIConfigure" –clear-verify-text

3. Example:

"C:\Program Files\BeyondIdentity\Tools\BIConfigure" --clear-verify-text

User Install:

1. Open a command prompt with Administrator privileges.
2. Enter the command:

"C:\Users\<user>\AppData\Local\Programs\BeyondIdentity\Tools\BIConfigure" –clear-verify-text

3. Example:

"C:\Users\joe.user\AppData\Local\Programs\BIConfigure" --clear-verify-text 

 

Example

Regardless of method (Registry or BIConfigure), the next time the user verification dialog is displayed it will contain the specified text. An example is shown below:

 

 

MDM for Windows

Both methods (Registry and BIConfigure) can be used with MDM (InTune, SCCM, etc.) to push out changes to the user verification dialog text to all users.

macOS

Use the command line utility, BIConfigure, to set the user verification dialog text on a macOS device.

Set the user verification dialog text

Use the command line utility, BIConfigure, which is bundled with the platform authenticator to set the user verification dialog text:

 

sudo "/Applications/Beyond Identity.app/Contents/Resources/BIConfigure"

 --set-verify-text <text>

Note:

On macOS, the operating system will automatically prepend “Beyond Identity is trying to” and append a trailing period to the text set by BIConfigure.

Example:

$ sudo "/Applications/Beyond Identity.app/Contents/Resources/BIConfigure"

 --set-verify-text "verify it’s really you. Your biometric data will not be shared or captured during this process"

Password: *********

Restarting all authenticators

User verification dialog text set

 

Get the user verification dialog text

After creating the version control ID, run the BIConfigure command line utility (run via MDM) using the following syntax:

$ "/Applications/Beyond Identity.app/Contents/Resources/BIConfigure"

 --get-verify-text

verify it’s really you. Your biometric data will not be shared or captured during this process

Clear the user verification dialog text

After creating the version control ID, run the BIConfigure command line utility (run via MDM) using the following syntax:

$ sudo "/Applications/Beyond Identity.app/Contents/Resources/BIConfigure"

 --clear-verify-text

Restarting all authenticators

User verification dialog text cleared