Configurar e-mail do Amazon SES

1. Verifique um remetente na sua região AWS

Abra Amazon SES em US East (N. Virginia), us-east-1. Escolha Configuration → Identities → Create identity, selecione seu domínio ou e-mail e conclua a verificação DNS ou por e-mail. Use a mesma região e o remetente verificado nos ajustes abaixo.

Contas novas do SES começam em sandbox: verifique também o destinatário ou use o simulador de caixas do SES. Solicite acesso à produção em Account dashboard antes de enviar a clientes comuns. Abrir Amazon SES

2. Para SMTP, escolha IAM SMTP credentials

No SES, abra SMTP settings → Create SMTP credentials. Escolha IAM SMTP credentials em vez de Mail Manager com o selo Recommended. O cartão IAM mostra Manual credential management. No traffic policies or rule sets. Clique em Create IAM credentials, nomeie o usuário de envio e baixe as credenciais SMTP antes de fechar.

Criar credenciais IAM · Gerenciar existentes

Estes links usam us-east-1, onde IAM SMTP clássico está disponível. Para outra região compatível, crie credenciais para ela e use seu endpoint SMTP. A senha SMTP baixada não é a chave de acesso secreta AWS; use-a apenas na etapa 5. Instruções SMTP da AWS

3. Evite cobranças desnecessárias do Mail Manager

IAM SMTP e o SDK SES enviam diretamente pelo SES, sem políticas de tráfego ou conjuntos de regras do Mail Manager. Evite criar um endpoint de entrada aberto ou mTLS opcional: a AWS informa US$ 50 por mês por endpoint no preço à la carte. Endpoints autenticados são gratuitos atualmente; Recommended nem sempre acrescenta US$ 50. As tarifas de envio e do plano escolhido continuam valendo. Consultar preços AWS

4. Envie pelo SDK AWS

Este modo usa a API SES por HTTPS. No IAM, conceda à função do servidor ou a um usuário exclusivo de envio ses:SendEmail sobre a identidade SES verificada. Para um usuário, abra Security credentials → Create access key e salve ID e chave secreta originais. Uma senha SMTP não assina solicitações do SDK.

Coloque o exemplo em apps/web-tanstack/.env.local no desenvolvimento ou nos segredos da hospedagem em produção. Substitua remetente e valores de exemplo. Com uma função IAM ou perfil AWS local configurado, deixe as duas chaves e AWS_SESSION_TOKEN vazios: o SDK usa sua cadeia padrão. Forneça sempre o par completo de chaves explícitas.

Com credenciais temporárias explícitas, inclua o AWS_SESSION_TOKEN correspondente e renove os três valores quando expirarem. O SDK renova credenciais de funções. Cadeia de credenciais do SDK AWS

EMAIL_PROVIDER=ses
EMAIL_FROM=Your App <[email protected]>
AWS_REGION=us-east-1
AWS_ACCESS_KEY_ID=<IAM-access-key-id>
AWS_SECRET_ACCESS_KEY=<original-IAM-secret-access-key>
# Temporary explicit credentials only:
AWS_SESSION_TOKEN=

5. Ou use IAM SMTP clássico

Use usuário e senha SMTP da etapa 2 nesta configuração alternativa. A porta 587 usa STARTTLS; SMTP_SECURE=false seleciona esse modo. Endpoint, credenciais e remetente verificado devem estar na mesma região.

Estes ajustes do kit do comprador são compartilhados pelas três plataformas. Escolha um modo: EMAIL_PROVIDER=smtp usa credenciais SMTP; EMAIL_PROVIDER=ses usa as credenciais da API do SDK.

EMAIL_PROVIDER=smtp
EMAIL_FROM=Your App <[email protected]>
SMTP_HOST=email-smtp.us-east-1.amazonaws.com
SMTP_PORT=587
SMTP_SECURE=false
SMTP_USER=<downloaded-SMTP-username>
SMTP_PASSWORD=<downloaded-SMTP-password>

6. Configure uma vez para web, celular e desktop

Reinicie o servidor após as alterações. Com o banco migrado, solicite um código de acesso por e-mail em /auth para um destinatário permitido e confira entrada e spam. O celular usa o mesmo servidor; o desktop carrega a aplicação web. Nenhum cliente precisa de chaves AWS ou senha SMTP.

Mantenha credenciais apenas no servidor, nunca em NEXT_PUBLIC_, EXPO_PUBLIC_ ou no pacote desktop. Em caso de falha, confira remetente, restrições de sandbox, região, permissões IAM e tipo de credenciais. queued significa que o SES aceitou a mensagem, não que ela chegou. Visão geral da configuração de e-mail