> For the complete documentation index, see [llms.txt](https://docs.roboteasy.tech/studio/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboteasy.tech/studio/geral/cofre-de-senhas.md).

# Cofre de Senhas

### Visão Geral

O **Cofre de Senhas** é a ferramenta do Genesis para gerenciar credenciais de acesso com segurança. Em vez de expor senhas diretamente, você cria um cofre com os dados de acesso e disponibiliza apenas o **nome do cofre** para o desenvolvedor — garantindo que terceiros nunca tenham acesso à senha em si.

**Exemplo prático:** seu robô precisa acessar a conta bancária da empresa para capturar extratos. Você cria um cofre com os dados de acesso ao banco e disponibiliza ao desenvolvedor somente o nome do cofre.

<figure><img src="/files/5fYCSFmqpgcMjxSv9wIQ" alt=""><figcaption></figcaption></figure>

<p align="center">Tela de listagem de cofres cadastrados</p>

***

### Pré-requisitos

* Acesso ao Genesis com credenciais de login válidas
* Campos do tipo **Password** na página web alvo da automação

***

### Como usar

#### Passo 1 — Criar um cofre

Na tela **Lista de Cofres**, clique em **Adicionar** para criar um novo cofre. Defina o nome (código) do cofre — este será o identificador usado na sintaxe de chamada.

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

<p align="center">Tela de criação de cofre com o campo de código</p>

#### Passo 2 — Cadastrar senhas no cofre

Com o cofre criado, selecione-o e clique em **Senhas > Adicionar**. O modal de inclusão de senha será aberto.

Preencha os campos:

* **Código** — identificador da senha dentro do cofre (não aceita caracteres especiais)
* Demais campos de credencial conforme o acesso que está sendo cadastrado

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

<p align="center">Modal de cadastro de senha dentro do cofre</p>

#### Passo 3 — Configurar permissões

Selecione o cofre digite o e-mail e clique em **Adicionar** para definir quais usuários terão acesso ao cofre.

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

<p align="center">Modal de configuração de permissões do cofre</p>

#### Passo 4 — Usar o cofre na rotina

No campo **Senha** do componente que estiver utilizando, aplique a seguinte sintaxe:

cof.\[nome-do-cofre].\[código-da-senha]

**Exemplo:**

cof.ExemploDeCofre.planilha

Onde:

* `ExemploDeCofre` → código do cofre
* `planilha` → código da senha cadastrada no cofre

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

<p align="center">Campo senha de um componente com a sintaxe do cofre preenchida</p>

***

### Campos e opções

#### Cadastro de cofre

| Campo           | Descrição                                          | Valores aceitos                |
| --------------- | -------------------------------------------------- | ------------------------------ |
| Código do cofre | Identificador do cofre usado na sintaxe de chamada | Texto sem caracteres especiais |

#### Cadastro de senha

| Campo  | Descrição                              | Valores aceitos                |
| ------ | -------------------------------------- | ------------------------------ |
| Código | Identificador da senha dentro do cofre | Texto sem caracteres especiais |

#### Sintaxe de uso

| Parte               | Descrição                                   |
| ------------------- | ------------------------------------------- |
| `cof.`              | Prefixo obrigatório que indica uso do cofre |
| `[nome-do-cofre]`   | Código do cofre cadastrado                  |
| `[código-da-senha]` | Código da senha cadastrada dentro do cofre  |

***

### Observações e dicas

* 💡 Agrupe senhas relacionadas em um mesmo cofre — por exemplo, todas as credenciais de um sistema em um único cofre — para facilitar a gestão e as permissões.
* 💡 Compartilhe com o desenvolvedor **apenas o nome do cofre e o código da senha** — nunca a senha em si. Esse é o propósito central da ferramenta.
* 💡 As senhas podem ser atualizadas a qualquer momento pelo mesmo caminho no Genesis, sem necessidade de alterar a rotina do robô.
* ⚠️ O campo **Código** (do cofre e da senha) **não aceita caracteres especiais** — use apenas letras, números e underline.
* ⚠️ O cofre de senhas funciona apenas com campos do tipo **Password** em páginas web — não é compatível com campos de texto comum.
* ⚠️ Todos os registros são armazenados **localmente** e não trafegam pela web — garanta backup adequado do ambiente.