===== Matrix =====

Ei ole yhtä oikeaa tapaa tai välinettä keskustella Hacklab-yhteisön kanssa. Nettiselain tai Element-sovellus ajaa asian useimpiin tarpeisiin. Keskustelut sijaitsevat Matrixissa.\\  {{:matrix_idea.jpg?300&direct}}

{{ :homepage-all-platforms-1_1.png?300&direct}}[[https://matrix.org/|Matrix]] on avoimeen lähdekoodiin perustuva hajautettu, nykyaikainen ja turvallinen pikaviestin protokolla, sen kautta pääset liittymään hacklabin pikaviestinkanavien lisäksi myös monille muille alustoille niin sanottujen [[https://matrix.org/bridges/|siltojen]] kautta. Yksinkertaistettuna Matrix-palvelimeen otetaan yhteyttä nettiselaimella tai erillisellä asiakasohjelmalla. Niitä löytyy useita [[https://matrix.org/clients|erilaisia]]. Yksi käytetyimmistä asiakasohjelmista on [[https://element.io/|Element]]. Element sovellus on saatavilla useimmille alustoille ja käyttöjärjestelmille joten suosittelemme sen käyttöä aloittelijoille.

Hacklab.fi-kattojärjestö ylläpitää Matrix-[[https://matrix.hacklab.fi/|palvelinta]], johon pystyt kirjautumaan jäsenrekisterin tunnuksilla (SSO/Keycloak).

Suomenkielistä lisätietoa Matrixista löydät [[https://www.linux.fi/wiki/Matrix|täältä]]

==== Hacklab.fi Matrix tunnusten käyttöönotto ====

Liittyessäsi Tampere Hacklab ry:n jäseneksi sinulle luodaan jäsentunnus [[my.tampere.hacklab.fi|jäsenrekisteriin]]. Tällä tunnuksella voi kirjautua suurimpaan osaan yhdistyksen tarjoamia palveluita kuten myös hacklab.fi matrix palvelimelle. Käytettäessä jäsenrekisterin tunnuksia ensimmäinen kirjautuminen palvelimelle tulee suorittaa työpöytäselaimella. Teknologiaa taustalla kutsutaan [[https://fi.wikipedia.org/wiki/Kertakirjautuminen|kertakirjautumiseksi]] (aka. single sign on lyh. SSO) sekä [[https://www.keycloak.org/|Keycloak]]. Saatat törmätä näihin nimityksiin kirjautumisen yhteydessä. \\ {{:sso_login.png?400&nolink}}\\ Yllä esimerkki kertakirjautumis ikkunasta.

\\

=== Pikaohje (selainsovellus)  --  Quick Help (browser application) ===

Pikaohje selainsovelluksen käyttöön.

\\

<table>

<caption>

**Työpöytäselain  --  //Desktop Browser//**</caption>^  ^  ^

| {{:desktop_welcome.png?300&direct|Welcome page}} | 1. **Mene selaimelle osoitteeseen** [[https://chat.hacklab.fi/]] \\ \\ 2. **Kirjaudu sisään** - //Sign in// |
| {{:desktop_login.png?300&direct|Login page}} | 3. **Jatka käyttäen palvelun tarjoajaa**\\ **hacklab finland keycloak**\\ - //Continue with hacklab finland keycloak// |
| {{:desktop_login_with_sso_keycloak.png?200&direct|SSO Keycloak page}} | 4. **Tampere** |
| {{:desktop_login_mylusa.png?300&direct|Jäsenrekister login}} | 5. **Kirjaudu palveluun jäsenrekisteri mulysan tunnuksilla**\\ \\ 6. **Aloita viestittely** [[https://wiki.tampere.hacklab.fi/palvelut#liity_kanaville|kanavilla]] |

</table> **Mobiiliselain  --  //Mobile Browser//**\\  HUOM! Älä tee sitä. Jos kuitenkin teet [[https://wiki.tampere.hacklab.fi/hidden|niin]].\\  //Don't.//

\\

=== Laitekohtaiset Element sovellukset  --  Device-specific Element apps ===

Alla ohjeet laitekohtaisten Element sovellusten käyttöönottoon sekä kirjautumiseen hacklab.fi matrix palvelimelle.

**Element työpöytäsovellus  --  //Desktop//**\\

  * Lataa ja asenna Element sovellus [[https://element.io/get-started#download]]
  * Avaa sovellus
  * Klikkaa "Kirjaudu sisään" / "Sign in" painiketta
  * Muokkaa kotipalvelimen osoitetta klikkaamalla "Muokkaa" / "Edit"
  * Valitse ja kirjoita palvelimen osoite "Muu kotipalvelin"/"Other homeserver" kenttään matrix.hacklab.fi
  * Klikkaa "Jatka" / "Continue" painiketta
  * Syötä jo olemassa olevat hacklab.fi tunnukset tai kirjaudu jäsenrekisterin tunnuksilla klikkaamalla "Jatka käyttäen palveluntarjoajaa Hacklab Finland Keycloak"/"Sign in with Hacklab Finland Keycloak" painiketta.
  * Auta kehittäjiä aktivoimalla raportointi
  * Liity [[https://matrix.to/#/!bffXHgwxURCYIvOXlg:hacklab.fi?via=hacklab.fi&via=matrix.org|Tampere Hacklab-avaruuteen]] jonka alta löydät labin kanavat.
  * Liity ja aloita viestittely [[https://wiki.tampere.hacklab.fi/palvelut#liity_kanaville|kanavilla]].

{{::desktop_login.jpg?225&direct}} {{:valitse_palvelin.png?220&direct}} {{:matrix.hacklab.fi.png?185&direct}} {{:tunnukset.png?235&direct}} \\ \\  **Element mobiilisovellus  --  //Moible//** \\

  * Lataa ja asenna Element sovellus [[https://element.io/get-started#download]]
  * Avaa sovellus
  * Klikkaa "Minulla on jo tunnus" / "I already hava an account" painiketta
  * Klikkaa valitse palvelin "muu" / "other"
  * Kirjoita palvelimen osoite matrix.hacklab.fi
  * Klikkaa "Jatka" / "Continue" painiketta
  * Syötä jo olemassa olevat hacklab.fi tunnukset tai kirjaudu jäsenrekisterin tunnuksilla "Sign in with Hacklab Finland Keycloak".
  * Auta kehittäjiä aktivoimalla raportointi
  * Liity [[https://matrix.to/#/!bffXHgwxURCYIvOXlg:hacklab.fi?via=hacklab.fi&via=matrix.org|Tampere Hacklab-avaruuteen]] jonka alta löydät labin kanavat.
  * Liity ja aloita viestittely [[https://wiki.tampere.hacklab.fi/palvelut#liity_kanaville|kanavilla]].

{{::minulla_on_jo_tunnus.jpg?200&direct}}{{:valitse_palvelin_other.jpg?200&direct}}{{:matrix.hacklab.fi.jpg?200&direct}}{{:kayttajatunnukset_tai_sso.jpg?200&direct}}{{:auta_kehittajia.jpg?200&direct}}

=== Yksityiskohtaisemmat ohjeet ===

== Uuden hacklab.fi tunnuksen luominen (edistyneet käyttäjät) ==

HUOM! Tampere Hacklab ry:n jäsenenä sinulle on luotu automaattisesti tunnukset jäsenrekisteriin. Jäsenrekisterin tunnuksilla voi kirjautua hacklab.fi matrix palvelimelle. Kts.käyttöönotto - [[https://wiki.tampere.hacklab.fi/palvelut#pikaohje_selainsovellus|pikaohje]]. Täällä ohjeet [[https://wiki.tampere.hacklab.fi/matrix/erikoistapaukset|erikoistarpeita]] varten.

== Vaihtoehtoinen Matrix tunnus ==

Halutessasi voit käyttää minkä tahansa matrix palvelimen tunnuksia liittyessäsi hacklabin pikaviestinkanaville. Suositus on kuitenkin käyttää jäsenrekisterin @tunnus:hacklab.fi tunnuksia (kertakirjautuminen, SSO/Keycloak).

= Hacklab.fi matrix Sillat / Bridges = Siltojen avulla Matrix käyttäjä tavoittaa muut pikaviestin alustat kuten IRC, Telegram, Whatsapp, Facebook messenger, Signal, SMS, Slack ja Discord. [[https://github.com/hacklab-fi/itinfra/blob/master/matrix/matrix-general.md|Lisää ohjeita silloista yms]].

== Liity kanaville ==

- **Tampere Hacklab-space** eli ryhmä jossa on kaikki labin kanavat. Liity [[https://matrix.to/#/#tampere-space:hacklab.fi|tästä]].

Alla lisäksi yksittäiset kanavat kuvauksineen:

- **Tampere Hacklabin yleiskanava #tampere:hacklab.fi**: [[https://matrix.to/#/#tampere:hacklab.fi|liity]]

  *  Täällä voi keskustella rauhassa eri aiheista (uskonto ja politiikka kielletty).

Liity qr-koodilla: {{:hacklab-matrix-qr-koodi.png?200&nolink}}

- **Tampere Hacklabin asiakanava #tampere-asiakanava:hacklab.fi**: [[https://matrix.to/#/#tampere-asiakanava:hacklab.fi|liity]]

  *  Täällä vain hacklabiin liittyviä käytännön asioita - ei kahvipöytäkeskustelua.

Liity qr-koodilla: {{:hacklab-asiakanava-matrix-qr-koodi.png?200&nolink}}

- **Tampere Hacklab in english #engtre:hacklab.fi**: [[https://matrix.to/#/#engtre:hacklab.fi|join]]

  *  English language only

- **Kauppapaikka (marketplace) #tori.trehacklab:hacklab.fi**: [[https://matrix.to/#/#tori.trehacklab:hacklab.fi|liity]]

  *  Ostaa, myy, vaihtaa, antaa jne. Buy, sell, change, etc.

- **Kuvakanava (images) #kuvia.tre:hacklab.fi**: [[https://matrix.to/#/#kuvia.tre:hacklab.fi|liity]]

  *  Tänne kuvia projekteista, tapahtumista yms. tampere hacklabiin liittyen.

- **Suomen hacklabien yhteiskanava #general:hacklab.fi**: [[https://matrix.to/#/#general:hacklab.fi|liity]]

  *  Eri kaupunkien hakkerit kokoontuva täällä.
  *  Sama kuin #hacklab.fi IRC-kanava IRCnetissä

Liity qr-koodilla: {{:hacklab-fi-matrix-qr-koodi.png?200&nolink}}

Lisää suomenkielisiä erilaisiin aiheisiin liittyviä kanavia on kerätty [[https://matrix.to/#/!WDaMZSVinTZRLOTajM:hacklab.fi?via=hacklab.fi&via=matrix.org&via=kapsi.fi|tähän spaceen]].

== Matrix-asiakkaita ==

Älypuhelimiin kannattaa ladata Element-sovellus:

  *  [[https://play.google.com/store/apps/details?id=im.vector.app&hl=fi|Android - versio]]
  *  [[https://itunes.apple.com/us/app/vector.im/id1083446067|iOS - versio]]

Tietokoneella voit käyttää [[https://element.io/]] selain- tai työpöytäversiota.

Paljon muitakin Matrix-sovelluksia löytyy moneen makuun. Tässä [[https://matrix.org/docs/projects/clients-matrix|lista tunnetuista Matrix-sovelluksista]].