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[muokkaa]
- 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[muokkaa]
- 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
- Aseta Matrix-kanavalle "Change permissions"-oikeus vaatimaan tason 99, jos haluat että silta voi asettaa IRC-puolen opit moderaattoreiksi.
- JOS IRC-kanava on invite only (+i), kutsu IRC-siltabotti sinne: IRCissä /invite SNTMatrixBot
JSON-pyyntö[muokkaa]
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[muokkaa]
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[muokkaa]
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
[muokkaa]
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.
[muokkaa]
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[muokkaa]
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