DXSpider Registration Support System: Difference between revisions

From DXSpider Documentation Wiki
Jump to navigation Jump to search
EA3CV (talk | contribs)
No edit summary
EA3CV (talk | contribs)
No edit summary
Line 104: Line 104:
my $msg_text_ok = <<"EMAIL";
my $msg_text_ok = <<"EMAIL";
...
...
EMAIL
EMAIL</syntaxhighlight>
</syntaxhighlight>


You can change these to fit your tone and language.
You can change these to fit your tone and language.
Line 121: Line 120:
Regards,
Regards,


Kin EA3CV
Kin EA3CV</pre>
</pre>


=== Confirmation Message ===
=== Confirmation Message ===
Line 144: Line 142:
Enjoy.
Enjoy.


Kin EA3CV
Kin EA3CV</pre>
</pre>


=== Denial Message ===
=== Denial Message ===
Line 161: Line 158:
You may try again later if you wish.
You may try again later if you wish.


Kin EA3CV
Kin EA3CV</pre>
</pre>


=== Telegram Notifications ===
=== Telegram Notifications ===
Line 173: Line 169:
   Email: name@domain.net
   Email: name@domain.net
   Sent by: EA3CV
   Sent by: EA3CV
   IP: 1.2.3.4
   IP: 1.2.3.4</pre>
  </pre>


* Approval:
* Approval:
   <pre>
   <pre>
   ✅ Registered EA0ABC-2 in EA3CV-3
   ✅ Registered EA0ABC-2 in EA3CV-3</pre>
  </pre>


* Denial:
* Denial:
   <pre>
   <pre>
   ❌ Registration denied for EA0ABC-2 on EA3CV-3
   ❌ Registration denied for EA0ABC-2 on EA3CV-3</pre>
  </pre>


== ✅ Commands Summary ==
== ✅ Commands Summary ==

Revision as of 17:13, 11 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.

📌 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:

🧩 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 EA3CVea3cv@cronux.net April 2025