# Como consumir pipelines com Internal API usando 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: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.digibee.com/documentation/troubleshooting/pt-br/connectivity-guides/consume-internal-api-pipelines-ztna.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.