Por George Curta ·
Solução de Problemas & FAQ
Corrija problemas do anonym.legal no Nextcloud: rejeição da lista de host SSRF, aviso de nova versão e erros do plano Basic dos dois aplicativos hoje.
URL da API do backend rejeitada (lista de permissões SSRF)
O aplicativo se recusa a salvar uma URL da API do backend, ou as solicitações falham com um erro de URL não permitida.
Por que isso acontece
Ambos os aplicativos validam a URL da API do backend configurada em relação a uma lista de permissões de host validada em tempo de execução (UrlGuard) antes de fazer qualquer solicitação. Essa proteção contra SSRF existe para que uma URL maliciosa ou mal configurada nunca possa fazer o token Bearer do aplicativo alcançar um host controlado por um invasor. Somente anonym.legal e anonymize.business (o host de DEV) são permitidos — todos os outros hosts são rejeitados, por design.
Como corrigir
- 1.Use exatamente https://anonym.legal (produção) ou https://anonymize.business (DEV) como a URL da API do backend.
- 2.Remova qualquer caminho, porta ou erro de digitação no final da URL — a lista de permissões corresponde exatamente ao nome do host.
- 3.Se você acredita que um host legítimo está sendo rejeitado, entre em contato com o suporte — a lista de permissões é intencionalmente não editável pelo usuário.
Aviso "Uma nova versão está disponível"
As configurações de administrador do aplicativo mostram um aviso de que existe uma versão mais recente.
Por que isso acontece
Ambos os aplicativos verificam periodicamente se há uma versão mais recente e exibem um aviso simples ao administrador com um link para o changelog quando uma nova versão está disponível. Este é um aviso de atualização manual, não uma atualização automática — nada se instala sozinho na sua instância do Nextcloud.
Como corrigir
- 1.Siga o link do changelog no aviso para revisar o que mudou.
- 2.Baixe o(s) novo(s) arquivo(s) do aplicativo na página de releases do GitHub.
- 3.Extraia para apps/ e execute occ upgrade — os mesmos passos manuais de instalação inicial — no seu próprio cronograma.
Erro 403: "Plano Basic ou superior"
As chamadas de API do aplicativo falham com um status 403 e uma mensagem sobre a exigência do plano Basic ou superior.
Por que isso acontece
Ambos os aplicativos do Nextcloud requerem uma conta anonym.legal no plano Basic ou superior. O plano gratuito não inclui o acesso à API do qual esses aplicativos dependem, portanto o backend retorna 403 com a mensagem "Nextcloud integration requires Basic plan or higher. Please upgrade your plan." em vez de uma falha silenciosa.
Como corrigir
- 1.Confirme a qual conta anonym.legal pertence o token configurado.
- 2.Atualize essa conta para o plano Basic ou superior.
- 3.Tente a solicitação novamente — nenhuma reinstalação ou reconfiguração é necessária depois que a conta for atualizada.
O token de integração não consegue ler chaves de criptografia — isso é um bug?
Uma solicitação que tenta buscar material de chave descriptografado com o token configurado é rejeitada.
Por que isso acontece
Não — isso é intencional. O token usado por esses aplicativos é um token com escopo de integração, deliberadamente mais limitado do que um token de API de conta completa: ele pode analisar e anonimizar conteúdo, mas todo endpoint que retornaria material de chave descriptografado responde 403 a um token com escopo de integração, para que um servidor Nextcloud comprometido nunca possa ser usado para descriptografar seu histórico de criptografia reversível.
O que fazer
- 1.Este é o comportamento esperado, não um erro a ser corrigido — os aplicativos nunca precisam de material de chave descriptografado para seu fluxo de trabalho de analisar/anonimizar/desanonimizar.
- 2.Se um fluxo de trabalho realmente precisar de acesso à conta completa, use um token de API com escopo completo fora desses aplicativos, em um contexto que você controle.
Ainda precisa de ajuda?
Se nenhuma das soluções acima funcionar, entre em contato conosco e ajudaremos você a resolver o problema.