Projeto 02 — Encurtador de URLs Serverless

Desafio: 50DaysOfCloud
Autor: Daniel Azevedo Maia

Este projeto faz parte do desafio #50DaysOfCloud e implementa um encurtador de URLs 100% serverless utilizando AWS Lambda, DynamoDB e Python. O objetivo é construir uma aplicação útil, escalável, sem custo fixo e totalmente dentro da camada gratuita da AWS.

🌐 Visão Geral

Criar um encurtador de links é um excelente exemplo de uso da arquitetura serverless, ideal para aplicações de baixo custo e alta escalabilidade.

Benefícios da arquitetura serverless

• Executa sob demanda (paga-se apenas pelo uso)
• Escala automaticamente
• Fica 100% dentro do Free Tier da AWS

---

🧱 Etapas do Projeto

Etapa 1 — Criação da Tabela no DynamoDB

• Nome da tabela: url-shortener
• Chave primária: shortId (tipo String)
• Capacidade: On-Demand
• Criptografia: padrão da AWS
• Proteção contra exclusão: não ativada

Outros campos como originalUrl e createdAt são adicionados dinamicamente na aplicação.

---

Etapa 2 — Função Lambda

• Nome: shortenUrlFn
• Linguagem: Python 3.12
• Arquitetura: x86_64

Entrada esperada:

{
  "url": "https://www.lojaexemplo.com/produto/oferta?id=8934757&utm_campaign=linkedin&utm_source=referral&utm_medium=social"
}

Saída esperada:

{
  "shortId": "23gpWj",
  "shortUrl": "/u/23gpWj"
}

---

Etapa 3 — Permissões IAM

• Role gerada automaticamente: shortenUrlFn-role-xxxx
• Política anexada: AmazonDynamoDBFullAccess (idealmente, poderia ser mais restritiva no futuro)

---

Etapa 4 — Testes

Foi realizado um teste manual pelo console do AWS Lambda com o seguinte payload:

{
  "body": "{"url": "https://www.lojaexemplo.com/produto/oferta?id=8934757&utm_campaign=linkedin&utm_source=referral&utm_medium=social"}"
}

A função gerou corretamente um identificador curto, salvou no DynamoDB e retornou os dados esperados.

---

📌 Exemplo Prático

Entrada (original):

https://www.lojaexemplo.com/produto/oferta?id=8934757&utm_campaign=linkedin&utm_source=referral&utm_medium=social

Saída (encurtada):

https://xxxxxx.execute-api.amazonaws.com/dev/u/rfeLta

Mesmo sem domínio próprio, a URL já é consideravelmente mais curta. Em produção, pode-se usar algo como https://dani.io/u/xyz123.

---

🔄 Parte 2 — API Gateway e Redirecionamento

No post anterior, mostrei como criei uma função Lambda que recebe uma URL em JSON, gera um hash curto e salva no DynamoDB.

Até então, usava o botão de Test no console do Lambda. Mas chegou a hora de expor um endpoint HTTP público real. Usei o API Gateway para isso.

🔧 Passo a passo

1️⃣ Criei uma API HTTP no API Gateway chamada url-shortener-api
2️⃣ Escolhi a função shortenUrlFn como integração
3️⃣ Configurei a rota: POST /shorten

{
  "shortId": "ML9FGd",
  "shortUrl": "/u/ML9FGd",
  "originalUrl": "https://www.lojaexemplo.com/produto/oferta?id=8934757&utm_campaign=linkedin&utm_source=referral&utm_medium=social"
}

OBS.: fiz o Deploy do estágio chamado prod com deploy automático.

🌐 Tornando acessível

Agora, podemos chamar esse endpoint com POST:

https://iycunk6cod.execute-api.us-east-1.amazonaws.com/prod/shorten

🔁 Redirecionamento

Criei uma segunda função Lambda chamada redirectUrlFn.

• Configurei a variável de ambiente: TABLE_NAME = url-shortener
• Essa função lê o shortId da URL, consulta o DynamoDB e redireciona via HTTP 301

No API Gateway:

• Criei a rota: GET /u/{shortId}
• Integrei com a função redirectUrlFn

---

✅ Resultado final

Se você acessar diretamente:

https://www.lojaexemplo.com/produto/oferta?id=8934757&utm_campaign=linkedin&utm_source=referral&utm_medium=social

A página abrirá normalmente.

Mas se acessar:

https://iycunk6cod.execute-api.us-east-1.amazonaws.com/prod/u/ML9FGd

Você será redirecionado para a mesma página original — agora com link mais curto, limpo, e sem precisar de nenhum servidor!

---

✔️ Checklist de Conclusão

✅ Função Lambda shortenUrlFn
✅ Tabela no DynamoDB (url-shortener)
✅ Permissão para shortenUrlFn gravar no DynamoDB
✅ API Gateway com rota POST /shorten integrada
✅ Deploy automático para o estágio prod
✅ Função redirectUrlFn para leitura e redirecionamento
✅ Rota GET /u/{shortId} conectada ao redirectUrlFn
✅ Redirecionamento HTTP 301 implementado
✅ Tratamento de erro 404 para shortId inexistente
✅ Testes com curl e navegador validados com sucesso

---

🔒 Considerações sobre Segurança

Gostei muito de montar esse encurtador de URLs apenas para praticar. Já deletei as Lambdas e os recursos, então sem problemas com questões de segurança. Mas, se fosse um ambiente real, penso ser necessário:

1. Validar as URLs antes de salvar no DynamoDB.
2. Dar à Lambda apenas a permissão mínima necessária.
3. Colocar API Key ou limitar requisições no API Gateway.
4. Tratar possíveis colisões de shortId.
5. Habilitar logs e métricas no CloudWatch para monitoramento.

---

🏷️ Tags

AWS Lambda DynamoDB Serverless Python Cloud API Gateway DevOps Free Tier InfraComoCódigo Portfólio

---

Desafio: #50DaysOfCloud por Daniel Azevedo de Oliveira Maia