Node configuration for user access and Template:Main Page pdf: Difference between pages

From The DXSpider Documentation Wiki
(Difference between pages)
Jump to navigation Jump to search
 
No edit summary
 
Line 1: Line 1:
<div style="background:#f9f9f9;padding:0px;border:1px solid #aaaaaa;margin-bottom:15px">
<div style="font-size:125%;color:#336699;padding:0.4em;background-color:#eeeeee;border-bottom:1px solid #aaaaaa;vertical-align:top">


*'''Manuals'''


==='''User Registration'''===
</div>
----
<div style="background-color:#fff;padding:0.4em 0.4em 0.4em 0.4em;font-size:95%">
There are two types of user in a DXSpider node, a registered user and an unregistered user.  
* [https://wiki.dxcluster.org/index.php/Authors_and_Contributors Authors and Contributors]
By default, all users belong to the unregistered category.
* [https://wiki.dxcluster.org/index.php/DXSpider_User_Manual User Manual]
* [https://wiki.dxcluster.org/index.php/DXSpider_Installation_Manual_(New) Installation Manual (New)]
* [https://wiki.dxcluster.org/index.php/DXSpider_Configuration_Manual Configuration Manual (New)]
* [https://wiki.dxcluster.org/index.php/Node_configuration_for_user_access Node configuration for user access (New)]
* [https://wiki.dxcluster.org/index.php/DXSpider_Installation_Manual Installation Manual (Legacy)]
* [https://wiki.dxcluster.org/index.php/DXSpider_Administration_Manual Administration Manual (Legacy)]
* [https://wiki.dxcluster.org/index.php/DXSpider_Filtering_Manual Filtering Manual]
* [https://wiki.dxcluster.org/index.php/DXSpider_FAQ FAQ]
* [https://wiki.dxcluster.org/index.php/DXSpider_Command_Reference Command Reference]


==='''Node in UNREGISTERED Mode'''===
The [http://www.dxcluster.org/download/ latest release] of the DXSpider program can be downloaded from http://www.dxcluster.org.  You can choose to get the latest release of the program or get the latest
----
This is the default way of working, but not necessarily the best.


The global variable that sets the node type is '''$main::reqreg'''
*[http://www.dxcluster.org/download/CVSlatest.tgz CVS snapshot for Linux]
and its default value is '''0'''.
*[http://www.dxcluster.org/download/CVSlatest.zip CVS snapshot for Windows]
<pre>
  set/var $main::reqreg = 0
</pre>


In this mode the sysop doesn't have to register users, but if they are registered, then it will simply be a database entry.
<font style="color:red">hot</font> off the press!
Both types of user will have the same capabilities to send and receive SPOTS, ANN, etc
</div>
 
</div>
==='''Node in REGISTRATION Mode'''===
----
To activate registration, the global variable '''$main::reqreg''' must be set to '''1'''.
The way to change it is
 
<pre>
  set/var $main::reqreg = 1
</pre>
 
When this mode is activated, only users that the sysop has registered will be able to send and receive SPOTS, ANN, etc.  Unregistered users will only be able to receive information.
 
The way to register/unregister a user is as follows:
<pre>
  set/register <call>
  unset/register <call>
</pre>
 
You can check which users we have registered using
 
<pre>
  sh/register <call>
</pre>
 
A specific login banner for registered users can be shown. The file containing it is the following
 
<pre>
  /spider/_local_data/motd
</pre>
 
When an unregistered user starts the login process, they can be sent a different file that can be configured to say that they are not registered and how to register should they wish to do so.  This file is ...
 
<pre>
  /spider/local_data/motd_nor
</pre>
 
==='''Password Usage'''===
----
By default, a user does not get prompted for a password at login. For additional security, a user can request a password be set for them.  They simply need to request a password that they provide to the sysop.
 
It should be noted that this only works on the node they regularly use.  Their password is not propagated across the network for security reasons.
 
For a user to be assigned a password, the sysop needs to use the command ...
 
<pre>
  set/password <call> <string>
</pre>
 
and the user can change his password with the command
 
<pre>
  set/password
Enter old password:
Enter new password:
Re-enter new password:
  Password changed
</pre>
 
==='''Node in NO PASSWORD Mode'''===
----
The global variable '''$main::passwdreq''' is set to '''0''' by default.  This does not mean that they cannot have a password set, only that users are not forced to have a password.
 
 
To see the value of the variable use ...
 
<pre>
  sh/var $main::passwdreq
</pre>
 
==='''Node in PASSWORD Mode'''===
----
If we set the '''$main::passwdreq''' variable to '''1''', we will force any user logging in to the node to use a password as well as their callsign, otherwise they will not be able to access the node.
 
The node will not establish the session if there is no positive authentication.
 
To set this mode of operation:
 
<pre>
  set/var $main::passwdreq = 1
</pre>
 
==='''How To protect your cluster node (Recommended configuration)'''===
 
----
One way to control the correct use of our node, is to use the combination of registration and password as follows.
 
We enable the registration for all the users
 
<pre>
  set/var $main::reqreg = 1
</pre>
 
The beauty of this is that people who try to login with callsigns like ID1OT or even using random callsigns cannot post spots or announcements from the node.
 
Unless the cluster node is a small club node or similar, it is probably a good idea not to force people to have a password.  It may put some people off and it will be a LOT of work for the sysop.  Most users will be protected by registration
 
<pre>
  set/var $main::passwdreq = 0
</pre>
 
Of course, a user may wish to have a password set to increase their security on the node, meaning that unless someone also knows the password, their call cannot be used by someone else unless they know the password.
 
<pre>
  set/register <call>
  set/password <call> <string>
</pre>
 
It is <b>strongly</b> suggested that sysops enable registration to try and combat the increasing misuse on the cluster network
 
==='''Make Changes Permanent'''===
----
Although sysops can enable or disable these variables at any time from the console, this will only be enabled until the node is restarted. if we want to keep them during the startup of the node, we must edit the file ...
 
<pre>
  /spider/scripts/startup
</pre>
 
and include the following lines
<pre>
  set/var $main::reqreg = 1
  set/var $main::passwdreq = 0
</pre>
 
The changes to this file will not take effect until there is a reboot, so we can activate it manually the first time from the console by typing
<pre>
  set/var $main::reqreg = 1
  set/var $main::passwdreq = 0
</pre>

Revision as of 17:58, 10 February 2023