Revision as of 18:01, 13 April 2025

DXSpider Registration Support System

📡 DXSpider Registration Support System provides a user-friendly way for sysops to manage registration requests via email and/or Telegram, with clear messages and configurable templates in Spanish and English (default).

📌 Purpose

This system adds simple tools to support registration and password management on a DXSpider node. It allows users to send a request, and sysops to authorize or deny it with minimal effort, while keeping a record of all registration requests and their acceptance or denial.

⚙️ Features

Users send requests via a simple command: msg_sysop
Sysops receive Telegram alerts and emails
Sysops can approve (auth_register) or reject (deny_reg) registrations
Sends multilingual confirmation/denial messages to users
Configurable templates for email content (Spanish/English)

📥 Commands Usage

The system uses three main commands for managing user registrations:

msg_sysop

Used by the user to send a registration request.

msg_sysop <user_call> REGISTER <user_email> <comments>

Example:

msg_sysop EA1ZZZ REGISTER ea1zzz@example.net I would like to join the cluster

auth_register

Used by the sysop to approve and register the user.

auth_reg <user_call>

Example:

auth_reg EA1ZZZ

deny_register

Used by the sysop to reject a registration request.

deny_reg <user_call>

Example:

deny_reg EA1ZZZ

📢 How It Works: Full Example

REGISTRATION REQUEST (msg_sysop)

User input from Telnet:

msg_sysop XX0ABC REGISTER xx0abc@domain.com Requesting access

Response to user

To sysop via email

Message sent to sysop.
   Call: XX0ABC
Subject: REGISTER
  Email: xx0abc@domain.com
Message: Requesting access

Subject: Msg received from XX0ABC (REGISTER) to EA3CV-2

New message via msg_sysop command:

Node: EA3CV-2
Call: XX0ABC
Subject: REGISTER
Email: xx0abc@domain.com
IP: 1.2.3.4
Message: Requesting access

To user via email

To sysop via Telegram

Asunto: Msg del sysop de / Msg from sysop of EA3CV-2

En breve recibira una respuesta.
Saludos.

You will receive a response shortly.
Regards,

Kin EA3CV

📡 Message from DXSpider command:
Date: 13 April 2025 16:35:02
Call: XX0ABC
Subject: REGISTER
Email: xx0abc@domain.com
Sent by: EA3CV
IP: 1.2.3.4
Requesting access

Entry in pending_reg.txt:

20250413-163500,00000000-000000,PENDING ,XX0ABC,u$2wGVX=,1.2.3.4,xx0abc@domain.com

REGISTRATION APPROVAL (auth_register)

Sysop input from Console:

auth_reg XX0ABC

Sysop output

To user via email

Registration completed for XX0ABC
Email: joaquin@cronux.net
IP:    127.0.0.1
Pass:  u$2wGVX=

Asunto: Aceptada su solicitud de registro / Registration accepted XX0ABC at EA3CV-2

Se ha aceptado su solicitud de registro

Usuario: XX0ABC
Password: u$2wGVX=

Use el comando `set/password` para cambiar la contraseña si lo desea.
Disfrute.

Your registration request has been approved.

User: XX0ABC
Password: u$2wGVX=

You can use the `set/password` command to change your password if you wish.
Enjoy.

Kin EA3CV

Entry in pending_reg.txt:

20250413-163500,20250413-164558,ACCEPTED,XX0ABC,u$2wGVX=,1.2.3.4,xx0abc@domain.com

REGISTRATION DENIAL (deny_register)

Sysop input from Console:

deny_reg XX0ABC

Sysop output

To user via email

Registration denied for XX0ABC
Email: joaquin@cronux.net
IP:    127.0.0.1

Asunto: Denegada su solicitud de registro / Registration denied XX0ABC at EA3CV-2

Se ha denegado su solicitud de registro.

Si cree que esto es un error, puede contactar con el administrador.
Gracias.

Your registration request has been denied.

If you believe this is a mistake, please contact the administrator.
Thank you.

Kin EA3CV

To sysop via Telegram

❌ DENIED registration of XX0ABC from 127.0.0.1

Entry in pending_reg.txt:

20250413-163500,20250413-165008,DENIED  ,XX0ABC,u$2wGVX=,1.2.3.4,xx0abc@domain.com

📂 Scripts Included

All scripts go in /spider/local_cmd/

Also required:

Local.pm → to /spider/local/Local.pm

🧩 Configuration: DXVars.pm

