> 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/troubleshooting/pt-br/connectivity-guides/consume-internal-api-pipelines-ztna.md).

# Como consumir pipelines com Internal API usando ZTNA

Saiba como consumir e publicar pipelines configurados como Internal API em realms que usam ZTNA.

Na Digibee Integration Platform, [**ZTNA (Zero Trust Network Access)**](/documentation/developer-guide/pt-br/connectivity-management/ztna.md) é uma camada adicional de segurança que pode ser aplicada a pipelines, garantindo que os serviços sejam acessados de forma privada e segura.

Em realms que usam ZTNA, o processo para consumir APIs internas é semelhante ao de realms que usam VPN. Os triggers que oferecem suporte a essa funcionalidade incluem: [**HTTP**](/documentation/connectors-and-triggers/pt-br/triggers/web-protocols/http.md), [**HTTP File**](/documentation/connectors-and-triggers/pt-br/triggers/web-protocols/http-file.md) e [**REST**](/documentation/connectors-and-triggers/pt-br/triggers/web-protocols/rest.md).

## **Habilitando a Internal API**

Para habilitar a funcionalidade de Internal API no seu realm:

1. Contate o [Suporte da Digibee](/documentation/troubleshooting/pt-br/help-and-faq/support.md).
2. Forneça os detalhes do **Edge Router** para registro.
   * O IP ou DNS do Edge Router que você configurou em sua infraestrutura.
   * A porta para enviar o tráfego.

Essas informações permitem que a Digibee crie a Inverse Flow (Fluxo inverso), conectando a sua rede à da Digibee, garantindo uma comunicação segura e privada. O Inverse Flow na Digibee Integration Platform permite que você execute chamadas da sua infraestrutura para pipelines internos dentro da Plataforma usando ZTNA.

## **Configurando o pipeline para usar Internal API**

Para configurar um pipeline usando uma Internal API:

1. Escolha um trigger compatível: [**HTTP**](/documentation/connectors-and-triggers/pt-br/triggers/web-protocols/http.md), [**HTTP File**](/documentation/connectors-and-triggers/pt-br/triggers/web-protocols/http-file.md) e [**REST**](/documentation/connectors-and-triggers/pt-br/triggers/web-protocols/rest.md).
2. Habilite **Internal API** e **API Key** no formulário de configuração do trigger.
3. Atribua o pipeline a uma [API Key](/documentation/developer-guide/pt-br/platform-administration/settings/api-keys-consumers.md).
4. [Implante o pipeline](/documentation/developer-guide/pt-br/development-cycle/overview/deployment/deployments.md) na página **Run**.
5. Abra o card do pipeline implantado e localize o link de acesso no seguinte formato:

   `https://{substitua-com-host-interno-da-Digibee}/pipeline/realm/v1/{{nome-do-pipeline}}`

## **Consumindo pipelines através de ZTNA**

Para consumir um pipeline usando ZTNA:

1. Use o **endereço IP do Edge Router** e a porta de mapeamento ZTNA específica para cada ambiente:

* **Ambiente de produção:** Use a porta **7070**: `http://{{IP-EDGE}}:7070/pipeline/realm/v1/{{nome-do-pipeline}}`
* **Ambiente de teste:** Use a porta **9090**: `http://{{IP-EDGE}}:9090/pipeline/realm/v1/{{nome-do-pipeline}}`

{% hint style="warning" %}
Use HTTP ao invés de HTTPS quando realizar a chamada ao pipeline. ​
{% endhint %}

Para mais informações, consulte a documentação sobre a [implementação de ZTNA na Digibee Integration Platform](/documentation/developer-guide/pt-br/connectivity-management/ztna.md).


---

# 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/troubleshooting/pt-br/connectivity-guides/consume-internal-api-pipelines-ztna.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.