===== Matrix ===== {{ :matrix_idea.jpg?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 kertakirjautumisikkunasta. \\ === Kännykkä-Element === Asenna Element-sovellus. **Huom älä luo uutta tiliä asennuksen yhteydessä!** [[https://apps.apple.com/app/vector/id1083446067|Apple App Store]], [[https://play.google.com/store/apps/details?id=im.vector.app| Google Play]], [[https://f-droid.org/repository/browse/?fdid=im.vector.app|F-droid]] Anna palvelimeksi hacklab.fi (EI matrix.org joka oletuksena) tai konfiguroi mobile element tästä [[https://app.element.io/?hs_url=https://hacklab.fi|linkistä]] Selaa kirjautumisikkunan alareunaan ja valitse kirjautuminen Hacklab SSO {{:tunnukset.png?235&direct}} === Pikaohje (selainsovellus) -- Quick Help (browser application) === Pikaohje selainsovelluksen käyttöön. \\ **Työpöytäselain -- //Desktop Browser//** | {{: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]] | **Mobiiliselain -- //Mobile Browser//**\\ HUOM! Älä tee sitä. Jos kuitenkin teet [[https://wiki.tampere.hacklab.fi/hidden|niin]].\\ //Don't.// \\ === Element työpöytäsovellus -- Element Desktop app === 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 -- //Mobile//** \\ * 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]].