DXSpider Registration Support System

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

DXSpider Registration & Password Assistant System

📌 Purpose This system provides a user-friendly assistant for managing user registrations and passwords in DXSpider. It includes:

- 📬 Sending bilingual emails (Spanish/English) to users. - 📲 Optional Telegram notifications to the sysop. - ⚙️ Three modular commands that can work independently or as a complete workflow:

 - `msg_sysop`
 - `auth_register`
 - `deny_register`

All user-facing text (email bodies, etc.) is editable for customization.

🧰 Included Commands

msg_sysop.pl

- Sends a message from a user to the sysop via email and/or Telegram. - Optionally adds the user to a pending registration list if subject includes `REGISTER`.

auth_register.pl

- Authorizes a user in `pending_reg.txt`. - Registers the user in DXSpider. - Sends a bilingual welcome email with username/password. - Sends a Telegram notification to the sysop.

deny_register.pl

- Denies a user registration from `pending_reg.txt`. - Sends a bilingual rejection email to the user. - Sends a Telegram notification to the sysop.

📄 How to Use

=== From the DXSpider shell:

Send a registration request:
  msg_sysop EA0ABC-2 REGISTER name@domain.net Registration request
Authorize a registration:
  auth_register EA0ABC-2
Deny a registration:
  deny_register EA0ABC-2

📦 Requirements

=== DXVars.pm Located at: `/spider/local/DXVars.pm`

You must include at the bottom (before `1;`) the following configuration:

```perl

  1. Telegram config

$id = "123456789"; # Your Telegram chat ID $token = "123456789:ABCdEfGhIjKlmNo"; # Telegram bot token

  1. Email SMTP config

$email_enable = 1; $email_from = 'sysop@example.net'; $email_smtp = 'smtp.provider.net'; $email_port = 587; # 587 for STARTTLS or 465 for SSL $email_user = 'smtpuser@example.net'; $email_pass = 'smtppassword'; ```

=== Local.pm File: `/spider/local/Local.pm`

📥 Download: https://github.com/EA3CV/dxspider_info/blob/main/Local.pm

== 🔧 Installation

1. Download the scripts:

```text /spider/local_cmd/msg_sysop.pl /spider/local_cmd/auth_register.pl /spider/local_cmd/deny_register.pl ```

📥 Download them from:

- https://github.com/EA3CV/dxspider_info/blob/main/msg_sysop.pl - https://github.com/EA3CV/dxspider_info/blob/main/auth_register.pl - https://github.com/EA3CV/dxspider_info/blob/main/deny_register.pl

2. Make sure `/spider/local/Local.pm` is updated.

3. Restart DXSpider: ```bash ./cluster.pl restart ```

== 🧩 Required Perl Modules

Install the following modules using `cpan`:

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

== 📂 Files Used

- `/spider/local_cmd/msg_sysop.pl` - `/spider/local_cmd/auth_register.pl` - `/spider/local_cmd/deny_register.pl` - `/spider/local/Local.pm` - `/spider/local_data/pending_reg.txt` (created automatically)

== ✉️ Emails Sent to Users

=== Message confirmation: _Subject_: Message received for EA3CV-3 sysop

``` En breve recibira una respuesta. Saludos.

You will receive a response shortly. Regards,

Kin EA3CV ```

=== Welcome after auth_register: _Subject_: Aceptada su solicitud de registro / 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 ```

=== Rejection after deny_register: _Subject_: Solicitud de acceso denegada / 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 Messages (to sysop)

From msg_sysop:

``` 📡 Message from DXSpider command: Call: EA0ABC-2 Subject: REGISTER Email: name@domain.net Sent by: EA3CV IP: 1.2.3.4

Registration request ```

From auth_register:

``` ✅ Registered EA0ABC-2 in EA3CV-3 ```

From deny_register:

``` ❌ Registration denied for EA0ABC-2 on EA3CV-3 ```

== 📑 Command Outputs (user view)

From `msg_sysop`:

``` Message sent to sysop.

  Call: EA0ABC-2

Subject: REGISTER

 Email: name@domain.net

Message: Registration request ```

From `auth_register`:

``` ✔️ Registration completed for EA0ABC-2

  Email: name@domain.net
  IP:    1.2.3.4
  Pass:  5B54gqGz

```

From `deny_register`:

``` ✔️ Registration denied for EA0ABC-2

  Email: name@domain.net
  IP:    1.2.3.4

```

== ✏️ Customizing Texts

Each script includes a section at the beginning where you can edit the bilingual email content. Modify these strings to suit your cluster style or tone.

== 👤 Author

📧 Kin EA3CV — [ea3cv@cronux.net](mailto:ea3cv@cronux.net) April 2025