Wiki

Usuários

Criar e gerenciar contas do uVersion: papéis, senha, desativação, assentos de licença. Quem pode fazer o quê entre super admin e project_admin.

Introdução

A lista de usuários: nome, email, papel, status (ativo/inativo), último login.

A aba Usuários do painel de administração serve para criar contas, atribuir-lhes um papel, redefinir uma senha e desativar ou reativar uma conta. A lista mostra, para cada usuário, seu nome, seu email, seu papel, seu status (ativo / inativo) e seu último login.

O papel atribuído aqui determina o que a conta pode fazer. Para o detalhamento dos papéis, consulte Papéis & painel admin.

Acesso e delimitação

Super admin: vê todas as contas e dispõe de todas as ações (criar, editar, redefinir, desativar).
project_admin: só pode criar contas. Sua lista é delimitada: ele vê a si mesmo, as contas que criou e qualquer pessoa que detenha uma permissão (direta ou via grupo) sobre um de seus repositórios. Os botões Edit / Reset / Deactivate não são exibidos para ele.

A criação é a "metade segura": uma conta nova não tem acesso a nada enquanto não lhe for concedida uma permissão. Editar ou redefinir uma conta existente mexe em um acesso já estabelecido, daí a reserva ao super admin.

Criar um usuário

O formulário Create User (Username, Email, Password, Role) com o seletor de papel limitado pelo rank.

Aba Usuários → Create User.
Preencha os campos e confirme.

Campo	Restrição
Username	De 1 a 64 caracteres, único.
Email	Não vazio, deve conter `@`, único.
Password	Pelo menos 8 caracteres.
Role	Um dos 9 papéis. Padrão `user`.

Um nome de usuário ou um email já em uso é recusado (erro de conflito).

Escolher o papel

O seletor lista os 9 papéis, mas você só pode atribuir um papel estritamente abaixo do seu próprio rank. Um lead, portanto, não pode criar um admin, e ninguém pode criar uma conta de rank igual ou superior ao seu. Consulte Ranks e proteção.

Editar uma conta

A janela de edição de uma conta: email, papel, estado ativo (o nome de usuário é fixo).

O botão Edit (super admin) permite alterar o email, o papel e o estado ativo. O nome de usuário, por sua vez, é fixo.

Efeito imediato Alterar o papel de uma conta revoga imediatamente suas sessões em curso: um rebaixamento ou uma promoção se aplica na hora, sem esperar a expiração natural do token (até 30 dias, caso contrário).

Redefinir a senha

O botão Reset Password (super admin) define uma nova senha (mínimo de 8 caracteres). Assim como em uma mudança de papel, isso revoga todas as sessões existentes da conta: a senha antiga e os tokens já emitidos param de funcionar imediatamente.

Desativar, reativar

O uVersion não faz exclusão definitiva. O botão de exclusão é, na verdade, uma desativação: a conta fica inativa, seus bloqueios (locks) são liberados e ela é desconectada. Você pode reativá-la mais tarde.

Uma conta ativa oferece Deactivate.
Uma conta inativa oferece Reactivate.
Você não pode desativar a si mesmo.

Manter a conta em vez de destruí-la preserva o histórico (quem fez commit de quê) e permite o retorno do funcionário sem recriar uma conta.

Assentos de licença

A criação e a reativação consomem um assento Cada conta ativa ocupa um assento da licença do servidor. Se a cota for atingida, criar um novo usuário ou reativar um falha com um erro explícito (e não em silêncio). Libere um assento desativando uma conta, ou aumente o número de assentos a partir da sua área de licenças.

Armadilhas comuns

Reativação recusada embora a conta exista

Não é um bug: a cota de assentos está cheia. Desative outra conta primeiro, ou adicione assentos.

"Não vejo um usuário na minha lista"

Se você é project_admin, a lista é delimitada. Uma conta só aparece nela se pertence a você (criada por você), se detém uma permissão sobre um de seus repositórios, ou se é você. Conceda-lhe uma permissão sobre um de seus repositórios para que ela fique visível.

Uma mudança de papel não "pega"

A mudança é imediata no lado do servidor, mas o usuário em questão é desconectado: ele precisa entrar novamente para que seu cliente reflita o novo papel.