Usuários & Papéis
Usuários e Papéis
O Chinaski tem dois papéis de conta (admin e editor), mais restrições por usuário que permitem delimitar um editor a tipos de conteúdo ou idiomas particulares. Esta página explica o que cada papel pode fazer, como as contas são criadas e gerenciadas, e as salvaguardas que impedem o gerenciamento de usuários de trancar todo mundo fora.
Os dois papéis
Admin: acesso completo. Apenas admins podem gerenciar usuários, chaves de API, backups e configurações do site, e apenas as rotas de admin são aplicadas no servidor (verificar somente no navegador nunca é considerado confiável).
Editor: escreve e gerencia conteúdo. Contas autorregistradas e provisionadas por SSO são sempre criadas como editor; os admins podem escolher qualquer um dos papéis ao criar uma conta (qualquer outro valor é convertido para editor antes de ser salvo).
Delimitando os poderes de um editor
Uma conta de usuário pode ter duas listas de restrições, definidas por um admin na tela de edição do usuário:
- Tipos de conteúdo permitidos: se vazia, o editor pode gerenciar tudo. Se definida, ele só pode gerenciar as áreas listadas: páginas, posts, blocos, snippets, documentos, categorias, formulários, mídia, navegação, stacks, design tokens e redirecionamentos. Tentar abrir outra área o envia de volta ao painel com a mensagem "não autorizado".
- Idiomas permitidos: se vazia, o editor pode trabalhar em todos os idiomas; se definida, ele vê e gerencia somente esses idiomas.
Os admins são sempre isentos das duas restrições.
Criando contas
Os admins podem criar contas diretamente na área de admin, com:
- Um nome de usuário de 3 a 32 caracteres (letras, dígitos, sublinhado, ponto, hífen).
- Um papel de admin ou editor.
- Uma senha que atenda aos requisitos padrão (pelo menos 8 caracteres, com maiúscula, minúscula e dígito).
- Um e-mail opcional.
Duas facilidades acompanham isso:
- Convite ao criar: o formulário pode enviar ao novo usuário, por e-mail, um link de convite válido por 7 dias para que ele defina (ou altere) a própria senha.
- Importação de CSV: envie uma planilha de contas, de até 4 MiB, com as colunas
username,passworderole, útil para migrar uma equipe.
Há também maneiras não administrativas de as contas surgirem:
- O autorregistro (desativado por padrão; ativado nas configurações) cria uma conta de editor sujeita às regras padrão e aos limites de taxa de registro.
- O login por SSO provisiona automaticamente uma conta de editor na primeira vez que um usuário autorizado chega, com uma senha aleatória inutilizável e, se o nome já estiver em uso, um sufixo numérico no nome de usuário.
- Para um usuário existente, os admins podem enviar separadamente por e-mail um link de redefinição de senha (válido por 1 dia) ou um link de convite (válido por 7 dias); cada um exige um e-mail cadastrado e substitui qualquer link pendente desse usuário.
Poderes cotidianos do admin sobre usuários
Na lista de usuários, os administradores podem:
- Suspender alguém: um usuário suspenso fica impedido de entrar (ele vê a mesma mensagem de "credenciais inválidas" que todos os outros veem) e é desconectado imediatamente de todos os seus dispositivos. Você não pode suspender a si mesmo. Reativar restaura o acesso a qualquer momento.
- Excluir uma conta: isso remove o usuário, além de suas sessões e links de redefinição. Como salvaguardas, você não pode excluir a própria conta, e a exclusão é bloqueada se deixasse o site sem nenhum usuário.
- Alterar em massa: selecione vários usuários para excluir, mudar o papel (tornar admin / tornar editor) ou suspender/reativar em uma única ação. Você nunca é incluído na sua própria seleção em massa, e a exclusão não pode remover todos os usuários.
- Redefinir ou definir uma senha (conforme descrito na página de Senhas): uma senha em branco no formulário de edição altera somente os dados de perfil; definir uma nova senha desconecta esse usuário de suas sessões.
- Revogar sessões individualmente: cada login ativo de um usuário pode ser revogado a partir da tela de edição dele.
Salvaguardas contra bloqueio total
Vários erros são deliberadamente tornados impossíveis:
- Você não pode rebaixar a si mesmo de admin para editor enquanto for o único admin ativo: a tentativa é recusada com uma mensagem clara antes de a alteração ser salva.
- Você não pode excluir nem suspender a própria conta.
- Você não pode excluir nem excluir em massa a última conta de usuário restante.
Controle de perfil e sessões (todas as contas)
Todo usuário, independentemente do papel, tem uma página de conta na qual pode:
- Alterar a senha (exigindo a atual; veja Senhas).
- Atualizar o nome de exibição, o fuso horário e o avatar.
- Usar "sair de todos os outros dispositivos", que invalida todas as sessões exceto a que está em uso.
Tudo o que os admins fazem aqui é registrado no log de auditoria: quem alterou o quê, em qual usuário e quando.