Difference between revisions of "Matrix"

From Software Heritage Wiki
Jump to: navigation, search
(IRC authentication)
(10 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 
== IRC channels ==
 
== IRC channels ==
  
The following channels have been registered on the [https://freenode.net/ Freenode] network for [[Software Heritage]] usage.
+
The following channels have been registered on the [https://libera.chat/ libera.chat] IRC network for [[Software Heritage]] usage.
  
* '''#softwareheritage''': general discussions about the project (currently unused)
+
* [https://app.element.io/#/room/#swh-devel:matrix.org '''#swh-devel''']: public development discussions
* '''#swh''': ditto, in case we end up preferring the short version
+
* [https://app.element.io/#/room/#swh-sysadm:matrix.org '''#swh-sysadm''']: operations team discussions/bots
* '''#swh-devel''': public development discussions
+
* [https://app.element.io/#/room/#swh-offtopic:matrix.org '''#swh-offtopic''']: Off-topic discussions
* '''#swh-team''': private discussions of the core team
+
* [https://app.element.io/#/room/#swh-team:matrix.org '''#swh-team''']: private discussions of the core team
* '''#swh-sysadm''': private discussions of the sysadm/operations team
 
  
If you do IRC, consider joining the channels.
 
  
 +
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 [https://matrix.org/ Matrix] bridge by clicking on the channel names in the list above. You will be asked to create a [https://element.io/ Element] account if you don't have one yet.
  
 
== IRC authentication ==
 
== IRC authentication ==
  
You should register their nick with NickServ using:
+
<b>Libera.chat defaults to blocking private messages from unauthentified users! All users should register their nicknames to be able to message one another privately, by following the instructions below.</b> If you're really unable to register, you should ask your correspondent to [https://libera.chat/guides/usermodes consider setting usermode <tt>-R</tt>, and <tt>+g</tt>]
 +
 
 +
To register an account with NickServ, please follow [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].
  
/nick <USERNAME>
+
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
/msg nickserv register <PASSWORD> <EMAIL>
 
  
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 recommanded way of doing that is using [https://freenode.net/kb/answer/sasl SASL authentication].
+
libera.chat also supports authentication via [https://libera.chat/guides/certfp TLS client certificates (using SASL EXTERNAL)].
  
For Weechat:
+
=== Matrix bridge ===
  
  /set irc.server.freenode.sasl_username <USERNAME>
+
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:
  /set irc.server.freenode.sasl_password <PASSWORD>
+
 
 +
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 ==
 
== 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.
  
/msg chanserv access #swh-devel add zack +V
+
If you already have the right (+o ChanServ flag), you can make yourself an operator, with:
  
 +
/msg chanserv OP #swh-devel
  
 
[[Category:Infrastructure]]
 
[[Category:Infrastructure]]

Revision as of 15:53, 15 June 2021

IRC channels

The following channels have been registered on the libera.chat IRC network for Software Heritage usage.


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

Libera.chat defaults to blocking private messages from unauthentified users! All users should register their nicknames to be able to message one another privately, by following the instructions below. If you're really unable to register, you should ask your correspondent to consider setting usermode -R, and +g

To register an account with NickServ, please follow 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