GitHub/pbot
3
0
Fork 0
mirror of https://github.com/pragma-/pbot.git synced 2024-11-22 11:59:43 +01:00
Code Issues Projects Releases Wiki Activity

QuickStart.md: document SSL/TLS!

Browse Source
This commit is contained in:
Pragmatic Software 2021-07-10 09:44:25 -07:00
parent 2b75863ebb
commit 3ad47ad67b
1 changed files with 10 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
doc/QuickStart.md
View File

@ -136,9 +136,10 @@ irc.botnick | IRC nickname. This is the name people see when you talk. _Required
irc.username | IRC username. This is the `USER` field of your hostmask. | pbot3 irc.username | IRC username. This is the `USER` field of your hostmask. | pbot3
irc.realname | IRC gecos/realname. This is the `general information` or `real-name` field, as seen in `WHOIS`. | https://github.com/pragma-/pbot irc.realname | IRC gecos/realname. This is the `general information` or `real-name` field, as seen in `WHOIS`. | https://github.com/pragma-/pbot
irc.server | IRC server address to connect. | irc.libera.chat irc.server | IRC server address to connect. | irc.libera.chat
irc.port | IRC server port. | 6667 irc.port | IRC server port. | 6667 (secure port: 6697)
irc.identify_password | Password to authenticate with services or bots. | _undefined_ irc.identify_password | Password to authenticate with services or bots. | _undefined_
irc.sasl | Whether to use the IRCv3 SASL authentication mechanism. | 0 irc.sasl | Whether to use the IRCv3 SASL authentication mechanism. | 0
irc.ssl | Whether to use SSL/TLS encryption. | 0 (1 to enable)
general.trigger | Bot trigger. Can be a character class containing multiple trigger characters. Can be overridden per-channel. | [!] general.trigger | Bot trigger. Can be a character class containing multiple trigger characters. Can be overridden per-channel. | [!]
For a list of other available settings see [this table](Registry.md#list-of-known-registry-items) in the [Registry documentation](Registry.md). For a list of other available settings see [this table](Registry.md#list-of-known-registry-items) in the [Registry documentation](Registry.md).
@ -146,10 +147,14 @@ For a list of other available settings see [this table](Registry.md#list-of-know
#### Recommended settings for IRC Networks #### Recommended settings for IRC Networks
##### Libera.Chat ##### Libera.Chat
The default settings are tailored for the Libera.Chat IRC network. It is strongly recommended that The default settings are tailored for an insecure connection to the Libera.Chat IRC network.
you register an account with NickServ and to enable SASL authentication. Register your channels with To make the connection secure, set `irc.ssl` to `1`. This will enable SSL/TLS encryption.
ChanServ. You may request a host cloak from Libera staff. This will protect your nickname, IP address You may optionally set `irc.ssl_ca_path` or `irc.ssl_ca_file` if necessary. Be sure to
and channels. set `irc.port` to `6697` for the secure port.
It is strongly recommended that you register an account with NickServ and to enable SASL authentication.
Register your channels with ChanServ. You may request a host cloak from Libera staff. This will protect
your nickname, channels and IP address.
Once you register with NickServ, it is strongly recommended to enable `irc.sasl`. If you Once you register with NickServ, it is strongly recommended to enable `irc.sasl`. If you
choose not to use IRCv3 SASL authentication, then it is recommended to set these options: choose not to use IRCv3 SASL authentication, then it is recommended to set these options: