Adicionar e gerenciar usuários

Esta página mostra o gerenciamento do dia a dia das pessoas da sua organização: adicioná-las, encontrá-las, manter os dados delas atualizados e desativá-las ou excluí-las.

Antes de começar

Permissões. Adicionar, modificar e excluir usuários exige o papel Proprietário ou Administrador. Os papéis Helpdesk, Auditor e Faturamento podem visualizar os usuários. Veja Papéis administrativos.
Um domínio verificado. Pessoas com e-mail em um dos seus domínios verificados são criadas como usuários gerenciados e já podem entrar. Todas as demais são convidadas.

Encontrar usuários

Entre no console de administração.
Na barra lateral, selecione Usuários. A página Gerenciar Usuários se abre na aba Usuários Humanos.

A lista mostra o nome, o e-mail, o cargo, o Papel administrativo, o Status, o Tipo de conta e a data de criação de cada usuário. Para refinar:

Digite parte de um nome ou e-mail em Buscar usuários.
Filtre por Papel administrativo, Status ou Tipo de conta. Por exemplo, filtre pelo status Revisão pendente para encontrar as contas que precisam da sua atenção.

Selecione uma linha para abrir a página do usuário.

Adicionar um usuário

Na página Gerenciar Usuários, selecione Novo Usuário.
Mantenha Tipo de usuário em Usuário humano.
Preencha os campos descritos abaixo.
Selecione Criar usuário.

O que acontece em seguida depende do endereço de e-mail:

Em um domínio verificado: o usuário é criado como Gerenciado e Ativo. Ele recebe um e-mail de boas-vindas e já pode entrar com a senha inicial que você escolheu. No primeiro acesso, ele precisa escolher a própria senha.
Em qualquer outro domínio: o formulário avisa que o usuário será adicionado como Convidado, e não há senha inicial. O usuário é criado como Pendente e recebe um convite por e-mail. Veja Convites.

Campo	Descrição
Nome, Sobrenome	Obrigatórios.
E-mail	Obrigatório. Digite a parte antes do `@` e escolha um dos seus domínios verificados, ou escolha outro para digitar um endereço completo em outro domínio. Um endereço de e-mail só pode ser usado por um usuário na organização.
Senha inicial	Apenas para usuários gerenciados. Precisa seguir a política de senhas da sua organização. Envie-a à pessoa por um canal seguro.
Papel administrativo	Deixe em Nenhum para quem só entra nas aplicações. Escolha um papel apenas para quem ajuda a gerenciar o BreezeAuth. Veja Papéis administrativos.
Informações Profissionais	Opcionais: cargo, departamento, matrícula, centro de custo, unidade organizacional, local de trabalho.
Contato	Opcional. Informe os telefones no formato internacional, com `+` e o código do país, por exemplo `+55 11 99999-9999`.
Documentos e Endereço	Opcionais. O CPF precisa ser válido. O CEP tem 8 dígitos, digitados sem o hífen, por exemplo `01310100`.

Dica: para adicionar muitas pessoas de uma vez, ou para manter os usuários sincronizados com o seu sistema de RH ou outro diretório, use o provisionamento automático com SCIM em vez de adicioná-los um a um.

Ver um usuário

A página do usuário mostra o nome, o Status e o Tipo de conta no topo, e tem quatro abas:

Aba	O que mostra
Visão Geral	Informações do usuário (e-mail, tipo de conta, papel, status e MFA, para usuários gerenciados), Informações Profissionais, Contato e Documentos e Endereço.
Aplicações atribuídas	As aplicações em que o usuário pode entrar, e se cada uma foi atribuída diretamente ou por um grupo. Veja Acesso a aplicações.
Grupos	Os grupos aos quais o usuário pertence, diretamente ou indiretamente por meio de grupos aninhados. Marque Exibir somente associações diretas para ocultar os herdados.
Sessões Ativas	Apenas para usuários gerenciados: os dispositivos em que o usuário está conectado ao BreezeAuth. Veja Segurança da conta.

Nas abas Aplicações atribuídas e Grupos, use o ícone de lixeira para remover uma aplicação atribuída diretamente ao usuário, ou para tirá-lo de um grupo ao qual ele foi adicionado diretamente. O acesso que vem de um grupo só pode ser removido no próprio grupo.

