# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.gaiodataos.com/gaio-dataos-portuguese/configuracoes/usuarios.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.