> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Gerenciando Usuários

> Crie, edite, redefina a senha e exclua contas de usuário, e gerencie funções, grupos e permissões na área Autorização do Lerian Console.

Os usuários ficam na área Autorização do Lerian Console, ao lado de Funções, Grupos e Permissões. Abra Autorização pela entrada **Autorização** na barra lateral de Configurações ou pelo menu de engrenagem na barra superior.

Funções e permissões controlam o que cada usuário pode fazer.

A página Usuários precisa do Access Manager e da permissão de leitura em usuários. Sem essa permissão, o Console mostra uma página de não autorizado em vez da lista.

Na Lerian Cloud, a lista mostra apenas os usuários do tenant do administrador logado. O Console não expõe usuários de outros tenants.

## A página Usuários

***

A tabela tem seis colunas:

| Coluna | O que mostra |
| - | - |
| **Nome** | O nome completo do usuário, com o identificador do usuário abaixo. |
| **E-mail** | O endereço de e-mail do usuário. |
| **Nome de usuário** | O identificador de login. |
| **Grupos** | O primeiro grupo do usuário e um badge `+N` que lista o resto. |
| **MFA** | O status de autenticação multifator do usuário. |
| **Ações** | O menu da linha. |

Você escolhe quais colunas a tabela mostra. A lista tem paginação, e o rodapé informa a faixa na tela e o total.

O menu da linha tem três itens: **Ver Detalhes**, **Editar** e **Excluir**. O Console mostra **Editar** apenas para uma conta com a permissão de atualização em usuários. Ele mostra **Excluir** apenas para uma conta com a permissão de exclusão em usuários.

## Crie um usuário

***

**1. Abra o formulário**

Clique em **Novo Usuário**. A página **Novo usuário** abre.

**2. Preencha os campos**

A seção **Dados pessoais** pede **Nome**, **Sobrenome**, **Nome de Usuário** e **E-mail**. A seção **Senha** pede **Senha** e **Confirmar Senha**. A seção **Acesso** pede **Grupos**.

**3. Salve**

Clique em **Criar usuário**. Este passo precisa da permissão de criação em usuários. O Console abre a página do novo usuário.

O Console aplica estas regras:

* **Nome** e **Sobrenome** são obrigatórios, e **Nome de Usuário** tem pelo menos 3 caracteres.
* **Nome de usuário** aceita letras, números, hifens e underscores.
* **E-mail** tem um endereço válido.
* **Senha** tem pelo menos 12 caracteres, com uma letra maiúscula, uma letra minúscula, um número e um caractere especial.
* **Senha** rejeita dois caracteres idênticos lado a lado, então `aa` e `11` falham.
* **Grupos** aceita um ou mais grupos. Pelo menos um é obrigatório.

> [!NOTE]
>
> O Console verifica estas regras antes de enviar o formulário. O backend de identidade pode aplicar outras regras.

## Edite um usuário

***

**1. Abra o menu da linha**

Encontre o usuário, abra o menu na coluna **Ações** e selecione **Editar**.

**2. Mude os campos**

O painel tem duas abas: **Informações Pessoais** e **Senha**. Na aba **Informações Pessoais** você muda o **Nome**, o **Sobrenome**, o **E-mail** e os **Grupos**. A aba não tem campo de nome de usuário, então o usuário mantém o nome de usuário que recebeu na criação.

**3. Salve**

Clique em **Salvar**.

## Redefina a senha de um usuário

***

**1. Abra a aba Senha**

Selecione **Editar** no menu da linha e abra a aba **Senha**.

**2. Digite a nova senha**

