Aller au contenu

Utilisateurs et rôles

Configuration

Donnez à chaque personne de la maison son propre compte, avec seulement les droits dont elle a besoin. Le propriétaire et les administrateurs travaillent dans Settings > Users and roles (Paramètres > Utilisateurs et rôles).

  1. Ouvrez Settings > Users and roles.
  2. Choisissez Member (membre). Le propriétaire peut aussi choisir Admin (administrateur).
  3. Vérifiez les permissions. Celles que le rôle donne par défaut sont déjà cochées.
  4. Ajoutez une note privée si vous voulez vous rappeler à qui le lien est destiné.
  5. Choisissez la durée de validité du lien : de 1 à 30 jours, 7 par défaut.
  6. Appuyez sur Make an invite link (créer un lien d’invitation) et copiez-le tout de suite. Vous devriez voir le lien complet une seule fois ; il ne sert qu’une fois.

La personne ouvre le lien, choisit un nom unique et un mot de passe qui respecte le minimum actuel. Elle est alors connectée.

Pour un enfant avec une limite d’âge, voir Comptes enfant.

Rôles et permissions

Lien vers Rôles et permissions
Rôle Ce que ça veut dire
Propriétaire Le premier compte. Peut tout faire. Personne ne peut le modifier ni le désactiver sur cet écran
Administrateur Gère les membres et la Bibliothèque, dans la limite de ses permissions
Membre En général, demande des titres et voit ses propres demandes
Permission Ce qu’elle autorise Nouvel administrateur Nouveau membre
Request titles (demander des titres) Faire des demandes Oui Oui
Requests approved without waiting (demandes approuvées sans attendre) Les demandes passent sans approbation Oui Non
Approve or turn down requests (approuver ou refuser des demandes) Décider des demandes des autres Oui Non
Run the Library (gérer la Bibliothèque) Rechercher, organiser et gérer le travail de la Bibliothèque Oui Non
Change settings (modifier les paramètres) Ouvrir et modifier les paramètres ordinaires Non Non

Qui peut accorder quoi :

  • Seul le propriétaire invite un administrateur ou fait de quelqu’un un administrateur.
  • Un administrateur invite et modifie les membres, et n’accorde que les permissions qu’il a lui-même.
  • Personne ne modifie son propre rôle ni ses propres permissions.

Modifier une personne

Lien vers Modifier une personne
  1. Ouvrez Settings > Users and roles et choisissez la personne.
  2. Modifiez le rôle ou les permissions. Un nouveau rôle coche ses permissions par défaut avant que vous enregistriez.
  3. Facultatif : fixez des limites hebdomadaires de demandes pour les films, les séries et la musique, de 0 à 1000 chacune. Un champ vide utilise la valeur par défaut de Settings > Request rules (Paramètres > Règles des demandes) ; 0 veut dire aucune limite. Les personnes qui peuvent approuver n’ont pas de limite.
  4. Appuyez sur Save (enregistrer).

Turn off (désactiver) déconnecte la personne partout, supprime ses clés API et bloque la connexion jusqu’à ce que vous la réactiviez. Le compte reste.

Ces modifications demandent une connexion par mot de passe. Si vous êtes entré par le raccourci du réseau local, connectez-vous d’abord avec votre mot de passe.

Configurer la connexion à deux facteurs

Lien vers Configurer la connexion à deux facteurs

Chaque personne le fait pour son propre compte.

  1. Ouvrez My account (Mon compte), trouvez Two-factor (deux facteurs) et appuyez sur Set up (configurer).
  2. Ajoutez le compte à une application d’authentification, avec le lien ou la clé affichés.
  3. Saisissez le code à 6 chiffres donné par l’application.
  4. Enregistrez les 10 codes de secours dans un endroit sûr. Vous ne les voyez que maintenant ; chacun ne sert qu’une fois.

Pour créer de nouveaux codes de secours ou désactiver les deux facteurs, saisissez un code actuel de l’application ou un code de secours inutilisé. Les nouveaux codes remplacent les anciens.

Exiger les deux facteurs pour les administrateurs

Lien vers Exiger les deux facteurs pour les administrateurs

Le propriétaire l’active dans Settings > Sign-in and security (Paramètres > Connexion et sécurité). Un administrateur sans deux facteurs ne peut alors ouvrir que My account tant qu’il ne les a pas configurés. Les membres ne sont pas concernés.

Tout le monde peut en choisir une dans My account > Profile picture (Mon compte > Photo de profil) : JPEG, PNG ou WebP, jusqu’à 5 Mo. HolyArrs recadre le carré central à 256 pixels sur 256. Remove (supprimer) revient aux initiales en couleur.

Si ça ne fonctionne pas

Lien vers Si ça ne fonctionne pas

Symptôme : un lien d’invitation ne fonctionne pas. Cause : il a été utilisé, a expiré ou a été retiré, ou la personne qui l’a créé n’est plus un propriétaire ou un administrateur actif. Solution : créez-en un nouveau. La liste Invite links (liens d’invitation) affiche l’état de chaque lien ; le propriétaire peut retirer n’importe quel lien ouvert, un administrateur seulement les siens.

Symptôme : un administrateur ne peut pas cocher une permission. Cause : les administrateurs n’accordent que les permissions qu’ils ont. Solution : demandez au propriétaire.

Symptôme : quelqu’un a perdu son application d’authentification et ses codes de secours. Cause : il ne reste aucun code pour se connecter. Solution : le propriétaire réinitialise les deux facteurs d’un administrateur ou d’un membre ; un administrateur les réinitialise pour un membre. La personne est déconnectée partout, se connecte avec son mot de passe et les configure à nouveau. Pour le propriétaire, voir Mot de passe oublié ; reset-owner désactive aussi les deux facteurs du propriétaire.

API de la photo
Route Ce que ça fait
PUT /api/v1/account/avatar L’image dans le corps de la requête. Répond {"avatar": "<address>"}. 413 au-delà de 5 Mo, 415 si ce n’est pas du JPEG, du PNG ou du WebP
DELETE /api/v1/account/avatar Supprime votre photo
GET /api/v1/users/{id}/avatar La photo d’une personne, ou 404

GET /api/v1/auth/me et GET /api/v1/users contiennent avatar, ou null. Les modifications demandent l’en-tête CSRF habituel ; une clé API a besoin de la portée d’écriture.

HolyArrs est gratuit. S'il vous a fait gagner du temps, mettez-lui une étoile sur GitHub, sponsorisez-le ou offrez-moi un café.