> For the complete documentation index, see [llms.txt](https://docs.digibee.com/documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.digibee.com/documentation/developer-guide/pt-br/connectivity-management/ztna/edge-routers.md).

# Edge Routers

Saiba como criar, gerenciar e monitorar seus Edge Routers na Digibee Integration Platform.

Um **Edge Router** é um ponto de conexão entre a sua rede e a Digibee Integration Platform. Cada Edge Router pertence a um **grupo**, que você usa para organizar e segregar a comunicação dos Edge Routers. Por exemplo, um grupo chamado `prod-onpremise` pode conter apenas Edge Routers no ambiente de Prod hospedados em uma infraestrutura on-premise.

Um grupo pode ter uma quantidade ilimitada de Edge Routers, e cada rota se associa aos Edge Routers pelo grupo ao qual pertence.

{% hint style="info" %}
Somente usuários com a função connectivity-manager podem criar e gerenciar conexões ZTNA. Confira todos os [papéis e permissões](/documentation/developer-guide/pt-br/platform-administration/administration/new-access-control/access-control-roles.md#id-7auxts1l679f) de ZTNA.
{% endhint %}

## **Criando um Edge Router**

1. Clique no logo da Digibee no canto superior esquerdo e depois clique em **Conectividade**.
2. A página abre na aba **Edge Router**.
3. Clique em **Add Edge Router**. Um novo modal é aberto.
4. Preencha os campos:
   * **Nome**: um nome para a sua nova conexão.
   * **Grupo**: crie um novo nome de grupo, ou selecione um grupo existente para associar a este Edge Router.
5. Clique em **Criar** para continuar, ou em **Cancelar** para voltar.
6. Uma nova janela abre com uma chave para o seu Edge Router. Copie-a e registre-a no seu Edge Router. Você tem 48 horas antes que a chave expire.

{% hint style="info" %}
Se você criou suas Rotas e Edge Routers antes de os grupos existirem, suas conexões existentes foram migradas automaticamente: Edge Routers antes vinculados ao ambiente de Prod agora fazem parte do grupo `prod`, e assim por diante. Você pode manter os grupos padrão ou criar novos e reorganizar seus Edge Routers e Rotas.
{% endhint %}

### **Nomeando grupos**

Use letras minúsculas e evite espaços. Use hífens ou underscores para separar palavras, por exemplo, `prod-gcp` ou `test-devs`.

Um grupo só existe enquanto estiver associado a pelo menos um Edge Router. Se você remover o último Edge Router de um grupo, o grupo é excluído automaticamente.

### **Grupo de Fluxo Inverso**

Ao criar uma Rota Inversa, um Edge Router é criado automaticamente do lado da Digibee e associado a um grupo chamado **Inverso**, que não pode ser modificado.

## **Alterando o grupo de um Edge Router**

1. Clique no ícone de **Editar** do Edge Router selecionado.
2. Digite um novo nome de grupo, ou selecione um grupo existente.
3. Clique em **Salvar**.

{% hint style="warning" %}
Alterar o grupo de um Edge Router não muda o ambiente das rotas associadas a ele. Ambiente é uma propriedade da **rota** (Network Mapping), não do Edge Router — consulte [Network Mapping](/documentation/developer-guide/pt-br/connectivity-management/ztna/network-mapping-routes.md).
{% endhint %}

## **Gerando e registrando chaves**

Cada chave é válida por 48 horas. Depois disso, gere uma nova. Você também pode regenerar uma chave antes que ela expire.

1. Na aba **Edge Router**, confira a coluna **Registrado**:
   * **Sim** — a chave está registrada e funcionando.
   * **Pendente** — chave gerada, ainda não registrada (48h para fazê-lo).
   * **Expirada** — a chave expirou; gere uma nova.
2. Clique no ícone de **chave** ao lado do Edge Router.
3. Clique em **Registrar nova chave** para gerar uma nova chave, ou em **Fechar** para cancelar.
4. Copie a chave de registro e feche a janela.
5. Em um terminal no Edge Router, execute:

```
sudo router-registration <registration_key> --force
```

## **Visualizando Network Mappings associados**

1. Na aba **Edge Router**, clique em **Visualizar** (ícone de olho) ao lado do Edge Router.
2. O painel lateral exibe todos os Network Mappings associados a esse Edge Router, com base no grupo do Edge Router e no ambiente de cada rota.

## **Excluindo um Edge Router**

{% hint style="warning" %}
Os Edge Routers estão vinculados a Network Mappings (rotas) específicos. Excluir um Edge Router quebra qualquer Network Mapping que dependa exclusivamente dele.
{% endhint %}

1. Na aba **Edge Router**, clique no ícone de **Excluir** ao lado do Edge Router.
2. Uma janela pop-up abre para confirmar a ação. Clique em **Excluir** para prosseguir, ou em **Cancelar** para retornar à tela anterior.

Se você tentar excluir um Edge Router que é o único vínculo de um Network Mapping, a plataforma avisa que a ação cria um Network Mapping órfão, o que pode prejudicar suas conexões.

Se você tiver certeza da exclusão, clique em **Excluir** novamente para prosseguir. Essa etapa de confirmação ajuda a evitar interrupções de rede não intencionais.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.digibee.com/documentation/developer-guide/pt-br/connectivity-management/ztna/edge-routers.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.