# Como consumir pipelines com Internal API usando ZTNA

Na Digibee Integration Platform, [**ZTNA (Zero Trust Network Access)**](https://app.gitbook.com/s/cO0A6g1dOsu8BiHYqO67/connectivity-management/ztna) é 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**](https://app.gitbook.com/s/SKBJ6ZiEWBU93x170HH4/triggers/web-protocols/http), [**HTTP File**](https://app.gitbook.com/s/SKBJ6ZiEWBU93x170HH4/triggers/web-protocols/http-file) e [**REST**](https://app.gitbook.com/s/SKBJ6ZiEWBU93x170HH4/triggers/web-protocols/rest).

## **Habilitando a Internal API**

Para habilitar a funcionalidade de Internal API no seu realm:

1. Contate o [Suporte da Digibee](https://docs.digibee.com/documentation/troubleshooting/pt-br/help-and-faq/support).
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**](https://app.gitbook.com/s/SKBJ6ZiEWBU93x170HH4/triggers/web-protocols/http), [**HTTP File**](https://app.gitbook.com/s/SKBJ6ZiEWBU93x170HH4/triggers/web-protocols/http-file) e [**REST**](https://app.gitbook.com/s/SKBJ6ZiEWBU93x170HH4/triggers/web-protocols/rest).
2. Habilite **Internal API** e **API Key** no formulário de configuração do trigger.
3. Atribua o pipeline a uma [API Key](https://app.gitbook.com/s/cO0A6g1dOsu8BiHYqO67/platform-administration/settings/api-keys-consumers).
4. [Implante o pipeline](https://app.gitbook.com/s/cO0A6g1dOsu8BiHYqO67/development-cycle/overview/deployment/deployments) 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](https://app.gitbook.com/s/cO0A6g1dOsu8BiHYqO67/connectivity-management/ztna).