Troubleshooting
Erros reais e cross-cutting. Para erro específico de um conector, veja a seção Erros comuns na página do conector correspondente.
Cadastro
| Erro | Causa | Solução |
|---|---|---|
| "Emails temporários ou descartáveis não são permitidos" | Provedor de email descartável detectado | Use um email corporativo |
| "Senha deve ter no mínimo 8 caracteres" / "letra maiúscula" / "caractere especial" | Senha não atende aos requisitos mínimos | Use ao menos 8 caracteres, 1 maiúscula, 1 minúscula, 1 caractere especial |
| "Email já cadastrado" | Já existe conta com esse email | Faça login, ou use Esqueci minha senha na tela de login |
Senha
Esqueci minha senha: na tela de login, clique em Esqueci minha senha e informe o e-mail. Se houver conta, chega um link válido por 1 hora, que serve uma vez; um novo pedido só envia outro e-mail depois de 2 minutos. A nova senha segue as mesmas regras do cadastro. Ao redefinir, as sessões abertas em outros navegadores são encerradas.
| Situação | Causa | Solução |
|---|---|---|
| O e-mail de redefinição não chegou | Conta inexistente, bloqueada ou ainda sem senha (convite não aceito), ou pedido repetido em menos de 2 minutos | Confira o e-mail digitado e a caixa de spam; aguarde 2 minutos para pedir de novo |
| "Link inválido ou expirado" | Link com mais de 1 hora, ou já usado | Peça um novo link |
Rate limiting
Endpoints de autenticação (login, register, refresh, confirm-email, forgot-password, reset-password) aceitam no máximo 10 requisições a cada 15 minutos por IP. Se você automatizar login/registro (testes, scripts), respeite esse limite — passar dele retorna erro até a janela resetar.
Conexão de conta AWS
- "Esta conta AWS já está vinculada a outro usuário" (
ACCOUNT_ALREADY_LINKED) — uma conta AWS só pode estar em um usuário CloudBroker por vez, em qualquer plano. Reconecte pelo usuário original. - Credencial inválida — confira se as duas policies (
AWSBillingReadOnlyAccess,ResourceGroupsandTagEditorReadOnlyAccess) foram anexadas ao usuário IAM antes de gerar a access key. - Custo absurdamente alto num serviço específico — já houve um caso real de metering incorreto do lado da própria AWS (
DynamoDB TimedStorage-ByteHrs). Se um número parecer impossível pra seu volume real de uso, vale abrir chamado de suporte com a AWS antes de assumir erro do CloudBroker.
AWS aparece com "Erro" / "reconecte", ou os dados de custo pararam de atualizar
No Marketplace de Conectores, em Status dos conectores, o card da AWS aparece como Erro com a mensagem:
A AWS recusou a credencial conectada (chave desativada, apagada ou sem permissão de leitura de custo). Reconecte a conta AWS para voltar a atualizar os dados.
Causa: a própria AWS está recusando a access key salva. Os casos mais comuns são chave desativada ou apagada no IAM, credencial expirada, ou policy de leitura de custo retirada do usuário. Enquanto isso durar, a ingestão diária não traz dado novo, e as telas continuam mostrando o último dado que entrou.
Como resolver:
- No IAM da sua conta AWS, confira se o usuário usado pelo CloudBroker ainda tem as duas policies:
AWSBillingReadOnlyAccesseResourceGroupsandTagEditorReadOnlyAccess. - Gere uma nova access key para esse usuário. O passo a passo está em AWS → Guia de setup.
- Reconecte a conta AWS no CloudBroker com a nova chave. A reconexão limpa o erro. O mesmo usuário CloudBroker pode reconectar a mesma conta AWS.
- Depois, desative a chave antiga no IAM, se ela ainda existir.
O que não marca erro: falhas passageiras da AWS, como limite de requisições, problema de rede ou erro interno da AWS, não mudam o status na ingestão diária nem no Atualizar dados. A próxima execução resolve sozinha. Só uma credencial recusada pela AWS gera a mensagem de "reconecte".
A sincronização feita no primeiro login do dia é exceção: qualquer falha nela marca o conector como Erro com a mensagem genérica "Falha na última sincronização". Se for passageira, a próxima sincronização bem-sucedida volta o status para Saudável.
"A credencial AWS salva não pôde ser lida"
A API responde 409 com o código AWS_CREDS_UNREADABLE. A conta continua conectada, mas a credencial guardada não pôde ser decifrada. O caminho é o mesmo: reconecte a conta AWS com uma access key válida.
Conexão de conta Azure
- Erro de permissão ao conectar — confirme que o role assignment de Cost Management Reader foi feito na subscription certa, não em outra.
- Client Secret expirado — secrets do Entra ID têm validade definida na criação (até 24 meses); gere um novo e reconecte.
Não encontrou seu problema aqui?
Escreva para suporte@cloudbroker.app.br.