Pular para o conteúdo

Usuários e funções

Configuração

Dê a cada pessoa da sua casa uma conta própria, só com as permissões de que ela precisa. O Dono e os Administradores trabalham em Settings > Users and roles (Configurações > Usuários e funções).

  1. Abra Settings > Users and roles.
  2. Escolha Member (Membro). O Dono também pode escolher Admin (Administrador).
  3. Confira as permissões. As permissões padrão da função já vêm marcadas.
  4. Adicione uma nota particular se quiser lembrar para quem é o link.
  5. Escolha quanto tempo o link dura: de 1 a 30 dias, 7 por padrão.
  6. Clique em Make an invite link (criar um link de convite) e copie o link na hora. Você deve ver o link completo uma única vez; ele funciona uma única vez.

A pessoa abre o link, escolhe um nome único e uma senha que atenda ao mínimo atual. Depois disso ela já está com o login feito.

Para uma criança com limite de idade, veja Contas infantis.

Funções e permissões

Link para Funções e permissões
Função O que significa
Dono A primeira conta. Pode fazer tudo. Ninguém consegue alterar ou desativar essa conta nesta tela
Administrador Gerencia os Membros e a Biblioteca, dentro das permissões que tem
Membro Normalmente pede títulos e vê os próprios pedidos
Permissão O que permite Administrador novo Membro novo
Request titles (pedir títulos) Fazer pedidos Sim Sim
Requests approved without waiting (pedidos aprovados sem esperar) Os pedidos pulam a aprovação Sim Não
Approve or turn down requests (aprovar ou recusar pedidos) Decidir os pedidos de outras pessoas Sim Não
Run the Library (cuidar da Biblioteca) Buscar, organizar e gerenciar o trabalho da Biblioteca Sim Não
Change settings (alterar configurações) Abrir e alterar configurações comuns Não Não

Quem pode conceder o quê:

  • Só o Dono convida um Administrador ou transforma alguém em Administrador.
  • Um Administrador convida e altera Membros, e concede só as permissões que ele mesmo tem.
  • Ninguém altera a própria função nem as próprias permissões.
  1. Abra Settings > Users and roles e escolha a pessoa.
  2. Altere a função ou as permissões. Uma função nova marca as permissões padrão dela antes de você salvar.
  3. Opcional: defina limites semanais de pedidos para filmes, séries e música, de 0 a 1000 cada. Vazio usa o padrão de Settings > Request rules (Configurações > Regras de pedidos); 0 significa sem limite. Quem pode aprovar não tem limite.
  4. Clique em Save (salvar).

Turn off (desativar) desconecta a pessoa em todos os lugares, remove as chaves de API dela e bloqueia o login até você ativar a conta de novo. A conta continua existindo.

Essas alterações exigem um login com senha. Se você entrou pelo atalho da rede local, entre com sua senha primeiro.

Configurar o login em duas etapas

Link para Configurar o login em duas etapas

Cada pessoa faz isso na própria conta.

  1. Abra My account (minha conta), encontre Two-factor (duas etapas) e clique em Set up (configurar).
  2. Adicione a conta a um app autenticador, com o link ou a chave que aparece.
  3. Digite o código de 6 dígitos do app.
  4. Guarde os 10 códigos de backup em um lugar seguro. Você vê esses códigos só agora; cada um funciona uma única vez.

Para criar novos códigos de backup ou desativar as duas etapas, digite um código atual do app ou um código de backup ainda não usado. Os códigos novos substituem os antigos.

Exigir duas etapas para Administradores

Link para Exigir duas etapas para Administradores

O Dono ativa isso em Settings > Sign-in and security (Configurações > Login e segurança). Um Administrador sem as duas etapas passa a conseguir abrir só My account até configurar. Os Membros não são afetados.

Qualquer pessoa pode definir uma em My account > Profile picture (Minha conta > Foto de perfil): JPEG, PNG ou WebP, até 5 MB. O HolyArrs recorta o quadrado do meio para 256 por 256 pixels. Remove (remover) volta para as iniciais coloridas.

Sintoma: um link de convite não funciona. Causa: ele foi usado, expirou ou foi retirado, ou quem criou o link não é mais um Dono ou Administrador ativo. Solução: crie um novo. A lista Invite links (links de convite) mostra o estado de cada link; o Dono pode retirar qualquer link aberto, um Administrador só os próprios.

Sintoma: um Administrador não consegue marcar uma permissão. Causa: os Administradores concedem só as permissões que eles têm. Solução: peça ao Dono.

Sintoma: alguém perdeu o autenticador e os códigos de backup. Causa: não sobrou nenhum código para entrar. Solução: o Dono redefine as duas etapas de um Administrador ou de um Membro; um Administrador redefine as de um Membro. A pessoa é desconectada em todos os lugares, entra com a senha e configura de novo. Para o Dono, veja Esqueceu sua senha; reset-owner também desativa as duas etapas do Dono.

API da foto
Rota O que faz
PUT /api/v1/account/avatar A imagem como corpo. Responde {"avatar": "<address>"}. 413 acima de 5 MB, 415 quando não é JPEG, PNG ou WebP
DELETE /api/v1/account/avatar Remove sua foto
GET /api/v1/users/{id}/avatar A foto de uma pessoa, ou 404

GET /api/v1/auth/me e GET /api/v1/users incluem avatar, ou null. As alterações precisam do cabeçalho CSRF de sempre; uma chave de API precisa do escopo de escrita.

O HolyArrs é gratuito. Se ele poupou seu tempo, dê uma estrela no GitHub, patrocine o projeto ou me pague um café.