InvisibleVerifyCredentialsEx() function
- Last UpdatedJun 17, 2024
- 1 minute read
The InvisibleVerifyCredentialsEx() function can be used in a synchronous QuickScript to verify the credentials of the given user without logging the user on to the InTouch HMI..
Category
security
Syntax
AnalogTag=InvisibleVerifyCredentialsEx("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.
Remarks
If the supplied combination of user, password, and domain are valid then the corresponding access level associated with the user is returned as an integer. Otherwise, -1 is returned.
Note: The InvisibleVerifyCredentialsEx() function must be run from a synchronous QuickScript. The function always returns -1 if run from an asynchronous QuickScript.
This function does not change the currently logged on user. The Domain argument is only valid for operating system-based security. If ArchestrA security 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.
Example
AnalogTag=InvisibleVerifyCredentialsEx("john", "Password", "corporate_hq");
See Also
PostLogonDialog(), AttemptInvisibleLogon(), IsAssignedRole(), QueryGroupMembership(), AddPermission()