Network Security APIs

The network security APIs include the server authentication entry APIs and the NetWare authentication entry APIs.

Server Authentication Entry APIs

The Server Authentication Entry APIs can be used by a client requesting connection to a server.

The server authentication entry APIs and their functions follow:

• Add Server Authentication Entry (QsyAddServerEntry) adds server authentication information for use by application requesters in connecting to application servers.
• Change Server Authentication Entry (QsyChangeServerEntry) changes server authentication information for use by application requesters in connecting to application servers.
• Remove Server Authentication Entry (QsyRemoveServerEntry) removes server authentication information for use by application requesters in connecting to application servers.
• Retrieve Server Authentication Entries (QSYRTVSE, QsyRetrieveServerEntries) returns a list of server authentication entries for a user profile.

NetWare Authentication Entry APIs

The NetWare Authentication Entry APIs provide a means that automatically logs you on to a server when you request a NetWare function (for example, the QNETWARE file system or NetWare administration commands). You can create authentication entries for each NetWare Directory Services (NDS) tree or NetWare 3.x server to which you are authorized. The entry identifies the tree or server, your name on that server, and (optionally) your password. The system saves the authentication entries as part of the user profile. When you request a NetWare function, the system attempts to start a connection to the server by using the data stored in the authentication entries.

Alternatively, you can explicitly start and end a connection to a server, such as when the system administrator has disabled storing passwords through the Retain Server Security Data (QRETSVRSEC) system value.

Note: To use these APIs, you need the OS/400 Enhanced Integration for Novell NetWare feature.

The NetWare Authentication Entry APIs and their functions follow:

• Add NetWare Authentication Entry (QfpzAddNtwAutE) stores user authentication information that is used to access the specified server.
• Change NetWare Authentication Entry (QfpzChgNtwAutE) changes the authentication information in the specified authentication entry.
• End NetWare Connection (QfpzEndNtwCnn) ends a connection to a NetWare server.
• List NetWare Authentication Entries (QfpzListNtwAutE) returns a list of authentication entries in a user profile.
• Remove NetWare Authentication Entry (QfpzRmvNtwAutE) removes an authentication entry from the user profile.
• Start NetWare Connection (QfpzStrNtwCnn) establishes the caller as an authenticated user of the specified server and starts the connection with the server.
• Verify Netware Authentication Entry (QfpzVfyNtwAutE) returns a list of authentication entries for the specified user profile.