Preencha **Nova Senha** e **Confirmar Senha**. A nova senha segue as regras em [Crie um usuário](#create-a-user).

**3. Salve e confirme**

Clique em **Salvar**. Abre um diálogo com o título "Alterar senha". Clique em **Sim, alterar senha**.

> [!NOTE]
>
> Esta é uma redefinição feita pelo administrador. Ela não pede a senha atual e não define uma senha temporária. O usuário entra com a nova senha na próxima vez.

> [!NOTE]
>
> Para gerenciar a própria autenticação multifator, use **Configurações** › **Segurança**. Para redefinir a própria senha, use **Esqueci minha senha?** na página de login. O link aparece quando o deploy define `ENABLE_FORGOT_PASSWORD` como `true`.

## Exclua um usuário

***

> [!WARNING]
>
> Excluir um usuário **remove a conta permanentemente.** Esta ação não pode ser desfeita.

Encontre o usuário, abra o menu na coluna **Ações** e selecione **Excluir**. Um diálogo com o título "Confirmar Exclusão" informa: "Você está prestes a excluir este usuário permanentemente. Esta ação não pode ser desfeita. Deseja continuar?" O Console então responde com a mensagem "Usuário excluído com sucesso".

O Console não oferece **Excluir** na sua própria conta.

## Funções, grupos e permissões

***

A barra lateral de Autorização tem cinco entradas: Visão Geral, Usuários, Funções, Grupos e Permissões.

Uma permissão nomeia um recurso e uma ação. Você a concede a uma função ou diretamente a um usuário. Um usuário recebe uma função diretamente ou por meio de um grupo.

**Ver Detalhes** no menu da linha abre uma página para um usuário. Essa página tem seis abas: **Acesso Efetivo**, **Funções**, **Grupos**, **Permissões Diretas**, **Perfil** e **Segurança**.

## A página Funções

***

A tabela Funções tem seis colunas: **Nome**, **Tipo**, **Usuários**, **Grupos**, **Status** e **Ações**. **Tipo** mostra **Sistema** ou **Personalizada**. **Status** mostra **Ativada** ou **Desativada**.

A plataforma gerencia as funções do sistema. Uma função do sistema não tem menu da linha. A célula **Ações** dela diz "Esta função é gerenciada pela plataforma e não pode ser editada pelo console".

O menu da linha de uma função personalizada tem **Ver Detalhes**, **Editar** e **Excluir**. O Console mostra **Editar** apenas para uma conta com a permissão de atualização em funções. Ele mostra **Excluir** apenas para uma conta com a permissão de exclusão em funções.

## Crie uma função

***

**1. Abra o formulário**

Na página Funções, clique em **Nova Função**. O formulário abre no lado direito da tela.

**2. Preencha os campos**

O formulário pede **Nome**, **Nome de Exibição** e **Descrição**.

**3. Salve**

Clique em **Salvar**. Este passo precisa da permissão de criação em funções. A nova função aparece na lista.

O Console aplica estas regras:

* **Nome** e **Nome de Exibição** são obrigatórios.
* **Nome** tem de 2 a 100 caracteres: letras, números, hifens e underscores.
* **Nome de Exibição** tem no máximo 100 caracteres. **Descrição** tem no máximo 500.

## Edite uma função

***

**1. Abra o menu da linha**

Encontre a função, abra o menu na coluna **Ações** e selecione **Editar**.

**2. Mude os campos**

Mude o **Nome de Exibição**, a **Descrição** ou a chave **Ativada**. O campo **Nome** é somente leitura, então a função mantém o nome que recebeu na criação.

**3. Salve**

Clique em **Salvar**.

## Atribua permissões, usuários e grupos a uma função

***

**Ver Detalhes** no menu da linha abre uma página para uma função. Essa página tem três abas: **Permissões**, **Usuários** e **Grupos**. Cada aba lista o que a função tem.

**1. Abra a aba**

Na página da função, abra a aba **Permissões**, **Usuários** ou **Grupos**.

**2. Abra o painel**

Clique em **Adicionar Permissões**, **Adicionar Usuários** ou **Adicionar Grupos**. Abre um painel com uma caixa de busca.

**3. Selecione os itens**

Selecione os itens para adicionar. Um item que a função já tem mostra "Já atribuído".

**4. Atribua**

Clique no botão na parte de baixo do painel, por exemplo **Atribuir 2 Permissões**.

O painel **Adicionar Permissões** também filtra a lista por **Recurso**.

Para remover um item, use o botão de remover na linha dele. Para remover mais de um, selecione as linhas e clique em **Remover Selecionados**. O Console pede que você confirme.

Uma função do sistema mostra o aviso "Função do Sistema". As abas dela não oferecem adicionar nem remover.

Um produto Lerian pode declarar as próprias funções e permissões, e o Console lista uma função declarada como **Personalizada**. Em uma função declarada, o Identity recusa com `422` mudar a descrição ou os grupos. Ele também recusa adicionar ou remover uma permissão que um produto declara. Veja [Serviço Identity](https://docs.lerian.studio/pt/platform/access-manager/identity-plugin.md).

## Crie um grupo

***

**1. Abra o formulário**

Na página Grupos, clique em **Novo Grupo**. O formulário abre no lado direito da tela.

**2. Preencha os campos**

O formulário pede **Nome**, **Nome de Exibição** e **E-mail de Contato**.

**3. Salve**

Clique em **Salvar**. Este passo precisa da permissão de criação em grupos. O novo grupo aparece na lista.

**Nome** e **Nome de Exibição** seguem as mesmas regras de uma função. **E-mail de Contato** é opcional. Quando você o preenche, ele tem um endereço válido.

A tabela Grupos mostra **Nome**, **Membros** e **Ações**. O menu da linha tem **Ver Detalhes**, **Editar** e **Excluir**. O Console mostra **Editar** apenas para uma conta com a permissão de atualização em grupos. Ele mostra **Excluir** apenas para uma conta com a permissão de exclusão em grupos.

## Edite um grupo

***

**1. Abra o menu da linha**

Encontre o grupo, abra o menu na coluna **Ações** e selecione **Editar**.

**2. Mude os campos**

Mude o **Nome de Exibição** ou o **E-mail de Contato**. O campo **Nome** é somente leitura.

**3. Salve**

Clique em **Salvar**.

## Adicione membros e funções a um grupo

***

**Ver Detalhes** no menu da linha de um grupo abre uma página com duas abas: **Membros** e **Funções**.

**1. Abra a aba**

Na página do grupo, abra a aba **Membros** ou **Funções**.

**2. Abra o painel**

Clique em **Adicionar Membros** ou **Adicionar Funções**. Abre um painel com uma caixa de busca.

**3. Selecione e adicione**

Selecione os usuários ou as funções. Clique no botão na parte de baixo do painel, por exemplo **Adicionar 2 Membros** ou **Atribuir 2 Funções**.

Para remover um membro ou uma função do grupo, use os mesmos botões da página de uma função.

## Consulte as permissões

***

A página Permissões mostra as permissões agrupadas por recurso. Busque pelo nome ou filtre por **Recurso**. Clique no nome de um recurso para abrir ou fechar a tabela dele.

Cada tabela de recurso tem seis colunas:

| Coluna | O que mostra |
| - | - |
| **Nome** | O nome da permissão, com o identificador da permissão abaixo. |
| **Ações** | As ações que a permissão cobre. |
| **Efeito** | **Permitir** ou **Negar**. |
| **Funções** | As funções que têm a permissão, como links. |
| **Usuários** | O número de usuários com a permissão. |
| **Grupos** | O número de grupos com a permissão. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.