Modificar um usuário

Abra o usuário e selecione Modificar.
Altere os campos necessários.
Selecione Salvar alterações.

O alcance das suas alterações depende do tipo de conta:

Usuários gerenciados: as alterações no nome, no e-mail, nos contatos e no endereço também são aplicadas à conta da pessoa no BreezeAuth. O e-mail só pode ser trocado por outro endereço em um dos seus domínios verificados.
Convidados: as alterações afetam apenas como a pessoa aparece na sua organização. A conta dela, e os dados que ela tem em outras organizações, continuam iguais. O e-mail de um convidado não pode ser alterado: selecione Por que não posso alterar o e-mail? no formulário para ver o motivo e as alternativas.

Dar o papel Proprietário a alguém, ou alterar um usuário que é Proprietário, pede a sua senha atual. Veja Regras do papel de Proprietário.

Ativar ou desativar um usuário

Quando alguém se afasta, temporária ou definitivamente, desativá-lo é a forma mais rápida de remover o acesso dele mantendo o registro:

Abra o usuário. Na aba Visão Geral, selecione o ícone de lápis ao lado de Status.
Em Alterar status para:, selecione Inativo.

Você também pode alterar o campo Status no formulário de Modificar. Para devolver o acesso, volte o status para Ativo.

Tipo de conta	O que a desativação faz
Gerenciado	A conta da pessoa no BreezeAuth é desativada: ela não consegue mais entrar no BreezeAuth, e as sessões dela param de funcionar.
Convidado	A pessoa não consegue mais entrar nas aplicações da sua organização nem usar o seu console de administração. Ela ainda pode entrar no BreezeAuth e nas outras organizações de que faz parte.

Nos dois casos, os grupos e as atribuições de aplicações do usuário são mantidos e voltam a valer quando você o reativa.

Importante: desativar um usuário impede novos acessos pelo BreezeAuth. As sessões que a pessoa já tem abertas dentro de uma aplicação são gerenciadas por essa aplicação e podem durar até expirarem lá.

Excluir um usuário

Abra o usuário e selecione Excluir.
Se o usuário for Proprietário, informe a sua Senha atual.
Confirme na janela Excluir usuário.

A exclusão de um usuário não pode ser desfeita. O BreezeAuth:

remove o usuário de todos os grupos e de todas as atribuições de aplicações;
cancela o convite dele, se ainda estiver pendente;
no caso de um usuário gerenciado, também exclui a conta da pessoa no BreezeAuth: ela não consegue mais entrar em lugar nenhum com essa conta;
no caso de um convidado, mantém a conta: ele apenas sai da sua organização.

Atenção: prefira desativar a excluir quando você puder precisar do histórico ou do acesso da pessoa de novo. Um usuário excluído, com os seus grupos e atribuições, não pode ser restaurado: seria preciso adicioná-lo de novo do zero.

A organização precisa ter sempre pelo menos um Proprietário ativo, então o último não pode ser excluído nem desativado.

Provisionar usuários automaticamente com SCIM

Se a sua empresa mantém as pessoas em outro sistema, como uma plataforma de RH ou outro diretório de identidades, esse sistema pode criar, atualizar, desativar e remover usuários no BreezeAuth automaticamente, usando o padrão SCIM 2.0. Ele se conecta como um usuário de serviço com o papel Provisionador SCIM. Veja Provisionamento SCIM para configurá-lo e Provisionar usuários com SCIM para entender o efeito de cada alteração.

Os usuários criados por SCIM seguem as mesmas regras dos criados no console de administração: são gerenciados se o e-mail estiver em um domínio verificado e, caso contrário, são convidados. Evite modificar à mão os usuários provisionados: o sistema de provisionamento pode desfazer as suas alterações na próxima sincronização.

As mudanças são auditadas e podem ser enviadas aos seus sistemas

A adição, a atualização e a exclusão de usuários, assim como o envio, o aceite e a recusa de convites, ficam registrados nos Logs de Auditoria da sua organização, com quem fez a mudança e quando. Se os seus sistemas precisam reagir a essas mudanças, inscreva um webhook nos eventos de usuários.