Matrix-IRC

Tarvisiko sillata IRCNet-kanava Matrixiin "paremmalla tavalla" eli plumbaamalla? Plumbaamalla saat kanavalle admin-oikeudet Matrixin puolelle josta on riemua joissain tilanteissa.

Homma on vähän kimuranttia mutta näillä ohjeilla pitäisi onnistua.

Valmistelu

• Luo Matrix-kanava ellei ole jo. ÄLÄ laita päästä päähän-salausta päälle.
• Luo IRC-kanava, ellei ole jo liittymällä siihen. Huolehdi että sinulla (tai avustajallasi) on op-status kanavalla.

Tarvitset seuraavat tiedot:

• IRC-siltabotin mxid - IRCNetissä @ircnet:irc.snt.utwente.nl
• Oma mxid - @sina:palvelin.org
• IRC-kanavan nimi - #esimerkki
• IRC-käyttäjän nick, jolla on opit #esimerkki -kanavalla - opin_nick
• Matrix-kanavan id - Alkaa huutomerkillä ja löytyy Element Webistä kanavan asetuksista Advanced | Internal room ID: !paLjOnKirJAimiA:palvelin.fi

Valmistelu

• Kutsu IRC-siltabotti Matrix-kanavalle - Matrixissa /invite @ircnet:irc.snt.utwente.nl
• Aseta IRC-siltabotille admin-oikeudet Matrixissa.
• JOS IRC-kanava on invite only (+i), kutsu IRC-siltabotti sinne: IRCissä /invite SNTMatrixBot

JSON-pyyntö

Tee seuraavanlainen curl-komento (kirjoita vaikka tekstieditorissa ja copypastea terminaaliin):

curl --location --request POST 'https://matrix-irc.snt.utwente.nl/ircnet/provision/link' --header 'Content-Type: application/json' --data-binary '{
 "remote_room_server": "irc.snt.utwente.nl",
 "remote_room_channel": "#esimerkki",
 "matrix_room_id": "!paLjOnKirJAimiA:palvelin.fi",
 "op_nick": "opin_nick",
 "user_id": "@sina:palvelin.org"
}'

Vahvistus

Siltabotti kysyy nyt opin_nick-käyttäjältä IRC:ssä yksityisviestissä:

<SNTMatrixBot> @sina:palvelin.org has requested to bridge 'Kanavan nimi' (https://matrix.to/#/#kanava:palvelin.org) with #esimerkki on this IRC network. Respond with 'yes' or 'y' to allow, or simply ignore this message to disallow. You have 600 seconds from when this message was sent.

Vastaa: yes

Silta on nyt valmis! Jos on ongelmia, kysele IRCNet-sillan kanavalla #ircnet:utwente.io

Lopuksi

Tässä vaiheessa on varsinkin uudella kanavalla hyvä varmistaa että kanava on salainen +s ja vain opit voivat vaihtaa topicin +t. Lisäksi kannattaa asettaa reop-lista +R jotta opit eivat katoa IRCin puolella. Huomaa että Matrix-sillan luomilla IRCNet-käyttäjillä on uniikki pysyvä IPv6-osoite, eli sitä voi käyttää reop-listalla.

Sano IRC-käyttäjänä:

/mode #esimerkki +st +R *!matrixuuser@2001:xxx:yyy:zzz:0:0:0:xxxx +R *!ircuuseri@palvelin.fi

Kanavan päivitys

IRC-silta OSAA seurata kanavapäivitystä. Jos päivität kanavan uuteen versioon, silta tunnistaa sen ja käyttäjät tulevat automaattisesti kanavalle. Tämä tosin tapahtuu vasta kun käyttäjä sanoo jotakin tai silta käynnistetään uudelleen.