> For the complete documentation index, see [llms.txt](https://ajuda.digitalsac.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.digitalsac.io/digicrm/configuracao/modulo-perfex-crm/solucao-de-problemas-e-seguranca.md).

# 🛟 Solução de problemas e segurança

Use este guia para diagnosticar os problemas mais comuns do módulo DigiCRM.

### Servidor offline

1. teste frontend e backend por HTTPS;
2. valide DNS e certificado;
3. confirme o token;
4. verifique proxy reverso e processo do backend;
5. revise firewall;
6. recarregue a tela.

| Sintoma  | Causa provável                  | Ação                                             |
| -------- | ------------------------------- | ------------------------------------------------ |
| HTTP 502 | backend/proxy indisponível      | reiniciar serviço e revisar proxy                |
| cURL 60  | SSL inválido/autoassinado       | instalar certificado público com cadeia completa |
| 401/403  | token inválido                  | gerar e atualizar token                          |
| timeout  | rede, firewall ou serviço lento | testar conectividade e logs                      |

### Plano não aparece

* confirme o servidor selecionado;
* remova o filtro de visibilidade;
* verifique se o plano está oculto;
* execute a sincronização;
* confira se houve erro no servidor.

### Cliente não foi criado

* confira campos obrigatórios;
* valide documento e e-mail;
* confirme plano e servidor;
* verifique limites de canais;
* consulte Logs de cadastro;
* evite reenviar antes de confirmar se o tenant já existe.

### Divergência financeira

Compare plano do cliente, preço, recorrência, vencimento e fatura Perfex. Não corrija em massa sem identificar qual sistema contém o valor correto.

### Cron não executa

* rode o comando manualmente;
* confira caminho do PHP e URL;
* revise permissões e logs do cron;
* verifique horário/fuso do servidor;
* confirme que a rotina está habilitada.

### Segurança

* use HTTPS válido em todos os servidores;
* gere tokens exclusivos por ambiente;
* rotacione imediatamente credenciais expostas;
* não coloque tokens, senhas, licenças ou dados pessoais em documentação;
* limite o acesso ao módulo a administradores;
* mantenha backups antes de exclusões;
* valide o destino antes de alterar servidor padrão;
* use dados fictícios em testes e capturas.