Append to /spider/local/DXVars.pm:

# Telegram config
$id = "123456789";
$token = "123456789:ABCDEF-TOKEN";

# Email SMTP config
$email_enable = 1;
$email_from = 'you@example.com';
$email_smtp = 'smtp.example.com';
$email_port = 587;
$email_user = 'your_user';
$email_pass = 'your_pass';

📑 Files Used

/spider/local_data/pending_reg.txt — Automatically created
/spider/local_cmd/*.pl — Command scripts
/spider/local/Local.pm — Email & Telegram logic
/spider/local/DXvars.pm — Email and Telegram variables

🔧 Installation

Copy the scripts to /spider/local_cmd/
Edit /spider/local/DXVars.pm with your email and Telegram settings
Install required Perl modules (see below)
Restart the DXSpider node

📦 Required Perl Modules

Install with CPAN (from Linux shell):

cpan Net::SMTP
cpan Net::SMTP::SSL
cpan Net::MQTT::Simple

✏️ Template Customization

Each script includes variables where you can modify the bilingual message content. Look for blocks like:

my $msg_text_ok = <<"EMAIL";
...
EMAIL

✅ Commands Summary

Command	Description
`msg_sysop`	User sends registration request
`auth_register`	Sysop approves and registers the user
`deny_reg`	Sysop denies the request

👤 Author

Kin EA3CV — ea3cv@cronux.net April 2025

DXSpider Registration Support System: Difference between revisions

Revision as of 18:01, 13 April 2025

Contents

DXSpider Registration Support System

📌 Purpose

⚙️ Features

📥 Commands Usage

msg_sysop

auth_register

deny_register

📢 How It Works: Full Example

REGISTRATION REQUEST (msg_sysop)

REGISTRATION APPROVAL (auth_register)

REGISTRATION DENIAL (deny_register)

📂 Scripts Included

🧩 Configuration: DXVars.pm

📑 Files Used

🔧 Installation

📦 Required Perl Modules

✏️ Template Customization

✅ Commands Summary

👤 Author

Navigation menu

@@ Line 1: / Line 1: @@
 = DXSpider Registration Support System =
-📡 '''DXSpider Registration Support System''' provides a user-friendly way for sysops to manage registration requests via '''email''' and/or '''Telegram''', with clear messages and configurable templates in '''Spanish and English'''.
+📡 '''DXSpider Registration Support System''' provides a user-friendly way for sysops to manage registration requests via '''email''' and/or '''Telegram''', with clear messages and configurable templates in '''Spanish and English''' (default).
 == 📌 Purpose ==
-This system adds simple tools to support '''registration and password management''' on a DXSpider node. It allows users to send a request, and sysops to authorize or deny it with minimal effort.
+This system adds simple tools to support '''registration and password management''' on a DXSpider node. It allows users to send a request, and sysops to authorize or deny it with minimal effort, while keeping a record of all registration requests and their acceptance or denial.
 == ⚙️ Features ==
@@ Line 15: / Line 15: @@
 * Configurable templates for email content (Spanish/English)
-== 💬 How It Works ==
+== 📥 Commands Usage ==
-. '''User''' sends a message:
+The system uses three main commands for managing user registrations:
-   <pre>
-   msg_sysop EA0ABC-2 REGISTER name@domain.net Registration request</pre>
-. '''Sysop receives:'''
+=== msg_sysop ===
-   * 📧 Email with request details
+Used by the user to send a registration request.
-   * 📱 Telegram notification (optional)
-. '''Sysop approves:'''
+<pre>
-   <pre>
+msg_sysop <user_call> REGISTER <user_email> <comments>
-   auth_register EA0ABC-2</pre>
+</pre>
+Example:
+<pre>
+msg_sysop EA1ZZZ REGISTER ea1zzz@example.net I would like to join the cluster
+</pre>
+=== auth_register ===
+Used by the sysop to approve and register the user.
+<pre>
+auth_reg <user_call>
+</pre>
+Example:
+<pre>
+auth_reg EA1ZZZ
+</pre>
+=== deny_register ===
+Used by the sysop to reject a registration request.
+<pre>
+deny_reg <user_call>
+</pre>
+Example:
+<pre>
+deny_reg EA1ZZZ
+</pre>
+== 📢 How It Works: Full Example ==
+=== REGISTRATION REQUEST (msg_sysop) ===
-. '''User receives confirmation email''', e.g.:
+'''User input from Telnet:'''
-   <pre>
+<pre>
-   Subject: Registration accepted EA0ABC-2 at EA3CV-3
+msg_sysop XX0ABC REGISTER xx0abc@domain.com Requesting access
-   User: EA0ABC-2
+</pre>
-   Password: 5B54gqGz</pre>
-. '''Or sysop denies:'''
+{| class="wikitable" style="width:100%"
-   <pre>
+|-
-    deny_reg EA0ABC-2</pre>
+! style="width:50%; vertical-align:top;" | Response to user
+! style="width:50%; vertical-align:top;" | To sysop via email
+|-
+|
+<pre>
+Message sent to sysop.
+    Call: XX0ABC
+Subject: REGISTER
+  Email: xx0abc@domain.com
+Message: Requesting access
+</pre>
+|
+<pre>
+Subject: Msg received from XX0ABC (REGISTER) to EA3CV-2
-. '''User receives denial notice''', e.g.:
+New message via msg_sysop command:
-    <pre>
-   Subject: Access request denied for EA0ABC-2 on EA3CV-3</pre>
+Node: EA3CV-2
+Call: XX0ABC
+Subject: REGISTER
+Email: xx0abc@domain.com
+IP: 1.2.3.4
+Message: Requesting access
+</pre>
+|-
+! style="vertical-align:top;" | To user via email
+! style="vertical-align:top;" | To sysop via Telegram
+|-
+|
+<pre>
+Asunto: Msg del sysop de / Msg from sysop of EA3CV-2
+En breve recibira una respuesta.
+Saludos.
+You will receive a response shortly.
+Regards,
+Kin EA3CV
+</pre>
+|
+<pre>
+📡 Message from DXSpider command:
+Date: 13 April 2025 16:35:02
+Call: XX0ABC
+Subject: REGISTER
+Email: xx0abc@domain.com
+Sent by: EA3CV
+IP: 1.2.3.4
+Requesting access
+</pre>
+|}
+'''Entry in pending_reg.txt:'''
+<pre>
+20250413-163500,00000000-000000,PENDING ,XX0ABC,u$2wGVX=,1.2.3.4,xx0abc@domain.com
+</pre>
+=== REGISTRATION APPROVAL (auth_register) ===
+'''Sysop input from Console:'''
+<pre>
+auth_reg XX0ABC
+</pre>
+{| class="wikitable" style="width:100%"
+|-
+! style="width:50%; vertical-align:top;" | Sysop output
+! style="width:50%; vertical-align:top;" | To user via email
+|-
+|
+<pre>
+Registration completed for XX0ABC
+Email: joaquin@cronux.net
+IP:    127.0.0.1
+Pass:  u$2wGVX=
+</pre>
+|
+<pre>
+Asunto: Aceptada su solicitud de registro / Registration accepted XX0ABC at EA3CV-2
+Se ha aceptado su solicitud de registro
+Usuario: XX0ABC
+Password: u$2wGVX=
+Use el comando `set/password` para cambiar la contraseña si lo desea.
+Disfrute.
+Your registration request has been approved.
+User: XX0ABC
+Password: u$2wGVX=
+You can use the `set/password` command to change your password if you wish.
+Enjoy.
+Kin EA3CV
+</pre>
+|}
+'''Entry in pending_reg.txt:'''
+<pre>
+20250413-163500,20250413-164558,ACCEPTED,XX0ABC,u$2wGVX=,1.2.3.4,xx0abc@domain.com
+</pre>
+=== REGISTRATION DENIAL (deny_register) ===
+'''Sysop input from Console:'''
+<pre>
+deny_reg XX0ABC
+</pre>
+{| class="wikitable" style="width:100%"
+|-
+! style="width:50%; vertical-align:top;" | Sysop output
+! style="width:50%; vertical-align:top;" | To user via email
+|-
+|
+<pre>
+Registration denied for XX0ABC
+Email: joaquin@cronux.net
+IP:    127.0.0.1
+</pre>
+|
+<pre>
+Asunto: Denegada su solicitud de registro / Registration denied XX0ABC at EA3CV-2
+Se ha denegado su solicitud de registro.
+Si cree que esto es un error, puede contactar con el administrador.
+Gracias.
+Your registration request has been denied.
+If you believe this is a mistake, please contact the administrator.
+Thank you.
+Kin EA3CV
+</pre>
+|-
+! colspan="2" style="vertical-align:top;" | To sysop via Telegram
+|-
+|
+<pre>
+❌ DENIED registration of XX0ABC from 127.0.0.1
+</pre>
+|}
+'''Entry in pending_reg.txt:'''
+<pre>
+20250413-163500,20250413-165008,DENIED  ,XX0ABC,u$2wGVX=,1.2.3.4,xx0abc@domain.com
+</pre>
 == 📂 Scripts Included ==
@@ Line 68: / Line 245: @@
 $email_from = 'you@example.com';
 $email_smtp = 'smtp.example.com';
-$email_port = 587;       # Port 587 for STARTTLS/Port 465 for SSL)
+$email_port = 587;
 $email_user = 'your_user';
 $email_pass = 'your_pass';
@@ Line 78: / Line 255: @@
 * <code>/spider/local_cmd/*.pl</code> — Command scripts
 * <code>/spider/local/Local.pm</code> — Email & Telegram logic
-* <code> /spider/local/DXvars.pm</code> — email and Telegram variables
+* <code>/spider/local/DXvars.pm</code> — Email and Telegram variables
 == 🔧 Installation ==
@@ Line 95: / Line 272: @@
 cpan Net::SMTP::SSL
 cpan Net::MQTT::Simple
-cpan JSON
 </syntaxhighlight>
@@ Line 105: / Line 281: @@
 my $msg_text_ok = <<"EMAIL";
 ...
-EMAIL</syntaxhighlight>
+EMAIL
+</syntaxhighlight>
-You can change these to fit your tone and language.
-== 📧 Example Messages ==
-=== Request Received ===
-<pre>
-Subject: Message received for EA3CV-3 sysop
-En breve recibira una respuesta.
-Saludos.
-You will receive a response shortly.
-Regards,
-Kin EA3CV</pre>
-=== Confirmation Message ===
-<pre>
-Subject: Registration accepted EA0ABC-2 at EA3CV-3
-Se ha aceptado su solicitud de registro
-Usuario: EA0ABC-2
-Password: 5B54gqGz
-Use el comando `set/password` para cambiar la contraseña si lo desea.
-Disfrute.
-Your registration request has been approved.
-User: EA0ABC-2
-Password: 5B54gqGz
-You can use the `set/password` command to change your password if you wish.
-Enjoy.
-Kin EA3CV</pre>
-=== Denial Message ===
-<pre>
-Subject: Access request denied for EA0ABC-2 on EA3CV-3
-Lamentamos informarle que su solicitud de acceso para EA0ABC-2 ha sido denegada en EA3CV-3.
-No cumple con los criterios requeridos.
-Puede intentarlo más adelante si lo desea.
-We regret to inform you that your access request for EA0ABC-2 has been denied on EA3CV-3.
-It does not meet the required criteria.
-You may try again later if you wish.
-Kin EA3CV</pre>
-=== Telegram Notifications ===
-* Incoming request:
-  <pre>
-  📡 Message from DXSpider command:
-  Call: EA0ABC-2
-  Subject: REGISTER
-  Email: name@domain.net
-  Sent by: EA3CV
-  IP: 1.2.3.4</pre>
-* Approval:
-  <pre>
-  ✅ Registered EA0ABC-2 in EA3CV-3</pre>
-* Denial:
-  <pre>
-  ❌ Registration denied for EA0ABC-2 on EA3CV-3</pre>
 == ✅ Commands Summary ==
@@ Line 185: / Line 289: @@
 ! Command !! Description
 |-
-| <code>msg_sysop</code> || User sends registration request (and anothers)
+| <code>msg_sysop</code> || User sends registration request
 |-
 | <code>auth_register</code> || Sysop approves and registers the user
@@ Line 193: / Line 297: @@
 == 👤 Author ==
 '''Kin EA3CV''' — [mailto:ea3cv@cronux.net ea3cv@cronux.net] April 2025

DXSpider Registration Support System: Difference between revisions

Revision as of 18:01, 13 April 2025

DXSpider Registration Support System

📌 Purpose

⚙️ Features

📥 Commands Usage

msg_sysop

auth_register

deny_register

📢 How It Works: Full Example

REGISTRATION REQUEST (msg_sysop)

REGISTRATION APPROVAL (auth_register)

REGISTRATION DENIAL (deny_register)

📂 Scripts Included

🧩 Configuration: DXVars.pm

📑 Files Used

🔧 Installation

📦 Required Perl Modules

✏️ Template Customization

✅ Commands Summary

👤 Author

Navigation menu

Search