AttemptInvisibleLogonEx() function

The AttemptInvisibleLogonEx() function can be used in a script to log on a user to InTouch using the credentials stored in the Credential Manager. The user is not required to enter a password or user ID.

Category

security

Syntax

DiscreteTag=AttemptInvisibleLogonEx("Credential Name");

Arguments

Credential Name

Name of the credential stored in the Credential Manager. For standalone InTouch applications, the credentials are retrieved from the Application Manager. For managed InTouch applications, the credentials are retrieved from the Credential Manager of the Application Server.

Return Value

Returns TRUE if authentication is successful. Otherwise, it returns FALSE.

Remarks

An attempt is made to log on to the InTouch HMI using the credentials saved in the Credential Manager. For standalone InTouch applications, the credentials are retrieved from the Application Manager. For managed InTouch applications, the credentials are retrieved from the Credential Manager of the Application Server.

• If the logon attempt succeeds, then TRUE is returned and the $OperatorDomain, $OperatorName, $AccessLevel, and $Operator system tags are updated accordingly.

• If the log on attempt fails, then FALSE is returned, and the currently logged on user (if any) continues to be the current user.

The Domain argument is only valid for operating system-based security. If ArchestrA security mode is in use and if ArchestrA security is in turn using operating system-based security, the UserId argument should contain the fully qualified user name with domain name or computer name.

Examples

When security is operating system-based:

DiscreteTag=AttemptInvisibleLogonEx("TestCredentialName01");

See Also

PostLogonDialog(), InvisibleVerifyCredentials(), IsAssignedRole(), QueryGroupMembership(), AddPermission()