Erros comuns
Convite expirado
Sintoma: o link do convite não abre mais o cadastro. Como resolver: peça ao responsável da organização para gerar um novo convite.
Não recebi o e-mail de redefinição de senha
Sintoma: você pediu o reset, mas nada chegou na caixa de entrada. Como resolver:
- verifique a pasta de spam;
- confirme se o endereço informado está certo;
- se a sua empresa filtra e-mails externos, peça à TI para liberar o domínio do RuleForge;
- se sua organização usa SSO corporativo, a senha é gerenciada pelo seu provedor — não pelo RuleForge.
A publicação da versão está bloqueada
Sintoma: você clica em Publicar e recebe um aviso de bloqueio. Como resolver: a tela indica qual critério falhou. Os mais comuns:
- erros de validação;
- regressão com falhas;
- score de qualidade abaixo do mínimo;
- revisão ainda não aprovada.
Consulte Versões e critérios de qualidade para ver cada critério.
O teste da integração Git falha
Sintoma: o botão Testar conexão retorna erro. Como resolver:
- revise a credencial no provedor (GitHub, GitLab ou Gitea);
- confirme que ela tem permissão para acessar o repositório desejado;
- no caso do GitHub, verifique se o GitHub App foi instalado na organização do repositório.
O teste do webhook falha
Sintoma: o sistema de destino rejeita a notificação. Como resolver: confirme se o segredo configurado no webhook é o mesmo que o sistema de destino está esperando. Se configurou recentemente, salve e teste de novo.
Não consigo cadastrar uma URL de webhook
Sintoma: aparece mensagem de URL inválida ao salvar.
Como resolver: o RuleForge aceita apenas URLs públicas (http ou https). Endereços locais (como localhost) ou de redes privadas são bloqueados por segurança.
Não consigo ver uma página
Sintoma: o menu que deveria aparecer está ausente, ou a ação falha. Como resolver: verifique, nesta ordem:
- se você está na organização certa (topo da tela);
- se tem o papel necessário — algumas áreas só aparecem para administradores;
- se o plano da organização inclui aquele recurso;
- se o projeto ativo é o que você espera.
Criei uma chave de API mas o valor desapareceu
Sintoma: depois de salvar, o segredo da chave não é mais exibido. Como resolver: é esperado — o valor é mostrado uma única vez, por segurança. Se precisar, gere uma rotação para ter um novo valor.
O login por SSO SAML não funciona como esperado
Sintoma: a configuração SAML parece incompleta. Como resolver: SAML está disponível apenas em preview. Para uso em produção, use SSO com OIDC.
Meu e-mail corporativo não é reconhecido no SSO
Sintoma: a tela de login não redireciona ao provedor da empresa. Como resolver: confirme com o administrador da organização se o domínio do seu e-mail foi adicionado ao provedor SSO e se o provedor está ativo.