From 4e036e7f6c93e12476a319766ee8464fd99f4d3f Mon Sep 17 00:00:00 2001 From: Shivaram Lingamneni Date: Sun, 17 Jan 2021 21:27:45 -0500 Subject: [PATCH] stopgap documentation update for SASL See #1488 --- README.md | 13 +++++++------ docs/MANUAL.md | 2 ++ 2 files changed, 9 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index e58a4afa..2d5ca39b 100644 --- a/README.md +++ b/README.md @@ -103,16 +103,17 @@ oragono genpasswd With this, you receive a blob of text which you can plug into your configuration file. -### How to register a channel +### Nickname and channel registration -1. Register your account with `/NS REGISTER ` -2. Join the channel with `/join #channel` -3. Register the channel with `/CS REGISTER #channel` +Oragono relies heavily on user accounts to enable its distinctive features (such as allowing multiple clients per nickname). As a user, you can register your current nickname as an account using `/msg NickServ register `. Once you have done so, you should [enable SASL in your clients](https://freenode.net/kb/answer/sasl), ensuring that you will be automatically logged into your account on each connection. This will prevent [problems claiming your registered nickname](https://github.com/oragono/oragono/blob/master/docs/MANUAL.md#nick-equals-account). + +Once you have registered your nickname, you can use it to register channels: + +1. Join the channel with `/join #channel` +2. Register the channel with `/CS REGISTER #channel` After this, your channel will remember the fact that you're the owner, the topic, and any modes set on it! -Make sure to setup [SASL](https://freenode.net/kb/answer/sasl) in your client to automatically login to your account when you next join the server. - # Credits diff --git a/docs/MANUAL.md b/docs/MANUAL.md index a6640bb8..26134b36 100644 --- a/docs/MANUAL.md +++ b/docs/MANUAL.md @@ -261,6 +261,8 @@ In this mode (the default), registering an account gives you privileges over the 1. You must use your nickname, i.e., if you are logged into your account, then the server will require you to use your account name as your nickname 1. If you unregister your account, your nickname will be permanently unreclaimable (thus preventing people from impersonating you) +In this mode, it is very important that end users authenticate to their accounts as part of the initial IRC handshake (traditionally referred to as "connection registration"); otherwise they will not be able to use their registered nicknames. The preferred mechanism for this is [SASL](https://freenode.net/kb/answer/sasl), which is supported by most modern clients. As a fallback, this can also be done via the `PASS` (server password) command; set the "server password" field of the client to `AzureDiamond:hunter2`, where `AzureDiamond` is the account name and `hunter2` is the account password. + As an end user, if you want to change your nickname, you can register a new account and transfer any channel ownerships to it using `/msg ChanServ transfer`. To enable this mode as the server operator, set the following configs (note that they are already set in `default.yaml`):