Siirry sisältöön

Istunnot ja salasanat

Käyttöönotto

  1. Avaa My account > Signed-in devices (oma tili > kirjautuneet laitteet). Jokainen rivi näyttää laitteen nimen, esimerkiksi “Firefox on Windows”, milloin se kirjautui ja milloin sitä käytettiin viimeksi. Omassa laitteessasi lukee This device (tämä laite).
  2. Napsauta rivillä Sign out (kirjaudu ulos). Rivi katoaa, ja kyseisen laitteen seuraava napsautus vie kirjautumiseen.
  3. Tai napsauta Sign out all other devices (kirjaa kaikki muut laitteet ulos), jolloin vain tämä laite jää.

Molemmat vaativat salasanakirjautumisen tai API-avaimen, jolla on admin-oikeus (scope). Paikallisen verkon oikotie ei riitä.

Jäsenet ja ylläpitäjät: kysy omistajalta.

Omistaja: kun HolyArrs on käynnissä, suorita tämä sen koneella:

Terminal window
docker exec -i holyarrs /holyarrs reset-owner

Kirjoita nimi yhdelle riville ja uusi salasana seuraavalle, paina sitten Ctrl+D. Ilman Dockeria suorita holyarrs reset-owner. Sen jälkeen pystyt kirjautumaan uudella salasanalla.

Kirjautumissivu näyttää samat vaiheet kohdassa Forgot the password? (unohditko salasanan?).

Tapahtuma Tulos
7 päivää ilman käyttöä Laite kirjataan ulos
30 päivää kirjautumisesta Laite kirjataan ulos, käytettiin sitä tai ei
Vaihdat salasanasi Kaikki muut laitteet kirjataan ulos

Laitteiden ja API-avainten viimeisin käyttöaika voi jäädä jälkeen jopa 1 tunnin.

Avaa Settings > Users and roles (asetukset > käyttäjät ja roolit) ja napsauta henkilön vieressä Devices (laitteet). Napsauta yhdellä laitteella Sign out tai Sign (name) out everywhere (kirjaa (nimi) ulos kaikkialta). Omistaja voi tehdä tämän kenelle tahansa, ylläpitäjä jäsenille. Henkilön poistaminen käytöstä kirjaa hänet myös ulos kaikkialta.

Oire: Sign out all other devices hylätään. Syy: olet sisällä API-avaimella tai paikallisen verkon oikotiellä. Ratkaisu: kirjaudu selaimessa salasanalla ja yritä uudelleen.

Istuntojen API
Reitti Kuka Mitä
GET /api/v1/auth/sessions Kuka tahansa kirjautunut Omat laitteesi: id, device, created_at, last_used_at, expires_at, current
DELETE /api/v1/auth/sessions Kuka tahansa kirjautunut Päättää kaikki muut laitteet. Vastaa {"ended": n}; 400, jos käytössä on API-avain tai paikallisen verkon oikotie
DELETE /api/v1/auth/sessions/{sid} Kuka tahansa kirjautunut Päättää yhden laitteen
GET /api/v1/users/{id}/sessions Omistaja, ylläpitäjä Yhden henkilön laitteet
POST /api/v1/users/{id}/sessions/end-all Omistaja, ylläpitäjä Kirjaa yhden henkilön ulos kaikkialta
DELETE /api/v1/users/{id}/sessions/{sid} Omistaja, ylläpitäjä Päättää yhden hänen laitteistaan

Arvo id on satunnainen julkinen arvo, eikä sillä voi kirjata ketään sisään. API-avaimilta vaaditaan admin-oikeus (scope).

HolyArrs on ilmainen. Jos se säästi aikaasi, anna sille tähti GitHubissa, tue sitä tai tarjoa minulle kahvit.