Ero sivun ”Matrix-Discord” versioiden välillä

Linux.fista
Siirry navigaatioon Siirry hakuun
 
(11 välissä olevaa versiota 2 käyttäjän tekeminä ei näytetä)
Rivi 1: Rivi 1:
Näin siltaat olemassaolevan Discord-kanavan olemassaolevalle Matrix-kanavalle. Matrix-kanava ei saa olla päästä päähän salattu.
Näin siltaat olemassaolevan Discord-kanavan olemassaolevalle [[Matrix]]-kanavalle. Matrix-kanava ei saa olla päästä päähän salattu.
 
= t2bot.io -palvelun avulla =


T2bot.io -palvelu tarjoaa kaikille avoimen Discord-sillan jota tässäkin käytetään esimerkkinä. Lisätietoja [https://t2bot.io/discord/ täältä].
T2bot.io -palvelu tarjoaa kaikille avoimen Discord-sillan jota tässäkin käytetään esimerkkinä. Lisätietoja [https://t2bot.io/discord/ täältä].
Silta ajaa [https://github.com/Half-Shot/matrix-appservice-discord matrix-appservice-discord]-siltatoteutusta. Muitakin Discord-siltatoteutuksia on, kts alta.


== Tarvittavat tiedot ==
== Tarvittavat tiedot ==
Rivi 8: Rivi 11:
* Siltabotin kutsulinkki - esim t2bot.io -palvelun botti kutsutaan linkillä https://discordapp.com/api/oauth2/authorize?client_id=309408702530846730&scope=bot&permissions=607251456
* Siltabotin kutsulinkki - esim t2bot.io -palvelun botti kutsutaan linkillä https://discordapp.com/api/oauth2/authorize?client_id=309408702530846730&scope=bot&permissions=607251456
* Siltabotin Matrix-käyttäjä - esim t2bot.io -palvelun botti on @_discord_bot:t2bot.io
* Siltabotin Matrix-käyttäjä - esim t2bot.io -palvelun botti on @_discord_bot:t2bot.io
* Matrix-kanava, jossa siltaajalla täytyy olla admin-oikeudet. Huomaa, että portaalisillatulla IRC-kanavalla näitä ei saa kuin sillan ylläpitäjän avustuksella!
* Matrix-kanava, jossa siltaajalla täytyy olla admin-oikeudet. Huomaa, että portaalisillatulla IRC-kanavalla näitä ei saa kuin sillan ylläpitäjän avustuksella! Jos kanava on vanhaa huoneversiota (esim versio 1), kannattaa Matrix-kanava päivittää ennen siltausta.


== Discord-puoli ==
== Discord-puoli ==
Rivi 24: Rivi 27:


Discordsilta EI osaa seurata room upgradea. Eli sano !discord unbridge, potki botti pois Matrix-kanavalta, tee room upgrade ja siltaa uusi kanava uudestaan. (TODO: Varmista oliko näin?)
Discordsilta EI osaa seurata room upgradea. Eli sano !discord unbridge, potki botti pois Matrix-kanavalta, tee room upgrade ja siltaa uusi kanava uudestaan. (TODO: Varmista oliko näin?)
=  Mautrix-discord =
Sillalle on suht hyvät ohjeet [https://docs.mau.fi/bridges/go/discord/index.html täällä].
== Kokonaisen kanavan siltaaminen (relaybot-toiminto) ==
Lue ohjeet "relaying with webhooks"-kohdasta. Suosittelen tekemään oman Matrix-tunnuksen välitysbotille, jolla siltausta hallitaan. Kutsutaan tässä ohjeessa
sitä nimellä relaybot.
=== Valmistelut ===
* Ota silta käyttöön. Sillan komentobottia kutsutaan tässä ohjeessa discordbot-nimellä.
* Tee discordbotti ohjeiden mukaan ja kutsu se Discord-kiltaan. Anna ohjeiden neuvomat oikeudet.
* Autentikoidu webhookeilla discordiin (tee relaybot-tunnuksella)
=== Yksittäisen kanavan siltaus ===
* Jos kanavalla on jo vanha Discord-silta, aja se alas (tai tulee karmea ikikiersiö)
* Liity relaybotilla kanavalle, anna relaybotille Moderator-oikeudet
* Kutsu discordbot kanavalle (ei vaadi oikeuksia)
* Selvitä discord-kanavan id. Saa selville discordin käyttöliittymästä jos ei muuten.
* Sano relaybottina !discord bridge <kanavaid>
* Discordin pitäisi nyt siltautua
* Määrittele relaybot-toiminto kanavalle: Sano relaybottina !discord set-relay --create Matrix
* Voit laskea relaybotin oikeustasoa alemmaksi jos haluat
* Voit myös poistua relaybotilla kanavalta, mutta (tällä hetkellä) se kutsutaan sinne takaisin kun silta käynnistetään uudestaan.
=  mx-puppet-discord (Vanhentunut silta jota ei kehitetä, älä käytä) =
[https://github.com/matrix-discord/mx-puppet-discord mx-puppet-discord] on monipuolisempi mutta samalla haastavampi siltatoteutus. Siitä
ei ole tiedossa julkisia instansseja, joten joudut asentamaan sen omalle kotipalvelimellesi tai käyttämään palvelinta jossa se on (esim hacklab.fi).
Osa sillan dokumentaatiosta on [https://github.com/Sorunome/mx-puppet-bridge sillan käyttämän kirjaston github-repossa] ettei olisi liian helppoa.
== Sillan asennus ja konfigurointi ==
Asenna silta.
Konfiguraatiotiedostossa huolehdi, että relay-toiminto on sallittu kaikille. Muuten silta asettaa muille kuin sallituille
käyttäjille PL -1 jolloin he eivät voi puhua.
== Botin teko discordiin ==
Seuraa [https://github.com/matrix-discord/mx-puppet-discord#linking-a-discord-bot-account tätä ohjetta]
Lisää botti Discord-kiltaan kutsulinkillä. Kutsulinkin formaatti on suunnilleen:
https://discordapp.com/api/oauth2/authorize?client_id=63xxxxxxxxxxx907&scope=bot&permissions=607251456
== Sillan yhdistäminen bottiin ==
Siltabotin mxid on tyyliin @_discordpuppet_bot:yourserver.com. Juttele sille.
Siltabottiin voi liittää useita Discord-botteja tai Discord-käyttäjiä link-komennolla, jolloin niille saadaan puppet id-numero
jota käytetään jatkossa monessa paikkaa.
Selvitä botin token Discordista. Anna komento link bot NjM0NDYxxxxxxxxxxxxxxxxxxxxxxxxxxxxxBIQ0To
Silta vastaa "Created new link with ID 3" (ID-numero on pupped id)
== Botin säätö ==
Katso ensin lista komennoista sanomalla: help
Disabloi auto invite: setautoinvite 3 0
Aseta sillatut kanavat julkiseksi: setispublic 3 true
Aseta silta relayksi: settype 3 relay
Listaa killat joissa botti on: listguilds 3
Siltaa kilta: bridgeguild 3 872xxxxxxxxx791
== Kanavien siltaus ==
Ennen kanavien siltausta täytyy sillata kilta.
Jos haluat sillata koko killan uusille matrix-kanaville, se onnistuu kerralla: joinentireguild 3 87xxxxxxxxx91
Muuten siltaa käsipelillä kilta (ei siltaa yksittäisiä kanavia): bridgeguild 3 87xxxxxxxxx91 - tämän jälkeen voit sillata yksittäisiä kanavia.
Jos haluat sillata yksittäisen kanavan joka on jo matrixissa, kutsu matrix-botti kanavalle ja anna komento !discord bridge 8725xxxxxxx913
Kanavan numeron saa kaivettua discordissa webbiselaimella kuten toisen sillan tapauksessa.
== Huoneen päivitys ==
Tämä Discord-silta EI osaa ainakaan toistaisemsi seurata huonepäivityksiä (room upgrade). Jos päivität huoneen, tee seuraavasti:
* Botin komentohuoneessa epäsiltaa k.o huone: unbridge 3 87xxxxxxxxx91
* Päivitä huone (ei haittaa jos se on jo päivitetty)
* Kutsu siltabotti uuteen huoneeseen
* Siltaa uudestaan, huoneessa: !discord bridge 3 87xxxxxxxxx91
Numero 3 on esimerkissä puppet id ja 87xxxxxxxxx91 kanavan id discordista.
== Yleisiä ongelmia ==
=== Discordin puolelle viestit tulevat "laatikoissa" ===
* Varmista että Discord-admin antoi botin vaatimat oikeudet
* Varmista, että killassa ei ole toista siltabottia, jolla olisi samoja oikeuksia (ilmeisesti vain yksi voi lähettää viestejä käyttäjien puolesta)
* Discord voi vaatia, että botin omistajalla on 2fa käytössä. Eli vaativat puhelinnumeron antamisen ja google authenticatorin käytön. Jos sillan lokiin tulee "warn: Missing webhook permissions DiscordAPIError: Two factor is required for this operation", täytyy tämä tehdä.
[[Luokka:Matrix]]

Nykyinen versio 17. maaliskuuta 2024 kello 14.53

Näin siltaat olemassaolevan Discord-kanavan olemassaolevalle Matrix-kanavalle. Matrix-kanava ei saa olla päästä päähän salattu.

t2bot.io -palvelun avulla[muokkaa]

T2bot.io -palvelu tarjoaa kaikille avoimen Discord-sillan jota tässäkin käytetään esimerkkinä. Lisätietoja täältä. Silta ajaa matrix-appservice-discord-siltatoteutusta. Muitakin Discord-siltatoteutuksia on, kts alta.

Tarvittavat tiedot[muokkaa]

Discord-puoli[muokkaa]

  • Lisää siltabotti kiltaan ja kanavalle linkin avulla. Anna sen pyytämät oikeudet.

Matrix-puoli[muokkaa]

  • Kutsu siltabotti kanavalle: /invite @_discord_bot:t2bot.io
  • Sano kanavalla !discord bridge <serverid> <channelid>

Tässä vaiheessa silta kysyy discord-kanavan ylläpitäjältä vahvistuksen. Kun vahvistus on annettu, silta nousee pystyyn.

Kanavan päivitys[muokkaa]

Discordsilta EI osaa seurata room upgradea. Eli sano !discord unbridge, potki botti pois Matrix-kanavalta, tee room upgrade ja siltaa uusi kanava uudestaan. (TODO: Varmista oliko näin?)

Mautrix-discord[muokkaa]

Sillalle on suht hyvät ohjeet täällä.

Kokonaisen kanavan siltaaminen (relaybot-toiminto)[muokkaa]

Lue ohjeet "relaying with webhooks"-kohdasta. Suosittelen tekemään oman Matrix-tunnuksen välitysbotille, jolla siltausta hallitaan. Kutsutaan tässä ohjeessa sitä nimellä relaybot.

Valmistelut[muokkaa]

  • Ota silta käyttöön. Sillan komentobottia kutsutaan tässä ohjeessa discordbot-nimellä.
  • Tee discordbotti ohjeiden mukaan ja kutsu se Discord-kiltaan. Anna ohjeiden neuvomat oikeudet.
  • Autentikoidu webhookeilla discordiin (tee relaybot-tunnuksella)

Yksittäisen kanavan siltaus[muokkaa]

  • Jos kanavalla on jo vanha Discord-silta, aja se alas (tai tulee karmea ikikiersiö)
  • Liity relaybotilla kanavalle, anna relaybotille Moderator-oikeudet
  • Kutsu discordbot kanavalle (ei vaadi oikeuksia)
  • Selvitä discord-kanavan id. Saa selville discordin käyttöliittymästä jos ei muuten.
  • Sano relaybottina !discord bridge <kanavaid>
  • Discordin pitäisi nyt siltautua
  • Määrittele relaybot-toiminto kanavalle: Sano relaybottina !discord set-relay --create Matrix
  • Voit laskea relaybotin oikeustasoa alemmaksi jos haluat
  • Voit myös poistua relaybotilla kanavalta, mutta (tällä hetkellä) se kutsutaan sinne takaisin kun silta käynnistetään uudestaan.

mx-puppet-discord (Vanhentunut silta jota ei kehitetä, älä käytä)[muokkaa]

mx-puppet-discord on monipuolisempi mutta samalla haastavampi siltatoteutus. Siitä ei ole tiedossa julkisia instansseja, joten joudut asentamaan sen omalle kotipalvelimellesi tai käyttämään palvelinta jossa se on (esim hacklab.fi).

Osa sillan dokumentaatiosta on sillan käyttämän kirjaston github-repossa ettei olisi liian helppoa.

Sillan asennus ja konfigurointi[muokkaa]

Asenna silta.

Konfiguraatiotiedostossa huolehdi, että relay-toiminto on sallittu kaikille. Muuten silta asettaa muille kuin sallituille käyttäjille PL -1 jolloin he eivät voi puhua.

Botin teko discordiin[muokkaa]

Seuraa tätä ohjetta

Lisää botti Discord-kiltaan kutsulinkillä. Kutsulinkin formaatti on suunnilleen:

https://discordapp.com/api/oauth2/authorize?client_id=63xxxxxxxxxxx907&scope=bot&permissions=607251456

Sillan yhdistäminen bottiin[muokkaa]

Siltabotin mxid on tyyliin @_discordpuppet_bot:yourserver.com. Juttele sille.

Siltabottiin voi liittää useita Discord-botteja tai Discord-käyttäjiä link-komennolla, jolloin niille saadaan puppet id-numero jota käytetään jatkossa monessa paikkaa.

Selvitä botin token Discordista. Anna komento link bot NjM0NDYxxxxxxxxxxxxxxxxxxxxxxxxxxxxxBIQ0To

Silta vastaa "Created new link with ID 3" (ID-numero on pupped id)

Botin säätö[muokkaa]

Katso ensin lista komennoista sanomalla: help

Disabloi auto invite: setautoinvite 3 0

Aseta sillatut kanavat julkiseksi: setispublic 3 true

Aseta silta relayksi: settype 3 relay

Listaa killat joissa botti on: listguilds 3

Siltaa kilta: bridgeguild 3 872xxxxxxxxx791

Kanavien siltaus[muokkaa]

Ennen kanavien siltausta täytyy sillata kilta.

Jos haluat sillata koko killan uusille matrix-kanaville, se onnistuu kerralla: joinentireguild 3 87xxxxxxxxx91

Muuten siltaa käsipelillä kilta (ei siltaa yksittäisiä kanavia): bridgeguild 3 87xxxxxxxxx91 - tämän jälkeen voit sillata yksittäisiä kanavia.

Jos haluat sillata yksittäisen kanavan joka on jo matrixissa, kutsu matrix-botti kanavalle ja anna komento !discord bridge 8725xxxxxxx913 Kanavan numeron saa kaivettua discordissa webbiselaimella kuten toisen sillan tapauksessa.

Huoneen päivitys[muokkaa]

Tämä Discord-silta EI osaa ainakaan toistaisemsi seurata huonepäivityksiä (room upgrade). Jos päivität huoneen, tee seuraavasti:

  • Botin komentohuoneessa epäsiltaa k.o huone: unbridge 3 87xxxxxxxxx91
  • Päivitä huone (ei haittaa jos se on jo päivitetty)
  • Kutsu siltabotti uuteen huoneeseen
  • Siltaa uudestaan, huoneessa: !discord bridge 3 87xxxxxxxxx91

Numero 3 on esimerkissä puppet id ja 87xxxxxxxxx91 kanavan id discordista.

Yleisiä ongelmia[muokkaa]

Discordin puolelle viestit tulevat "laatikoissa"[muokkaa]

  • Varmista että Discord-admin antoi botin vaatimat oikeudet
  • Varmista, että killassa ei ole toista siltabottia, jolla olisi samoja oikeuksia (ilmeisesti vain yksi voi lähettää viestejä käyttäjien puolesta)
  • Discord voi vaatia, että botin omistajalla on 2fa käytössä. Eli vaativat puhelinnumeron antamisen ja google authenticatorin käytön. Jos sillan lokiin tulee "warn: Missing webhook permissions DiscordAPIError: Two factor is required for this operation", täytyy tämä tehdä.