Security - Authenticate

Declaration

<AMAUTHENTICATE PASSWORD="text (encrypted)" />

<AMAUTHENTICATE USERNAME="text" />

Description: Stops task execution at a specific line until the user authenticates himself/herself in the specified manner.

Practical Usage

Ideal when particular tasks contain sensitive information and should only be run by specific users or when specific proper authentication is provided.

Authenticate Parameters

Property	Type	Required	Default	Markup	Description
Must pass a standard Windows logon	---	---	---	---	If enabled, a valid user name and password normally used to log onto the system must be entered in order for the task to continue. During runtime, an Authentication Required dialog will appear prompting the user to enter the username/password. This parameter is enabled by default and only used in visual mode during design time, therefore, it contains no properties or markups.
Must enter this password	Text	No	(Empty)	PASSWORD="EncryptedText"	If enabled, specifies a valid password that the user must enter before the task continues. In Visual Mode, simply enter the password in the provided field. This value is automatically encrypted during entry.
This user must be logged on	Text	Yes	(Empty)	USERNAME="Ron.Artest"	If enabled, specifies a valid Windows user name. The user specified must be logged on in order for the task to continue.

Description tab - A custom description can be provided on the Description tab to convey additional information or share special notes about a task step.

Error Causes tab - Specify how this step should behave upon the occurrence of an error. (Refer to Task Builder > Error Causes Tab for details.)

On Error tab - Specify what AWE should do if this step encounters an error as defined on the Error Causes tab. (Refer to Task Builder > On Error Tab for details.)

Examples

The sample AML code below can be copied and pasted directly into the Steps panel of the Task Builder.

Sample 1

Authentication via password entry. At runtime, a valid password must be entered in the provided dialog).

<AMAUTHENTICATE PASSWORD="text (encrypted)" />

Sample 2

Authentication via specified user. A specific user must be logged on to pass authentication.

<AMAUTHENTICATE PASSWORD="text (encrypted)" />