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 Elementissä 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 Elementissä, 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 päästä päähän salattua viestintää. Salaukseen liittyvät määritteet ovat huonekohtaisia. Yleensä (ainakin Elementtiä käyttäessä) yksityisviestit ovat oletusarvoisesti päästä päähän salattuja, mutta useamman käyttäjän huoneet eivät, joten viestit tallentuvat Matrix-palvelimille selkokielisinä.

Mahdollisesti kiinnostavia huoneita

  • Kapsi Matrix: #matrix:kapsi.fi (Tähän huoneeseen kaikki Kapsin Matrix-käyttäjä liittyvät oletusarvoisesti)
  • Kapsin virallinen keskustelukanava: #kapsi:kapsi.fi (Sillattu IRCnettiin, Telegramiin, WhatsAppiin sekä Kapsin toimihenkilöiden Slackkiin)
  • Yleistä keskustelua enemmän tai vähemmän (yleensä vähemmän) Kapsiin liittyen: #offtopic:kapsi.fi (Sillattu IRCnetin kanavalle #kapsi.fi)
  • Keskustelua Matrixista suomeksi: #matrix.fi:kapsi.fi
  • Keskustelua Matrixista englanniksi: #matrix:matrix.org

Ohjeita muihin pikaviestinpalveluihin yhdistämiseen

Voit halutessasi yhdistää Matrix-huoneita muihin pikaviestipalveluihin Matrixin viestisiltoja hyödyntäen. Kapsi tarjoaa tällä hetkellä sillat Telegram-, WhatsApp-, Facebook Messenger-, Signal-, Discord- sekä Slack-pikaviestimiin. Näihin siltoihin voi kirjautua omalla käyttäjällä, jolloin sitä voi käytännössä käyttää Matrixin kautta. IRC:n käyttöön voi hyödyntää julkisia siltapalveluita.

Huomaathan, että siltapalveluita käytettäessä välitetyt viestit joudutaan aina käsittelemään selkokielisenä siltapalvelun toimesta. Signalia lukuunottamatta sillatut viestit myös tallentuvat tietokantaan selkokielisenä, Signalin tapauksessa salattuna. Myös Telegram-, WhatsApp- ja Facebook Messenger-sillat tukevat salausta, mutta se ei ole sillatuissa huoneissa oletuksena käytössä. Lisäksi siltapalvelut vaativat toimiakseen palvelukohtaisen kirjautumistunnisteen (access token) tallennuksen, jolloin sillalla on täysi pääsy palvelun käyttäjätiliisi niin kauan kuin olet sisäänkirjautuneena. Kapsin tarjoamat 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 toimivat niissä vastaavasti kuin IRCnetissä ja Freenodessa.

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.

WhatsApp

  1. Aloita viestiketju käyttäjän @whatsappbot:kapsi.fi kanssa
  2. Sano login
  3. Skannaa koodi puhelimella: WhatsApp -> ⋮-> +
  4. Botin pitäisi kutsua sinut viimeisimpiin WhatsApp-keskusteluihisi

Huomio! Jos tämän jälkeen kuitenkin käytät WhatsApp Webiä osoitteessa web.whatsapp.com, pitää botille sen jälkeen lähettää viesti "reconnect".

Signal

Jos käytät Signalia jo puhelimella:
  1. Aloita viestiketju käyttäjän @signalbot:kapsi.fi kanssa
  2. Sano link
  3. Skannaa koodi puhelimella: Signal -> Asetukset -> Linkitetyt laitteet -> Lisää laite
  4. Botin pitäisi kutsua sinut viimeisimpiin Signal-keskusteluihisi
Jos et käytä Signalia puhelimella:
  1. Aloita viestiketju käyttäjän @signalbot:kapsi.fi kanssa
  2. Sano register <puhelinnumero>
  3. Anna botille tekstiviestillä saamasi koodi
  4. Botin pitäisi kutsua sinut viimeisimpiin Signal-keskusteluihisi

Facebook

  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

Discord

(Guild on virallinen termi Discordin "servereille", jotka eivät ole oikeasti palvelimia.)

  1. Aloita viestiketju käyttäjän @_discordpuppet_bot:kapsi.fi kanssa
  2. Discordiin voi kirjautua joko bottina tai omalla käyttäjällä. Ohjeet molempiin löytyy siltaohjelmiston ohjeista
  3. Sano listguilds <link ID (botti sanoi link ID:n kun kirjauduit)>
  4. Botti listaa guildit, joiden jäsen olet (tai joiden jäsen Discord-botti on jos kirjauduit botin avulla). Sano bridgeguild <link ID> <guild ID> jokaiselle guildille, jonka haluat sillata.
  5. Botti kutsuu sinut huoneisiin, kun niihin tulee uusia viestejä. Voit myös liittyä itse huoneisiin yksi kerrallaan:
    1. Sano listrooms
    2. Klikkaa haluamasi huoneiden linkkejä

Slack

Huomio! Etenkin ennen työpaikan Slackin siltaamista on syytä varmistaa, että viestien tallentuminen Kapsin palvelimelle on ok.

  1. Aloita viestiketju käyttäjän @_slackpuppet_bot:kapsi.fi kanssa
  2. Sano link
  3. Botti sanoo ERROR, mutta tämä ei ole virhe. Klikkaa botin antamaa linkkiä ja hyväksy pyydetyt luvat
  4. Kopioi xoxp-alkuinen token ja sano botille link <kopioimasi token>
  5. Botti kutsuu sinut huoneisiin, kun niihin tulee uusia viestejä. Voit myös liittyä itse huoneisiin yksi kerrallaan:
    1. Sano listrooms
    2. Klikkaa haluamasi huoneiden linkkejä

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!