> 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/network-mapping-routes.md).

# Network Mapping (Routes)

Saiba como visualizar, criar, editar, excluir e fazer upload em lote de rotas ZTNA na Digibee Integration Platform.

Um **Network Mapping** (rota) conecta um host e uma porta da sua rede a um pipeline Digibee, através de um Edge Router. Cada rota está vinculada a um **ambiente** (Test, Prod, ou Prod & Test).

## **Adicionando rotas**

### **Manualmente**

{% hint style="info" %}
Somente usuários com a função [connectivity-manager](/documentation/developer-guide/pt-br/platform-administration/administration/new-access-control/access-control-roles.md#connectivity-viewer) podem adicionar rotas.
{% endhint %}

1. Clique no logo da Digibee no canto superior esquerdo, depois em **Conectividade**, e acesse a aba **Network Mapping**.
2. Clique em **Adicionar Network Mapping** e selecione **Usando formulário**.
3. Preencha os campos:
   * **Portas**: uma porta única ou um intervalo (`xxxx-xxxx`).
   * **Host:** o DNS ou endereço IP do recurso que você está mapeando.
   * **Host alias** (obrigatório se Host for um IP em vez de um DNS — ative o toggle para exibir o campo).
   * **Ambiente**: Prod, Test, ou Prod & Test.
   * **Grupo de Edge Routers**: o grupo a ser associado a este Network Mapping.
4. Clique em **Salvar** para criar a rota, ou em **Cancelar** para voltar.

### **Em lote**

1. Clique em **Adicionar Network Mapping** e depois em **Em lote (CSV)**.
2. Baixe o arquivo de modelo (template) do CSV.
3. Depois de preparar seu arquivo, clique em **Upload CSV** e selecione seu arquivo CSV.
4. Revise a tabela de pré-visualização antes de confirmar.
5. Se o CSV tiver campos inválidos ou formatação incorreta, um erro é exibido — corrija e reenvie.
6. Clique em **Salvar**.

{% hint style="info" %}
Depois do upload, reimplante os pipelines que vão usar as novas rotas. Pipelines em modo de teste são reimplantados automaticamente, o que pode causar instabilidade temporária.
{% endhint %}

### **Fluxo Inverso**

Uma rota de Fluxo Inverso permite chamar pipelines internos da Digibee a partir da sua própria infraestrutura usando ZTNA, invertendo o sentido usual de um Network Mapping.

1. Clique em **Adicionar Network Mapping** e selecione **Fluxo Inverso Form**.
2. Preencha os campos:
   * **Protocolo**: HTTP, HTTPS, ou HL7.
   * **Porta**
   * **Host**
   * **Ambiente**: Test ou Prod.
3. Clique em **Salvar**. Depois de criar a rota, a Plataforma cria e configura automaticamente o Edge Router correspondente do lado da Digibee, associado a um grupo dedicado **Inverso**, que não pode ser editado.

## **Filtrando e pesquisando rotas**

Depois de criadas, você pode visualizar todas as rotas em uma tabela. Para encontrar uma rota rapidamente, use a barra de busca e procure por host, destino ou nome.

Você também pode filtrar por:

* Ambiente
* Grupo de Edge Routers
* Tipo de mapeamento de rede (Padrão ou Fluxo inverso)

## **Editando rotas**

1. Para editar uma rota, clique no ícone de **lápis** na coluna **Ações**.
2. Um painel lateral abre com as informações atuais da rota (Porta, Host, Ambiente, Grupo — mais Host alias, se aplicável).
3. Faça as alterações necessárias.
4. Clique em **Salvar** ou em **Cancelar** para descartar as alterações.

## **Excluindo rotas**

{% hint style="info" %}
Somente usuários com a função [connectivity-manager](/documentation/developer-guide/pt-br/platform-administration/administration/new-access-control/access-control-roles.md#connectivity-manager) podem excluir rotas.
{% endhint %}

1. Para excluir uma rota, clique no ícone de **lixeira** na coluna **Ações**.
2. Confirme a ação no pop-up que será aberto.


---

# 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/network-mapping-routes.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.