Difference between revisions of "Matrix"
(→IRC access list: add command to op yourself) |
(Update instructions for libera.chat and new matrix rooms.) |
||
| Line 1: | Line 1: | ||
== IRC channels == | == IRC channels == | ||
| − | The following channels have been registered on the [https:// | + | The following channels have been registered on the [https://libera.chat/ libera.chat] IRC network for [[Software Heritage]] usage. |
| + | |||
| + | * [https://app.element.io/#/room/#swh-devel:matrix.org '''#swh-devel''']: public development discussions | ||
| + | * [https://app.element.io/#/room/#swh-sysadm:matrix.org '''#swh-sysadm''']: operations team discussions/bots | ||
| + | * [https://app.element.io/#/room/#swh-offtopic:matrix.org '''#swh-offtopic''']: Off-topic discussions | ||
| + | * [https://app.element.io/#/room/#swh-team:matrix.org '''#swh-team''']: private discussions of the core team | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
If you use IRC, consider joining the channels. | If you use IRC, consider joining the channels. | ||
| Line 15: | Line 15: | ||
== IRC authentication == | == IRC authentication == | ||
| − | You should register | + | You should register your nickname with NickServ following [https://libera.chat/guides/registration the registration instructions provided by libera.chat staff]. |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| + | You will then receive an e-mail containing a link to activate you account. After doing so, you need to configure your client to auto-authenticate. The recommended way of doing that is using [https://libera.chat/guides/sasl SASL authentication]. | ||
For matrix, the relevant docs is here: https://github.com/matrix-org/matrix-appservice-irc/wiki/End-user-FAQ#how-do-i-registeridentify-to-nickserv | For matrix, the relevant docs is here: https://github.com/matrix-org/matrix-appservice-irc/wiki/End-user-FAQ#how-do-i-registeridentify-to-nickserv | ||
| − | + | libera.chat also supports authentication via [https://libera.chat/guides/certfp TLS client certificates (using SASL EXTERNAL)]. | |
=== Matrix bridge === | === Matrix bridge === | ||
| − | For the Matrix bridge ([https://github.com/matrix-org/matrix-appservice-irc/wiki/End-user-FAQ#how-do-i-registeridentify-to-nickserv relevant docs here]), | + | For registering an account through the Matrix bridge ([https://github.com/matrix-org/matrix-appservice-irc/wiki/End-user-FAQ#how-do-i-registeridentify-to-nickserv relevant docs here]), please follow these instructions: |
| − | + | 1. Choose a short nickname (the default nickname picked by the matrix bridge has a [m] and can be quite long, as it defaults to the full local part of your matrix handle) | |
| − | + | /msg @appservice:libera.chat !nick <USERNAME> | |
| − | + | 2. Send this command to NickServ to register your account: | |
| − | + | /msg @NickServ:libera.chat register <PASSWORD> <EMAIL> | |
| − | + | 3. Once you receive the confirmation email with a token, activate your account by using: | |
| − | + | /msg @NickServ:libera.chat VERIFY REGISTER <USERNAME> <TOKEN RECEIVED BY EMAIL> | |
| − | /msg @appservice | + | 4. Give the Matrix bridge appservice your password so that you get identified automatically when matrix reconnects you to IRC: |
| + | |||
| + | /msg @appservice:libera.chat !username <USERNAME> | ||
| + | /msg @appservice:libera.chat !storepass <PASSWORD> | ||
== IRC access list == | == IRC access list == | ||
| − | To auto-voice people with a registered nick (only doable by people with +fA access modes will be able to do it), add them to the channel access list: | + | To auto-voice people with a registered nick (only doable by people with +fA access modes will be able to do it), add them to the team channel access list: |
| + | |||
| + | /msg chanserv flags #swh-team add <nickname> Staff | ||
| − | + | Other channels pick their ACLs from that of the #swh-team channel. | |
If you already have the right (+o ChanServ flag), you can make yourself an operator, with: | If you already have the right (+o ChanServ flag), you can make yourself an operator, with: | ||
Revision as of 16:03, 8 June 2021
IRC channels
The following channels have been registered on the libera.chat IRC network for Software Heritage usage.
- #swh-devel: public development discussions
- #swh-sysadm: operations team discussions/bots
- #swh-offtopic: Off-topic discussions
- #swh-team: private discussions of the core team
If you use IRC, consider joining the channels.
If you don't use IRC directly, you can still join our chat channels from your web browser via a Matrix bridge by clicking on the channel names in the list above. You will be asked to create a Element account if you don't have one yet.
IRC authentication
You should register your nickname with NickServ following the registration instructions provided by libera.chat staff.
You will then receive an e-mail containing a link to activate you account. After doing so, you need to configure your client to auto-authenticate. The recommended way of doing that is using SASL authentication.
For matrix, the relevant docs is here: https://github.com/matrix-org/matrix-appservice-irc/wiki/End-user-FAQ#how-do-i-registeridentify-to-nickserv
libera.chat also supports authentication via TLS client certificates (using SASL EXTERNAL).
Matrix bridge
For registering an account through the Matrix bridge (relevant docs here), please follow these instructions:
1. Choose a short nickname (the default nickname picked by the matrix bridge has a [m] and can be quite long, as it defaults to the full local part of your matrix handle)
/msg @appservice:libera.chat !nick <USERNAME>
2. Send this command to NickServ to register your account:
/msg @NickServ:libera.chat register <PASSWORD> <EMAIL>
3. Once you receive the confirmation email with a token, activate your account by using:
/msg @NickServ:libera.chat VERIFY REGISTER <USERNAME> <TOKEN RECEIVED BY EMAIL>
4. Give the Matrix bridge appservice your password so that you get identified automatically when matrix reconnects you to IRC:
/msg @appservice:libera.chat !username <USERNAME> /msg @appservice:libera.chat !storepass <PASSWORD>
IRC access list
To auto-voice people with a registered nick (only doable by people with +fA access modes will be able to do it), add them to the team channel access list:
/msg chanserv flags #swh-team add <nickname> Staff
Other channels pick their ACLs from that of the #swh-team channel.
If you already have the right (+o ChanServ flag), you can make yourself an operator, with:
/msg chanserv OP #swh-devel