Salta ai contenuti

Utenti e ruoli

Configurazione

Dai a ogni persona della tua casa un account personale, con solo i diritti che le servono. Il Proprietario e gli Amministratori lavorano in Settings > Users and roles (impostazioni > utenti e ruoli).

Invitare qualcuno

Link a Invitare qualcuno
  1. Apri Settings > Users and roles.
  2. Scegli Member (Membro). Il Proprietario può scegliere anche Admin (Amministratore).
  3. Controlla i permessi. Quelli predefiniti del ruolo sono già spuntati.
  4. Aggiungi una nota privata se vuoi ricordare per chi è il link.
  5. Scegli quanto dura il link: da 1 a 30 giorni, 7 per impostazione predefinita.
  6. Premi Make an invite link (crea un link d’invito) e copialo subito. Dovresti vedere il link completo una sola volta; funziona una sola volta.

La persona apre il link, sceglie un nome univoco e una password che rispetti il minimo attuale. Poi accede subito.

Per un bambino con un limite d’età, vedi Account per bambini.

Ruoli e permessi

Link a Ruoli e permessi
Ruolo Cosa significa
Proprietario Il primo account. Può fare tutto. In questa schermata nessuno può modificarlo o disattivarlo
Amministratore Gestisce i Membri e la Libreria, nei limiti dei suoi permessi
Membro Di solito richiede titoli e vede le proprie richieste
Permesso Cosa consente Nuovo Amministratore Nuovo Membro
Request titles Fare richieste Sì Sì
Requests approved without waiting Le richieste saltano l’approvazione Sì No
Approve or turn down requests Decidere sulle richieste delle altre persone Sì No
Run the Library Cercare, organizzare e gestire le operazioni della Libreria Sì No
Change settings Aprire e modificare le impostazioni ordinarie No No

Chi può concedere cosa:

  • Solo il Proprietario invita un Amministratore o ne nomina uno.
  • Un Amministratore invita e modifica i Membri, e concede solo i permessi che ha lui.
  • Nessuno cambia il proprio ruolo o i propri permessi.

Modificare una persona

Link a Modificare una persona
  1. Apri Settings > Users and roles e scegli la persona.
  2. Cambia il ruolo o i permessi. Un nuovo ruolo spunta i suoi permessi predefiniti prima che tu salvi.
  3. Facoltativo: imposta limiti settimanali di richieste per film, serie e musica, da 0 a 1000 ciascuno. Se è vuoto vale il valore predefinito di Settings > Request rules (regole delle richieste); 0 significa nessun limite. Chi può approvare non ha limiti.
  4. Premi Save (salva).

Turn off (disattiva) disconnette la persona da tutti i dispositivi, rimuove le sue chiavi API e blocca l’accesso finché non la riattivi. L’account resta.

Queste modifiche richiedono un accesso con password. Se sei entrato con la scorciatoia della rete locale, accedi prima con la tua password.

Configurare l’accesso a due fattori

Link a Configurare l’accesso a due fattori

Ognuno lo fa per il proprio account.

  1. Apri My account, trova Two-factor (due fattori) e premi Set up (configura).
  2. Aggiungi l’account a un’app di autenticazione, con il link o la chiave mostrati.
  3. Scrivi il codice di 6 cifre dell’app.
  4. Salva i 10 codici di backup in un posto sicuro. Li vedi solo adesso; ognuno funziona una volta.

Per creare nuovi codici di backup o disattivare i due fattori, scrivi un codice attuale dell’app o un codice di backup non usato. I nuovi codici sostituiscono i vecchi.

Richiedere i due fattori agli Amministratori

Link a Richiedere i due fattori agli Amministratori

Il Proprietario lo attiva in Settings > Sign-in and security (impostazioni > accesso e sicurezza). Un Amministratore senza due fattori può allora aprire solo My account finché non li configura. Per i Membri non cambia nulla.

Immagine del profilo

Link a Immagine del profilo

Chiunque può impostarne una in My account > Profile picture (immagine del profilo): JPEG, PNG o WebP, fino a 5 MB. HolyArrs ritaglia il quadrato centrale a 256 per 256 pixel. Remove (rimuovi) torna alle iniziali colorate.

Se non funziona

Link a Se non funziona

Sintomo: un link d’invito non funziona. Causa: è stato usato, è scaduto o è stato ritirato, oppure chi l’ha creato non è più un Proprietario o Amministratore attivo. Soluzione: creane uno nuovo. L’elenco Invite links (link d’invito) mostra lo stato di ogni link; il Proprietario può ritirare qualsiasi link aperto, un Amministratore solo i propri.

Sintomo: un Amministratore non può spuntare un permesso. Causa: gli Amministratori concedono solo i permessi che hanno. Soluzione: chiedi al Proprietario.

Sintomo: qualcuno ha perso l’app di autenticazione e i codici di backup. Causa: non resta nessun codice per accedere. Soluzione: il Proprietario reimposta i due fattori per un Amministratore o un Membro; un Amministratore li reimposta per un Membro. La persona viene disconnessa da tutti i dispositivi, accede con la sua password e li configura di nuovo. Per il Proprietario, vedi Hai dimenticato la password; anche reset-owner disattiva i due fattori del Proprietario.

API dell'immagine
Route Cosa fa
PUT /api/v1/account/avatar L’immagine come corpo della richiesta. Risponde {"avatar": "<address>"}. 413 sopra 5 MB, 415 se non è JPEG, PNG o WebP
DELETE /api/v1/account/avatar Rimuove la tua immagine
GET /api/v1/users/{id}/avatar L’immagine di una persona, oppure 404

GET /api/v1/auth/me e GET /api/v1/users includono avatar, oppure null. Le modifiche richiedono il consueto header CSRF; una chiave API richiede l’ambito di scrittura.

HolyArrs è gratis. Se ti ha fatto risparmiare tempo, metti una stella su GitHub, sostienilo o offrimi un caffè.