DXSpider Registration Support System

From DXSpider Documentation Wiki
Revision as of 17:08, 11 April 2025 by EA3CV (talk | contribs)
Jump to navigation Jump to search

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.

πŸ“Œ 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.

βš™οΈ 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)

πŸ’¬ How It Works

1. User sends a message:

   msg_sysop EA0ABC-2 REGISTER name@domain.net Registration request

2. Sysop receives:

  * πŸ“§ Email with request details
  * πŸ“± Telegram notification (optional)

3. Sysop approves:

   auth_register EA0ABC-2

4. User receives confirmation email, e.g.:

   Subject: Registration accepted EA0ABC-2 at EA3CV-3
   User: EA0ABC-2
   Password: 5B54gqGz

5. Or sysop denies:

   deny_reg EA0ABC-2

6. User receives denial notice, e.g.:

   Subject: Access request denied for EA0ABC-2 on EA3CV-3

πŸ“‚ 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;       # Port 587 for STARTTLS/Port 465 for SSL)
$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

πŸ”§ Installation

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

πŸ“¦ Required Perl Modules

Install with CPAN (from Linux shell):

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

✏️ Template Customization

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

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

You can change these to fit your tone and language.

πŸ“§ Example Messages

Request Received

Subject: Message received for EA3CV-3 sysop

En breve recibira una respuesta.
Saludos.

You will receive a response shortly.
Regards,

Kin EA3CV

Confirmation Message

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

Denial Message

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

Telegram Notifications

  • Incoming request:
  πŸ“‘ Message from DXSpider command:
  Call: EA0ABC-2
  Subject: REGISTER
  Email: name@domain.net
  Sent by: EA3CV
  IP: 1.2.3.4
  
  • Approval:
  βœ… Registered EA0ABC-2 in EA3CV-3
  
  • Denial:
  ❌ Registration denied for EA0ABC-2 on EA3CV-3
  

βœ… Commands Summary

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

πŸ‘€ Author

Kin EA3CV β€” ea3cv@cronux.net April 2025