To create new wiki account, please join us on #znc at Libera.Chat and ask admins to create a wiki account for you. You can say thanks to spambots for this inconvenience.
CService: Difference between revisions
Created page with "{{DISPLAYTITLE:cservice}} {{External Module}} The `CService` ZNC module provides secure login functionality for X on UnderNet, including support for 2FA/TOTP authentication and LoC (Login on Connect). It allows users to configure login details, enable/disable 2FA, and specify user modes. Sensitive data, such as passwords and 2FA secrets, are encrypted using AES-256 encryption for enhanced security. == Getting the Code == The code for this module can be found [https://g..." |
No edit summary |
||
| Line 8: | Line 8: | ||
== Compatibility == | == Compatibility == | ||
This module was compiled and tested with | This module was compiled and tested with '''ZNC 1.10'''. | ||
== Features == | == Features == | ||
| Line 14: | Line 14: | ||
* 2FA/TOTP Support: Enhance security by adding time-based one-time passwords. | * 2FA/TOTP Support: Enhance security by adding time-based one-time passwords. | ||
* LoC (Login on Connect): Log in to UnderNet automatically using the LoC feature. | * LoC (Login on Connect): Log in to UnderNet automatically using the LoC feature. | ||
* Custom User Modes: Set user mode prefixes ( | * Custom User Modes: Set user mode prefixes (<nowiki>-x!</nowiki>, <nowiki>+x!</nowiki>, or <nowiki>-!+x</nowiki>) during server connection. | ||
* Encrypted Credentials: Passwords and 2FA secrets are stored securely using AES-256 encryption. | * Encrypted Credentials: Passwords and 2FA secrets are stored securely using AES-256 encryption. | ||
| Line 54: | Line 54: | ||
==== setusermode ==== | ==== setusermode ==== | ||
Sets the user mode prefix for the server connection. Valid options are | Sets the user mode prefix for the server connection. Valid options are <nowiki>-x!</nowiki>, <nowiki>+x!</nowiki>, <nowiki>-!+x</nowiki>, or an empty string. | ||
<code> | <code> | ||
/msg *cservice setusermode +x! | /msg *cservice setusermode +x! | ||
Revision as of 10:05, 12 January 2025
 |
This is an external module. Please note that it may or may not work with the current release (1.9.1). This module is not included in the default ZNC installation, and you will need to manually compile it before you can load this module. Contact the author if you have any questions, but feel free to ask in #znc on Libera.Chat. Someone might be able to help you there. |
The `CService` ZNC module provides secure login functionality for X on UnderNet, including support for 2FA/TOTP authentication and LoC (Login on Connect). It allows users to configure login details, enable/disable 2FA, and specify user modes. Sensitive data, such as passwords and 2FA secrets, are encrypted using AES-256 encryption for enhanced security.
Getting the Code
The code for this module can be found here.
Compatibility
This module was compiled and tested with ZNC 1.10.
Features
- Secure Login: Authenticate with UnderNet using your username, password, and optional 2FA/TOTP.
- 2FA/TOTP Support: Enhance security by adding time-based one-time passwords.
- LoC (Login on Connect): Log in to UnderNet automatically using the LoC feature.
- Custom User Modes: Set user mode prefixes (-x!, +x!, or -!+x) during server connection.
- Encrypted Credentials: Passwords and 2FA secrets are stored securely using AES-256 encryption.
Usage
Arguments
This user module takes none arguments. No additional arguments are required to load the module. Use commands to configure settings.
Read loading modules to learn more about loading modules.
Commands
setusername
Sets the UnderNet username.
/msg *cservice setusername your_username
setpassword
Sets the UnderNet password. The password is stored securely using AES-256 encryption.
/msg *cservice setpassword your_password
setsecret
Sets the 2FA/TOTP secret key. The secret is stored securely using AES-256 encryption.
/msg *cservice setsecret your_2fa_secret
enable2fa
Enables 2FA/TOTP for secure logins.
/msg *cservice enable2fa
disable2fa
Disables 2FA/TOTP.
/msg *cservice disable2fa
setusermode
Sets the user mode prefix for the server connection. Valid options are -x!, +x!, -!+x, or an empty string.
/msg *cservice setusermode +x!
showconfig
Displays the current configuration settings.
/msg *cservice showconfig
Example Usage
1. Set your username:
/msg *cservice setusername MyUser
2. Set your password:
/msg *cservice setpassword MyPassword
3. Set your TOTP secret:
/msg *cservice setsecret ABCDEFGHIJKLMNOPQRSTUV
4. Enable 2FA:
/msg *cservice enable2fa
5. View your current configuration:
/msg *cservice showconfig
Notes
- Always generate a secure encryption key (`MASTER_KEY`) before compiling the module. Use the following OpenSSL command:
openssl rand -hex 32
Replace `MASTER_KEY` in the source code with the generated key.
- For changes to take effect, reload the module:
/znc unloadmod cservice
/znc loadmod cservice
See Also
For more information on UnderNet's Login on Connect (LoC) feature, visit UnderNet LoC.
Enjoy secure and seamless logins with the `CService` ZNC module!