> For the complete documentation index, see [llms.txt](https://docs.gaiodataos.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gaiodataos.com/gaio-dataos-portuguese/configuracoes/usuarios.md).

# Usuários

<figure><img src="/files/ejry24r6MVd1jtlWOWRV" alt=""><figcaption></figcaption></figure>

A seção **Usuários** permite que administradores criem e gerenciem usuários, definam seus papéis (roles), atribuam grupos e controlem o acesso em todo o ambiente do Gaio DataOS.

***

### Criando um Novo Usuário

Para criar um novo usuário:

1. Clique em **Novo**
2. Selecione o **Tipo de Usuário**
3. Preencha as informações obrigatórias:
   * E-mail
   * Senha
4. Atribua o usuário a um **Grupo** (opcional)
5. Selecione o **Idioma** da interface
6. Clique em **Salvar**

***

## Tipos de Usuário (Roles)

### User

Destinado a usuários de negócio e consumidores de dashboards.

#### Acesso:

* Dashboards explicitamente compartilhados
* Interação somente leitura com análises e visualizações

#### Restrições:

* Sem acesso aos Studios
* Sem acesso a pipelines, tarefas ou modelagem
* Sem acesso às configurações do ambiente

#### Casos de uso típicos:

* Executivos
* Analistas de negócio
* Stakeholders que consomem insights

***

### Desenvolvedor

Destinado a usuários responsáveis por construir e manter fluxos de dados.

#### Acesso:

* Studios (ETL, Analytics, AI, Tasks)
* Dashboards
* Fontes de dados e recursos de projeto (conforme permissões atribuídas)

#### Restrições:

* Sem acesso às configurações globais do ambiente
* Não pode gerenciar usuários ou provedores de autenticação

#### Casos de uso típicos:

* Engenheiros de dados
* Analytics engineers
* Analistas técnicos

***

### Admin

Destinado à governança completa da plataforma e administração do sistema.

#### Acesso:

* Acesso total a todos os dashboards e studios
* Acesso total a todos os projetos e fontes de dados
* Acesso total às configurações, incluindo:
  * Users
  * Tags
  * Authentication providers
  * SMTP
  * White Label
  * AI e API keys

#### Casos de uso típicos:

* Administradores da plataforma
* Responsáveis por TI e segurança
* Donos do sistema

***

## Status do Usuário

Cada conta pode estar configurada como:

* **Ativo** – Usuário pode acessar a plataforma
* **Inativo** – Usuário desativado, sem acesso

***

## Grupos e Permissões

* Usuários herdam permissões do **Grupo** ao qual pertencem
* Grupos são conectados a projetos e fontes através de **Tags**
* Esse modelo permite controle de acesso centralizado e escalável

***

## Boas Práticas

* Atribua permissões por meio de **Grupos**, não individualmente
* Utilize o role **Usuário** para acesso apenas a dashboards
* Utilize o role **Desenvolvedor** para desenvolvimento de dados e pipelines
* Restrinja o role **Admin** a um grupo pequeno e confiável
* Revise periodicamente acessos e contas inativas

{% hint style="info" %}
O sistema de **Users & Roles** no Gaio DataOS foi projetado para garantir segurança, escalabilidade e clareza, concedendo a cada usuário o nível adequado de acesso — nem mais, nem menos.
{% endhint %}