# Cadastrar um setor no mongo e keycloak

Cadastrar um setor novo para um usuário existente no e-Ciga exige ações tanto no **Keycloak (SSO)** quanto no **Mongo Express (banco de dados)**. Abaixo está o passo a passo completo.

<div id="bkmrk-">---

</div>### 🔐 1. Acessar o Keycloak (SSO)

1. Vá até [https://sso.ciga.sc.gov.br/](https://sso.ciga.sc.gov.br/).
2. Acesse a **realm** correspondente ao ente do usuário.
3. No menu lateral, clique em **Groups**.
4. Expanda a opção **Setores**.
5. Clique no botão **New**.
6. No campo exibido, digite o **nome do novo setor** exatamente como deseja que apareça no sistema.
7. Clique em **Save**.

<div id="bkmrk--1">---

</div>### 🧬 2. Inserir o Setor no MongoDB (Mongo Express)

1. Acesse [https://mongo.eciga.consorciociga.gov.br/](https://mongo.eciga.consorciociga.gov.br/).
2. No menu lateral, selecione a base de dados com o nome da **realm** do usuário.
3. Localize a coleção chamada **setores**.
4. Clique em **New Document**.
5. Insira o seguinte código no campo de texto:

```
{
    "_id": ObjectId(),
    ente: 'niteroi',
    nome: 'nome do setor'
}
```

> 🔸 **Importante:**
> 
> - Substitua `niteroi` pelo ente correto.
> - Substitua `nome do setor` pelo nome digitado exatamente como foi criado no Keycloak.
> - Use **vírgulas corretamente** entre os campos.

6. Clique em **Save** para gravar o setor na base de dados.

<div id="bkmrk--2">---

</div>### 👤 3. Vincular o Setor ao Usuário no Keycloak

1. Volte ao Keycloak e vá até o menu **Users**.
2. Localize e clique no nome do usuário desejado.
3. Vá até a guia **Groups**.
4. Localize o setor recém-criado.
5. Selecione o setor e clique em **Join** para adicionar o usuário ao grupo.

<div id="bkmrk--3">---

</div>### ✅ 4. Finalizar com Impersonação

1. Ainda na tela do usuário no Keycloak, vá até a guia **Impersonate**.
2. Clique no botão do aplicativo **e-Ciga 2.0**.
3. Isso forçará a atualização do cache de permissões e garantirá que o novo setor seja persistido corretamente no MongoDB.

<div id="bkmrk--4">---

</div>### 📌 Observações Finais

- O nome do setor deve ser **idêntico** no Keycloak e Mongo Express.
- O procedimento deve ser feito por administradores com permissão de acesso ao SSO e ao banco Mongo.
- Após o processo, o usuário terá acesso aos documentos e fluxos vinculados ao novo setor.