Get Password Console Action

The Get Password console action enables end users to enter a required password in order to proceed an installer installation. This action is typically used to restrict access to certain installation paths, features, or modes. The installer will prompt the user for a password, and based on the password entered, it can either proceed the installation process or prevent the same.

Properties Tab

The Properties tab of the Get Password action customizer includes the following settings:

Get Password Customizer Settings

Setting

Description

Title

Enter the text that you want to use in the title bar of the Get Password console. The default value is:

Enter Password

Instructions

Enter the text that you want to display on the Get Password console. The default value is:

This installation requires a password to continue.

Prompt

Enter the label text that you want to display just before the password input field on the Get Password console. This label text on the console specifies the information the installer requests. The default value is:

Please Enter the Password

Results

Specify the required user-defined variables in which the user-entered password and its related index value are stored, by utilizing the following options:

• Password Entered—Specify the user-defined variable that stores the password entered by the user on the console.
• Index of Matching Password—Specify the user-defined variable that stores the position (index) of the user-entered password within a list of valid passwords, defined in an external password validation file.

When an installer runs and the user enters a password, InstallAnywhere checks that password against each line in the password validation file. If the entered password matches one of the entries, the index (starting from 0 for the first line) is stored in the user-defined variable that is defined here.

This password validation process enables the index feature, allowing each different password to effectively unlock different features. Therefore, provides a flexible and secure way to manage multiple access keys or license levels.

Validate with File

Select this check box and click Choose File to locate a password validation file that contains a list of valid passwords. The file should be a plain text file with one password per line.

Allow password to be left blank

Select this check box if you want to allow the user to skip entering a password in the Get Password console and proceed with the installation. By default, this check box is selected.

Re-Enter Password to Confirm

Select this checkbox if you want the user to be prompted to confirm the password by re-entering the same password. The installer compares both entries to ensure they match before proceeding. By default, this check box is cleared.

Rules and Tags Tabs

For information on the other tabs on this customizer, see the following:

• Rules—Use this tab to add rules to the selected action. For more information, see Assigning a Rule to an Action and Rules Reference.
• Tags—Use this tab to add build configuration tags to the selected action. For more information, see Assigning Tags to Project Elements.