Integrações

Integrações conectam a Aptabit Platform aos sistemas da organização e de parceiros. Cada conexão é cadastrada uma vez, com seus recursos e credenciais, e reutilizada pelos fluxos.

Conexões

Em Integrações, cadastre uma conexão por sistema. Tipos disponíveis:

Cada conexão lista recursos nomeados (rotas, com método e payload de exemplo) e oferece um teste de conexão. Para bancos de dados, o teste valida login e consulta no PostgreSQL e conexão TCP nos demais; para filas, o Redis responde a PING e os demais recebem teste TCP; para SFTP, o teste lê a identificação do servidor SSH.

Os fluxos executam apenas conexões HTTP: REST API, GraphQL e Webhook (uma chamada feita pelo fluxo, não um envio automático de eventos da plataforma). Conexões de banco de dados, filas, transferência de arquivos, gRPC e WebSocket ficam cadastradas e verificadas, mas não são executadas pelos fluxos. Para dados de bancos e planilhas, use os contextos de dados do Armazenamento.

Autenticação

Alguns templates têm assinatura própria do fornecedor, como a assinatura HMAC-SHA256 do TikTok Shop, as sessões do Veeam e o OAuth do HPE OpsRamp.

As credenciais ficam cifradas no banco (XChaCha20-Poly1305), são decifradas apenas no momento da chamada e nunca chegam ao navegador.

Templates de integração

O catálogo traz mais de 99 conectores prontos. Exemplos por categoria:

Um template preenche a URL base, a autenticação e os recursos mais usados. Você informa as credenciais e ajusta o que precisar. Sistemas fora do catálogo são cadastrados como conexão personalizada.

Uso nos fluxos

1. Cadastre a conexão e execute o teste.
2. No fluxo, adicione um bloco Integração e escolha a conexão e o recurso.
3. Mapeie os campos do passo anterior para o corpo da requisição.
4. Use a resposta nos blocos seguintes, por exemplo em um bloco de Decisão ou de Gravar dados.

Sistemas e dispositivos conectados por API participam dos fluxos da mesma forma.

Proteção de saída

Toda URL que um usuário pode influenciar (conexões, URLs de provedores e servidores de inferência) passa por uma proteção contra SSRF:

• Endereços privados, de loopback, link-local, CGNAT e de metadados de nuvem são bloqueados por padrão.
• As chamadas de integração não seguem redirecionamentos.
• Hosts internos que a instalação precisa alcançar, como um sistema da rede corporativa, são liberados explicitamente na variável APTABIT_SSRF_ALLOWED_HOSTS da API, separados por vírgula.

Recursos planejados