Autenticação da plataforma
O Flowker oferece dois modos de autenticação de plataforma, selecionados por configuração:
- API Key — uma chave estática enviada no header
X-API-Key, habilitada comAPI_KEY_ENABLED. - Access Manager — autenticação baseada em tokens, habilitada com
PLUGIN_AUTH_ENABLED. Quando ambos os modos estão habilitados, o Access Manager tem prioridade.
- Modo API Key — o middleware valida a chave em cada requisição; uma chave válida concede acesso a todos os endpoints. Configure a chave via variáveis de ambiente ou configuração de bootstrap.
- Modo Access Manager — cada requisição carrega um Bearer token e cada rota aplica uma permissão por recurso e por ação. É assim que a autorização baseada em roles e em políticas é aplicada.
- Credenciais inválidas ou ausentes retornam
401 Unauthorized.
Além da API Key estática, o Flowker pode delegar a autenticação e a autorização por recurso e por ação ao Access Manager. Habilite-o via configuração; quando habilitado, as requisições carregam um Bearer token e cada rota aplica sua própria permissão de recurso/ação.
Autenticação de executors
Quando o Flowker chama serviços externos por meio de executors, cada configuração de executor especifica seu próprio método de autenticação. Isso significa que suas credenciais de plataforma e suas credenciais de provedor são gerenciadas separadamente. Tipos de autenticação suportados:
As credenciais de autenticação são armazenadas na configuração do executor e utilizadas automaticamente quando o executor é chamado durante a execução do workflow.
Para os fluxos OIDC (
oidc_client_credentials e oidc_user), o Flowker gerencia a aquisição e renovação de tokens automaticamente. Você só precisa fornecer a URL do emissor, o client ID e o client secret na configuração do executor.Segurança de rede
Aplicação de HTTPS:
- Todos os endpoints da API exigem HTTPS em produção
- Chamadas de executors a provedores externos utilizam HTTPS
- Dados sensíveis (credenciais, payloads de requisição/resposta) são sempre transmitidos por canais criptografados
- As origens permitidas são configuráveis por implantação
- Credenciais não são permitidas em requisições cross-origin (
AllowCredentialsestá desabilitado) - Respostas de preflight são cacheadas para performance
Resiliência
O Flowker protege contra falhas em cascata de serviços externos usando padrões de circuit breaker e retentativas. Circuit breaker: Quando o serviço externo de um executor falha repetidamente, o circuit breaker abre e para de enviar requisições — evitando que seus workflows fiquem travados em um provedor que não responde.
- Transita pelos estados
closed→open→half-open - Os limiares são configurados globalmente (falhas consecutivas antes de abrir)
- O estado half-open permite um número limitado de requisições de teste antes de fechar completamente
- Contagem fixa de 5 tentativas com backoff exponencial (1s, 2s, 4s, 8s)
- Backoff exponencial entre tentativas
- Apenas falhas transitórias acionam retentativas (erros de rede, respostas 5xx)
Trilha de auditoria
Cada ação no Flowker é registrada no log de auditoria — alterações em workflows, eventos de execução, chamadas a executors e atualizações de configuração. Isso fornece uma cadeia completa de evidências para conformidade e visibilidade operacional.
- Os eventos de auditoria são consultáveis via o endpoint
/v1/audit-eventscom filtros por tipo de evento, ação, resultado, recurso e intervalo de datas - Cada entrada inclui um hash criptográfico que a vincula à entrada anterior, formando uma cadeia à prova de adulterações
- A integridade da cadeia de hash é verificável via o endpoint
/v1/audit-events/{id}/verify - Os logs incluem timestamps, identificação do ator (com endereço IP), tipo de ação e recursos afetados
Próximos passos
Guia de integração
Aprenda como configurar executors e conectar serviços externos.
Observabilidade
Monitore o Flowker com traces, métricas e logs estruturados.