CRM Docs

ALB

Application Load Balancer — entrada HTTP/HTTPS da API

O Application Load Balancer (ALB) é o ponto de entrada HTTP/HTTPS para as APIs do CRM na AWS. Ele termina TLS (certificado ACM), distribui requisições entre targets saudáveis do Target Group e aplica regras por host, path ou header — sem expor IPs individuais das tasks ECS.

O que o ALB faz (e o que não faz)

FazNão faz
Balanceamento L7 (HTTP/HTTPS/WebSocket)Balanceamento TCP puro de longa duração (use NLB)
Terminação SSL com certificado ACMExecutar código da aplicação
Redirecionar HTTP → HTTPSSubstituir autenticação da API
Sticky sessions (opcional)Cache de resposta (use CloudFront)

Componentes

ComponenteDescrição
Load balancerRecurso com DNS name xxx.region.elb.amazonaws.com
ListenerPorta + protocolo (80, 443)
RulesPrioridade: condição → ação (forward, redirect, fixed response)
Target groupConjunto de IPs/instâncias/Lambda
Security groupTráfego permitido na ENI do ALB

Listeners típicos no CRM

PortaProtocoloAção comum
443HTTPSForward para TG da API com certificado ACM
80HTTPRedirect permanente para 443

Certificados TLS

OrigemUso
ACM (AWS Certificate Manager)Certificado gratuito renovado automaticamente no ALB
Certificado Kinghost / externoPode ser importado no ACM ou terminado em outro layer

Para domínios cujo registro está na Kinghost mas DNS está no Route 53, a validação ACM costuma ser por registro DNS no Route 53.

Regras de roteamento (exemplos)

PrioridadeCondiçãoAção
1Host: api.crm.exemplo.comForward → TG produção
2Path: /health*Forward → TG (ou fixed 200 em ambiente específico)
defaultFixed response 404

Headers e integração com a API

O ALB injeta headers úteis para a aplicação:

HeaderSignificado
X-Forwarded-ForIP original do cliente
X-Forwarded-Protohttps quando listener é HTTPS
X-Forwarded-PortPorta do listener

A API deve confiar nesses headers somente se vierem do ALB (não aceitar de clientes diretos na mesma porta).

Alta disponibilidade e limites

  • ALB é regional e multi-AZ por design.
  • Idle timeout padrão (60 s) afeta conexões longas; WebSockets precisam de configuração adequada.
  • Limites de regras por listener e tamanho de request body seguem quotas da conta AWS.

WAF (opcional)

AWS WAF pode ser associado ao ALB para bloquear IPs, rate limit, SQLi — camada extra antes do Target Group.

Relação com outros serviços

ServiçoRelação
Route 53Registro alias A apontando para o ALB
TGDestino do forward
ECSTasks registradas no TG
SGALB SG inbound 443 da internet; task SG inbound só do ALB
CFPode usar ALB como origem (menos comum que S3 para estáticos)

Se usuários recebem 502/503, distinga: 502 costuma ser target sem resposta válida; 503 frequentemente significa nenhum target healthy no grupo — verifique health check e security groups antes de debugar código da API.

On this page