Gateway de API Privado¶

Introdução¶

Um Gateway de API Privado, hospedado em uma rede privada, lida com esses recursos de segurança e tarefas envolvidas na aceitação e processamento API Manager API chama:

• Gestão de tráfego
• Autorização e controle de acesso
• Limitação de taxa
• Processamento de payload da API

Um Gateway de API Privado é um gateway local para processar APIs diretamente de seus próprios servidores. Recursos de segurança do API Manager são configurados no nível da API ou nível do perfil de segurança e são armazenados em cache no Gateway de API Privado, que são referenciados durante o tempo de execução da API conforme descrito abaixo.

Usar um Gateway de API Privado oferece essas vantagens adicionais em relação ao Gateway de API em Nuvem:

• Rede Interna: O Gateway de API Privado e seus agentes podem ser restritos apenas a uma rede interna protegida por um firewall e não podem ser acessados pela Internet.

  Nota

  Se a instalação do Gateway de API Privado estiver protegida por um firewall em sua rede, você deverá lista de permissões serviços Jitterbit necessários.

• Segurança de carga útil: Cargas úteis de resposta de API nunca passam pelos sistemas da Jitterbit.

• Controle: Você tem controle sobre o ambiente de hardware e software do Private API Gateway, garantindo que ele atenda aos padrões da sua empresa.
• Nome de domínio: O URL base do endpoint da API pode ser configurado para ser um subdomínio de um nome de domínio que você controla, em vez de um subdomínio da região Harmony (jitterbit.cc, jitterbit.eu, ou jitterbit.net). Uma alternativa ao uso de um Gateway de API Privado para controlar o nome de domínio é usar uma ferramenta de externo, como Cloudflare ou um proxy DNS, para rotear um nome de domínio personalizado para o URL base.

Para obter informações sobre como instalar e configurar um Gateway de API Privado, consulte Instalando um Gateway de API Privado.

Arquitetura de Sistema de Gateway de API Privado¶

Este diagrama exibe a arquitetura do sistema de uma API Customizada implantada localmente com um Agente Privado e um Gateway de API Privado:

1. Um consumidor de API faz uma chamada para a API localizada no Gateway de API Privado.

2. O Gateway de API Privado faz referência aos perfis de segurança armazenados em cache (se aplicável) e aos metadados da API para executar tarefas de autenticação e controle de acesso. Se o acesso à API for negado, o Gateway de API Privado retornará uma resposta HTTP e um status apropriados ao consumidor da API. Se o acesso à API for concedido, a solicitação da API será roteada para o serviço de mensagens, que roteia solicitações para Grupos de Agente.

3. O Agente Privado recebe a solicitação do serviço de mensagens.

4. O Agente Privado faz referência à operação da API especificada durante a configuração da API Customizada e aciona a operação implantada.

5. A operação responde com uma payload de API consistente com o tipo de resposta selecionado durante a configuração da API Customizada.

6. A payload da resposta da API é roteada do Agente Privado de volta para o Gateway de API Privado, que extrai a payload da API e define a resposta HTTP final e o status. A resposta e o status HTTP são enviados ao consumidor da API.

   Nota

   A menos que a operação que está sendo acionada pela chamada de API esteja usando armazenamento temporário, a payload da resposta da API permanecerá no agente por no máximo dois dias. A payload da resposta da API permanecerá no Gateway de API Privado por no máximo o tempo limite do Gateway de API de 15 segundos.

7. As informações de status do tempo de execução e os logs das operações em execução são enviados ao banco de dados de logs de transações.

   Nota

   Os dados do consumidor não são armazenados no banco de dados de logs de transações, a menos que modo de depurar é ativado durante configuração de API Customizada.