AMX NX-1200

NetLinx Programming
102
NX-Series Controllers - WebConsole & Programming Guide
Authentication
The NetLinx.axi file that ships with NetLinx Studio includes the following types/constants for authentication:
(*------------------------------------------------------------------------------------------------*)
(* Added v1.56 *)
(*------------------------------------------------------------------------------------------------*)
STRUCTURE LAST_LOGIN_INFO
{
INTEGER failedLoginCount
CHAR lastSuccessfulLoginDate[MAX_LAST_LOGIN_INFO_LENGTH]
CHAR lastSuccessfulLoginIp[MAX_LAST_LOGIN_INFO_LENGTH]
CHAR lastFaileLoginDate[MAX_LAST_LOGIN_INFO_LENGTH]
CHAR lastFailedLoginIp[MAX_LAST_LOGIN_INFO_LENGTH]
}
Library Calls
The NetLinx.axi file that ships with NetLinx Studio includes the following Authentication-specific library calls:
NetLinx.axi - Library Calls
TLS_CLIENT_CLOSE Closes an open TLS communication port with a remote device. Typically, the remote host closes the
connection and you do not need to send this command.
Syntax:
integer TLS_CLIENT_CLOSE(LocalPort)
Parameters:
• LocalPort - A user-defined (non-zero) integer value representing the local port on the client
machine to use for this conversation. This local port number must be passed to TLS_CLIENT_OPEN
to open the conversation.
Returns:
0 - Success
1 - Error
Example:
TLS_CLIENT_CLOSE(5000)
TLS_CLIENT_OPEN Opens a port for TLS communication with a remote device.
Syntax:
integer TLS_CLIENT_OPEN(LocalPort, hostname, port, mode)
Parameters:
• LocalPort- A user-defined (non-zero) integer value representing the local port on the client machine
to use for this conversation. This local port number must be passed to TLS_CLIENT_CLOSE to close
the conversation.
• hostname - The host name or IP address of the remote host.
• port - The connecting port on the remote host, usually port 443 for standard HTTPS connections.
• mode - 0: TLS_VALIDATE_CERTIFICATE (perform certificate validation), 1:
TLS_IGNORE_CERTIFICATE_ERRORS (connect to the remote site while ignoring certificate errors or
mismatches)
Returns:
This function returns 0 is all parameters are accepted, or a positive value indicating the offending
parameter if there is an error.
Example:
TLS_CLIENT_OPEN(5000, '192.168.0.1', 443, 0)