Pular para o conteúdo

Utilizadores e funções

Configuração

Dá a cada pessoa da tua casa a sua própria conta, só com os direitos de que precisa. O proprietário e os administradores trabalham em Settings > Users and roles (Definições > utilizadores e funções).

  1. Abre Settings > Users and roles.
  2. Escolhe Member (membro). O proprietário também pode escolher Admin (administrador).
  3. Confirma as permissões. As predefinições da função já vêm assinaladas.
  4. Se quiseres, acrescenta uma nota privada para te lembrares para quem é a ligação.
  5. Escolhe quanto tempo a ligação dura: 1 a 30 dias, 7 por predefinição.
  6. Clica em Make an invite link (criar uma ligação de convite) e copia-a agora. Deves ver a ligação completa uma só vez; funciona uma só vez.

A pessoa abre a ligação, escolhe um nome único e uma palavra-passe que cumpra o mínimo atual. Fica então com a sessão iniciada.

Para uma criança com limite de idade, vê Contas de criança.

Função O que significa
Proprietário A primeira conta. Pode fazer tudo. Ninguém a pode mudar nem desativar neste ecrã
Administrador Gere membros e a Biblioteca, dentro das suas permissões
Membro Normalmente pede títulos e vê os seus próprios pedidos
Permissão O que permite Novo administrador Novo membro
Request titles Fazer pedidos Sim Sim
Requests approved without waiting Os pedidos dispensam aprovação Sim Não
Approve or turn down requests Decidir os pedidos de outras pessoas Sim Não
Run the Library Procurar, organizar e gerir o trabalho da Biblioteca Sim Não
Change settings Abrir e mudar as definições normais Não Não

Quem pode dar o quê:

  • Só o proprietário convida um administrador ou torna alguém administrador.
  • Um administrador convida e altera membros, e só dá permissões que ele próprio tem.
  • Ninguém muda a sua própria função nem as suas permissões.
  1. Abre Settings > Users and roles e escolhe a pessoa.
  2. Muda a função ou as permissões. Uma função nova assinala as suas predefinições antes de guardares.
  3. Opcional: define limites semanais de pedidos para filmes, séries e música, de 0 a 1000 cada. Vazio usa o valor predefinido de Settings > Request rules (Definições > regras de pedidos); 0 significa sem limite. Quem pode aprovar não tem limite.
  4. Clica em Save (guardar).

Turn off (desativar) termina a sessão da pessoa em todo o lado, remove as chaves de API dela e bloqueia o início de sessão até a ativares. A conta mantém-se.

Estas alterações precisam de um início de sessão com palavra-passe. Se entraste pelo atalho da rede local, inicia primeiro sessão com a tua palavra-passe.

Configurar o início de sessão com dois fatores

Ligação para Configurar o início de sessão com dois fatores

Cada pessoa faz isto na sua própria conta.

  1. Abre My account (a minha conta), procura Two-factor (dois fatores) e clica em Set up (configurar).
  2. Adiciona a conta a uma app de autenticação, com a ligação ou a chave mostrada.
  3. Escreve o código de 6 dígitos da app.
  4. Guarda os 10 códigos de recuperação num sítio seguro. Só os vês agora; cada um funciona uma só vez.

Para criar códigos de recuperação novos ou desativar os dois fatores, escreve um código atual da app ou um código de recuperação por usar. Os códigos novos substituem os antigos.

Exigir dois fatores aos administradores

Ligação para Exigir dois fatores aos administradores

O proprietário ativa isto em Settings > Sign-in and security (Definições > início de sessão e segurança). Um administrador sem dois fatores só pode então abrir My account até o configurar. Os membros não são afetados.

Qualquer pessoa pode definir uma em My account > Profile picture (imagem de perfil): JPEG, PNG ou WebP, até 5 MB. O HolyArrs recorta o quadrado do meio para 256 por 256 píxeis. Remove (remover) volta às iniciais a cores.

Sintoma: uma ligação de convite não funciona. Causa: foi usada, expirou ou foi retirada, ou quem a criou já não é proprietário nem administrador ativo. Solução: cria uma nova. A lista Invite links (ligações de convite) mostra o estado de cada ligação; o proprietário pode retirar qualquer ligação aberta, um administrador só as suas.

Sintoma: um administrador não consegue assinalar uma permissão. Causa: os administradores só dão permissões que têm. Solução: pede ao proprietário.

Sintoma: alguém perdeu a app de autenticação e os códigos de recuperação. Causa: não resta nenhum código para iniciar sessão. Solução: o proprietário repõe os dois fatores de um administrador ou membro; um administrador repõe-nos a um membro. A pessoa fica sem sessão em todo o lado, inicia sessão com a palavra-passe e configura tudo outra vez. Para o proprietário, vê Esqueceste-te da palavra-passe; reset-owner também desativa os dois fatores do proprietário.

API da imagem
Rota O que faz
PUT /api/v1/account/avatar Imagem como corpo. Responde {"avatar": "<address>"}. 413 acima de 5 MB, 415 quando não é JPEG, PNG nem WebP
DELETE /api/v1/account/avatar Remove a tua imagem
GET /api/v1/users/{id}/avatar A imagem 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 habitual; uma chave de API precisa do âmbito de escrita.

O HolyArrs é gratuito. Se te poupou tempo, dá-lhe uma estrela no GitHub, patrocina-o ou oferece-me um café.