Kapsin logo

Kapsi Internet-käyttäjät ry

Matrix

Matrix on uuden polven pikaviestin, jolla pääsee Matrixin omien huoneiden lisäksi myös esimerkiksi IRC-kanaville, Telegramiin ja Whatsappiin. Lisätietoja Matrixista löytyy esimerkiksi matrix.org -sivuston Usein kysytyt kysymykset -osiosta.

Matrix-asiakasohjelmat

Käyttääksesi Matrix-palvelua tarvitset asiakasohjelman, joita löytyy älypuhelimiin, selaimessa toimivana web-sivuna sekä erilaisina työpöytäsovelluksina. Kattava lista erilaisista asiakasohjelmista löytyy Matrix.org -sivustolta . Alla lyhyt lista esimerkkeinä joistain Matrix-asiakasohjelmista.

Kirjautuminen Kapsin Matrix-palvelimelle

Käyttäjätunnus
@tunnus:kapsi.fi (Kapsin Riotissa tai jos olet erikseen määrittänyt palvelimen osoitteen riittää pelkkä tunnus)
Salasana
sama kuin shellin ja sähköpostin
Palvelimen osoite (Homeserver URL)
https://matrix.kapsi.fi (Oletus Kapsin Riotissa, pitäisi hakea automaattisesti myös muilla asiakasohjelmilla jos käyttää tunnusta muodossa @tunnus:kapsi.fi)

Matrix-käyttäjät

Matrixissa käyttäjien tunnukset ovat muodossa @<käyttäjänimi>:<domain.tld> eli esimerkiksi @kapsitunnuksesi:kapsi.fi tai @matrixuser:matrix.org. Loppuosa kertoo miltä palvelimelta käyttäjä käyttää Matrixia.

Matrix-huoneet

Huoneella voi olla aliaksia useammalla palvelimella, eli esimerkiksi #matrix:matrix.org on sama huone kuin #matrixhq:privacytools.io. Huoneeseen yhdistämisen jälkeen ei haittaa vaikka jokin palvelin lakkaisi olemasta, vaan muiden palvelinten käyttäjät voivat edelleen kommunikoida kanavalla.

Useat Matrix-asiakasohjelmat tukevat end-to-end -salattua viestintää. Salaukseen liittyvät määritteet ovat huonekohtaisia. Oletusarvoisesti huoneet eivät käytä e2e-salausta, joten viestit tallentuvat Matrix-palvelimille selkokielisinä.

Mahdollisesti kiinnostavia huoneita

  • Kapsi Matrix: #hub:kapsi.fi (Tähän huoneeseen kaikki Kapsin Matrix-käyttäjä liittyvät oletusarvoisesti)
  • Yleistä keskustelua enemmän tai vähemmän kapsiin liittyen: #kapsi.fi:kapsi.fi (Sillattu IRCnetin kanavalle #kapsi.fi)
  • Keskustelua Matrixista suomeksi: #matrix.fi:matrix.org
  • Keskustelua Matrixista englanniksi: #matrix:matrix.org

Ohjeita muihin pikaviestinpalveluihin yhdistämiseen

Voit halutessasi yhdistää Matrix-huoneita muihin pikaviestipalveluihin Matrixin "silta"-palveluita hyödyntäen. IRCn käyttöön voi hyödyntää julkisia silta-palveluita, Kapsi tarjoaa tällä hetkellä sillat Telegram ja WhatsApp -pikaviestimiin.

Huomaathan, että silta-palveluita käytettäessä välitetyt viestit joudutaan käsittelemään ja tallentamaan selkokielisenä kyseisen siltapalvelun toimesta. Lisäksi silta-palvelut vaativat toimiakseen palvelukohtaisen kirjautumistunnisteen (access token) tallennuksen. Kapsin tarjoamat WhatsApp, Facebook Messenger ja Telegram -siltapalvelut ovat ylläpidettynä Kapsin järjestelmissä.

IRCnet

  1. Yhdistä IRC-kanavalle #_ircnet_<kanavan nimi>:irc.snt.utwente.nl, esimerkiksi #_ircnet_#linux.fi:irc.snt.utwente.nl
  2. Jos haluat tietää nimimerkkisi IRCnetissä, lähetä viesti !nick käyttäjälle @ircnet:irc.snt.utwente.nl ja vaihtaaksesi !nick <haluttu nimimerkki>

