Echelon OpenLDV - Manual (Page 119)

OpenLDV Programmer’s Guide 111
Field Description
Remote TCP Address The TCP/IP address of the RNI to which to connect. For an uplink
session, this field is read-only. The remote TCP address must be
specified in the form x.x.x.x, where x represents an integer
between 0 and 255. A DNS-resolvable hostname can also be
specified for this field.
Remote TCP Port The port number that the RNI uses for incoming connections from
the OpenLDV application. For an uplink session, this field is
read-only. Valid port numbers are 1 to 65535.
Authentication Key Handling
Authentication key handling is an essential part of any lookup extension
component. Your custom lookup extension component must fill the
authentication key fields into the SCO, and properly handle changes to the
authentication key fields. Figure 18 shows a high-level view of authentication
key handling. The figure shows a sample authentication key (ABCD) that does
not use the required format.
RNI Device
Authentication Key: ABCD
xDriver Connection
External Database
xDriver Lookup Extension
Component Accesses
External Database and
Returns Current
Authentication Key
LNS Server with xDriver
Authentication Key
Handling
Figure 18. Authentication Key Handling
Note: This section refers to the methods that you can use when programming
your custom lookup extension component. For more information about these
methods, see Appendix C, Custom Lookup Extension Component Programming,
on page 161.
Setting the Current Authentication Key
When an xDriver session is initiated, the lookup extension component must
access the database, extract the authentication flag for the RNI from the
database, and fill it into the SCO using the SetAuthenticationFlag method. If
the authentication flag is True, indicating that authentication is currently
enabled, the lookup extension component must also extract the current MD5
authentication key for the RNI from the database, and fill it into the SCO using
the SetCurrentAuthenticationKey method. The authentication key must be a