Per George Curta ·
Resolució de Problemes i Preguntes Freqüents
Soluciona problemes comuns d'anonym.legal a Nextcloud: el rebuig de la llista blanca SSRF, l'avís de nova versió i errors del pla Basic a les dues apps.
URL de l'API del backend rebutjada (llista blanca SSRF)
L'aplicació es nega a desar una URL de l'API del backend, o les sol·licituds fallen amb un error d'URL no permesa.
Per què passa això
Totes dues aplicacions validen la URL de l'API del backend configurada respecte a una llista blanca d'amfitrions validada en temps d'execució (UrlGuard) abans de fer cap sol·licitud. Aquesta protecció SSRF existeix perquè una URL maliciosa o mal configurada mai pugui fer que el token Bearer de l'aplicació arribi a un amfitrió controlat per un atacant. Només es permeten anonym.legal i anonymize.business (l'amfitrió DEV) — qualsevol altre amfitrió es rebutja, per disseny.
Com solucionar-ho
- 1.Utilitza exactament https://anonym.legal (producció) o https://anonymize.business (DEV) com a URL de l'API del backend.
- 2.Elimina qualsevol camí final, port o error tipogràfic de la URL — la llista blanca compara el nom d'amfitrió exactament.
- 3.Si creus que s'està rebutjant un amfitrió legítim, contacta amb el suport — la llista blanca no és editable per l'usuari, deliberadament.
Avís de "Hi ha una nova versió disponible"
La configuració d'administració de l'aplicació mostra un avís que indica que hi ha una versió més nova.
Per què passa això
Totes dues aplicacions comproven periòdicament si hi ha una versió més nova i mostren un avís senzill per a l'administrador amb un enllaç al registre de canvis quan n'hi ha una de disponible. Es tracta d'un avís d'actualització manual, no d'una actualització automàtica — res no s'instal·la sol a la teva instància de Nextcloud.
Com solucionar-ho
- 1.Segueix l'enllaç al registre de canvis de l'avís per revisar què ha canviat.
- 2.Descarrega el(s) nou(s) arxiu(s) de l'aplicació des de la pàgina de GitHub Releases.
- 3.Extreu a apps/ i executa occ upgrade — els mateixos passos d'instal·lació manual que la instal·lació inicial — quan tu decideixis.
Error 403: "Pla Basic o superior"
Les crides a l'API des de l'aplicació fallen amb un estat 403 i un missatge que indica que cal el pla Basic o superior.
Per què passa això
Totes dues aplicacions de Nextcloud requereixen un compte d'anonym.legal amb el pla Basic o superior. El pla gratuït no inclou l'accés a l'API del qual depenen aquestes aplicacions, així que el backend retorna 403 amb el missatge "La integració amb Nextcloud requereix el pla Basic o superior. Si us plau, actualitza el teu pla." en lloc d'una fallada silenciosa.
Com solucionar-ho
- 1.Confirma a quin compte d'anonym.legal pertany el token configurat.
- 2.Actualitza aquest compte al pla Basic o superior.
- 3.Torna a intentar la sol·licitud — no cal reinstal·lar ni reconfigurar res un cop el compte estigui actualitzat.
El token d'integració no pot llegir les claus de xifrat — és un error?
Una sol·licitud que intenta obtenir material de clau desxifrat amb el token configurat és rebutjada.
Per què passa això
No — és intencionat. El token que utilitzen aquestes aplicacions és un token d'àmbit d'integració, deliberadament més limitat que un token API de compte complet: pot analitzar i anonimitzar contingut, però qualsevol punt d'accés que retornaria material de clau desxifrat respon 403 a un token d'àmbit d'integració, de manera que un servidor de Nextcloud compromès mai es pot utilitzar per desxifrar el teu historial de xifrat reversible.
Què fer
- 1.Aquest és el comportament esperat, no un error a solucionar — les aplicacions mai necessiten material de clau desxifrat per al seu flux d'analitzar/anonimitzar/desanonimitzar.
- 2.Si un flux de treball realment necessita accés de compte complet, utilitza un token API d'àmbit complet fora d'aquestes aplicacions, en un context que controlis.
Encara necessites ajuda?
Si cap de les solucions anteriors funciona, contacta'ns i t'ajudarem a resoldre el problema.