Freenode

  1. Yhdistä IRC-kanavalle #freenode_<kanavan nimi>:matrix.org, esimerkiksi #freenode_#ltsp:matrix.org
  2. Jos haluat tietää nimimerkkisi Freenodessa, lähetä viesti !nick käyttäjälle @appservice-irc:matrix.org ja vaihtaaksesi !nick <haluttu nimimerkki>
  3. Jos haluat rekisteröidä nimimerkkisi niin, etteivät muut voi varata sitä: (Vaaditaan joillekkin irc-kanaville)
    1. Lähetä viesti REGISTER <salasana> <sähköpostiosoite> käyttäjälle @freenode_NickServ:matrix.org (Älä käytä muualla käyttämääsi salasanaa. Salasana tallennetaan raakatekstinä matrix.org-palvelimelle)
    2. Saat sähköpostiisi viestin Freenodelta. Lähetä sen käskemä rivi käyttäjälle @freenode_NickServ:matrix.org lukuunottamatta alkua /msg NickServ
    3. Lähetä käyttäjälle @freenode_NickServ:matrix.org viesti IDENTIFY <salasana>
    4. Lähetä käyttäjälle @appservice-irc:matrix.org viesti !storepass <salasana>

Muut IRC-verkot

Lista sillatuista verkoista löytyy osoitteesta https://github.com/matrix-org/matrix-appservice-irc/wiki/Bridged-IRC-networks. Asiat toimii niissä vastaavasti kuin IRCnetissä ja Freenodesa.

Telegram

  1. Aloita viestiketju käyttäjän @telegrambot:kapsi.fi kanssa
  2. Sano login
  3. Noudata botin antamia ohjeita
  4. Botin pitäisi kutsua sinut viimeisimpiin Telegram-keskusteluihisi. Näyt nyt sillatuissa Telegram-ryhmissä omalla käyttäjälläsi myös Telegram-käyttäjille.
  5. Anna botille halutessasi Matrix-käyttäjäsi access token, jolloin Telegramin kautta lähettämäsi viestit näkyvät Matrix-käyttäjille tulleen Matrix-käyttäjältäsi
    1. Kopioi Matrix access token: Riot (ainakin työpöytä ja selain) -> Settings -> Help & About -> Access Token
    2. Sano botille login-matrix
    3. Anna botille kopioimasi access token

Huomio: Jos kirjautut ulos Riot-instanssista, jonka access tokenia käytät, täytyy vaihe 5 suorittaa uudelleen.

WhatsApp

  1. Aloita viestiketju käyttäjän @whatsappbot:kapsi.fi kanssa
  2. Sano login
  3. Skanna koodi puhelimella WhatsApp -> ⋮-> +
  4. Botin pitäisi kutsua sinut viimeisimpiin WhatsApp-keskusteluihisi
  5. Anna botille halutessasi Matrix-käyttäjäsi access token, jolloin Whatsappin kautta lähettämäsi viestit näkyvät Matrix-käyttäjille tulleen Matrix-käyttäjältäsi
    1. Kopioi Matrix access token: Riot (ainakin työpöytä ja selain) -> Settings -> Help & About -> Access Token
    2. Sano botille login-matrix <Access Token>

Huomio: Jos kirjautut ulos Riot-instanssista, jonka access tokenia käytät, täytyy vaihe 5 suorittaa uudelleen.

Huomio! Jos tämän jälkeen käytät Whatsapp Webiä osoitteessa web.whatsapp.com, pitää botille sen jälkeen huutaa "reconnect", mutta miksipä sitä käyttäisi, kun Matrix hoitaa homman :-)

Facebook

Jos et halua antaa sillalle Facebook-tunnuksiasi, voit käyttää login-komennon tilalla komentoa login-cookie ja seurata botin antamia ohjeita.

  1. Aloita viestiketju käyttäjän @facebookbot:kapsi.fi kanssa
  2. Sano login <sähköpostiosoite> <salasana>
  3. Anna kaksivaiheisen tunnistautumisen koodi, jos sen on käytössä
  4. Botin pitäisi kutsua sinut viimeisimpiin Facebook-keskusteluihisi
  5. Anna botille halutessasi Matrix-käyttäjäsi access token, jolloin Facebookin kautta lähettämäsi viestit näkyvät Matrix-käyttäjille tulleen Matrix-käyttäjältäsi
    1. Kopioi Matrix access token: Riot (ainakin työpöytä ja selain) -> Settings -> Help & About -> Access Token
    2. Sano botille login-matrix <Access Token>

Huomio: Jos kirjautut ulos Riot-instanssista, jonka access tokenia käytät, täytyy vaihe 5 suorittaa uudelleen.

Copyright huomio

Tämän ohjesivun luomiseksi on hyödynnetty lähdemateriaalina ja kopioitu muutoksin sekä hacklab.fi:n, että Oulun Lyseon Matrix-ohjeita alkuperäisten kirjoittajien luvalla. Kiitoksemme molemmille organisaatioille avusta!