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
- Botti EI liity kanavalle vielä. Voit silti tehdä seuraavan kohdan.
- Aseta IRC-siltabotille riittävät oikeudet Matrixissa (PL99 riittää): /op @ircnet:irc.snt.utwente.nl 99
- 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
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.
Tee näin ja tässä järjestyksessä:
- Hanki opit IRC-kanavalla oikealla IRC-käyttäjällä.
- Perusta uusi Matrix-kanava
- Pura silta (katso kohta Sillan purkaminen)
- Siltaa uusi kanava
- Tee tombstone vanhalle kanavalle osoittamaan uuteen
Huom! Jos et pura siltaa ennen plumbausta, silta jää elämään kahdelle kanavalle eikä sitä saa vanhalta omatoimisesti pois. Tämä lienee bugi IRC-sillassa.
Sillan purkaminen
Sillan pitäisi purkautua kun viimeinen Matrix-käyttäjä poistuu kanavalta.
Jos haluat purkaa sillan ja säilyttää Matrix-kanavan, tee seuraavasti (Esimerkki IRCNetissä):
- Selvitä Matrix-kanavan ID (Advanced | Internal room ID)
- Selvitä IRC-kanavan nimi IRC-verkossa
- Varmista että sinulla on op-status IRC-kanavalla.
- Avaa viestiyhteys integraatiobotille (IRCNetissä @ircnet:irc.snt.utwente.nl) ja katso sen kotipalvelin (IRCNetissä irc.snt.utwente.nl)
- Anna komento integraatiobotille:
!unlink !kanavanIdJossaPaljonKirjaimia:palvelin.fi irc.snt.utwente.nl #kanava