Network Dual-Stack Component  Version 7.0 (Beta)
MDK-Professional Middleware for IP Networking
 All Data Structures Files Functions Enumerations Groups Pages
Access and Multi-User Interface

Functions to filter access to the Telnet server and to work with user accounts. More...

Functions to filter access to the Telnet server and to work with user accounts.

To filter the access to the Telnet server based on the IP address and port of the connecting client, the optional function netTELNETs_AcceptClient is used. It is part of the template file Telnet_Server_Access.c. If this template file is missing in the µVision project, the function will not be available and thus connections from all remote clients will be accepted. You need to adapt the function to the application's needs by specifying the rules for allowed/blocked clients. The Telnet server will use the information in this function to filter the access.

The multi-user login allows you to create different profiles for different users or groups of users. The profiles define the access rights to different commands executed on the Telnet server. The users which are allowed to access the Telnet server are stored in an user database.

If you want to use multi-user authentication, you need to check the Enable User Authentication in the configuration file (Net_Config_Telnet_Server.h). The default account is a system administrator account, which has no restrictions. All other accounts are created in a separate Telnet_Server_Multiuser.c module.

To enable a list of users, you need to adapt the function netTELNETs_CheckUsername, which checks if the user account exists for the provided credentials, and the function netTELNETs_CheckPassword, which checks if the password fits to the user account for the provided credentials.

The following function is included in the Network Component library rl_net_ds.h:

Note
  • To add the template files to your project, simply right-click on the Source group, select Add New Item to Group, then click on User Code Template and scroll in the template files list until you find the required template.
  • If the Telnet_Server_Multiuser.c is not added to the project, but authentication is enabled, the Telnet server runs in single user authentication mode.