Di George Curta ·
Risoluzione dei Problemi e FAQ
Risolvi i problemi comuni di anonym.legal con Nextcloud: rifiuto della lista host SSRF, avviso di nuova versione e errori del piano Basic dalle due app.
URL API del backend rifiutato (lista consentita SSRF)
L'app rifiuta di salvare un URL API del backend, oppure le richieste falliscono con un errore di URL non consentito.
Perché succede
Entrambe le app validano l'URL API del backend configurato rispetto a una lista consentita di host validata a runtime (UrlGuard) prima di effettuare qualsiasi richiesta. Questa protezione SSRF esiste affinché un URL malevolo o mal configurato non possa mai far raggiungere al token Bearer dell'app un host controllato da un aggressore. Sono consentiti solo anonym.legal e anonymize.business (l'host DEV) — ogni altro host viene rifiutato, per design.
Come risolvere
- 1.Usa esattamente https://anonym.legal (produzione) oppure https://anonymize.business (DEV) come URL API del backend.
- 2.Rimuovi qualsiasi percorso finale, porta o refuso dall'URL — la lista consentita confronta esattamente il nome host.
- 3.Se ritieni che un host legittimo venga rifiutato, contatta il supporto — la lista consentita non è intenzionalmente modificabile dall'utente.
Avviso "È disponibile una nuova versione"
Le impostazioni amministrative dell'app mostrano un avviso che indica l'esistenza di una versione più recente.
Perché succede
Entrambe le app controllano periodicamente la disponibilità di una versione più recente e mostrano un semplice avviso amministrativo con un link al changelog quando ne è disponibile una. Questo è un avviso di aggiornamento manuale, non un aggiornamento automatico — nulla si installa da solo sulla tua istanza Nextcloud.
Come risolvere
- 1.Segui il link al changelog nell'avviso per rivedere cosa è cambiato.
- 2.Scarica il nuovo archivio (o gli archivi) dell'app dalla pagina delle release GitHub.
- 3.Estrai in apps/ ed esegui occ upgrade — gli stessi passaggi manuali dell'installazione iniziale — secondo i tuoi tempi.
Errore 403: "Piano Basic o superiore"
Le chiamate API dall'app falliscono con uno stato 403 e un messaggio sulla necessità del piano Basic o superiore.
Perché succede
Entrambe le app Nextcloud richiedono un account anonym.legal con piano Basic o superiore. Il piano gratuito non include l'accesso API da cui queste app dipendono, quindi il backend restituisce 403 con il messaggio "Nextcloud integration requires Basic plan or higher. Please upgrade your plan." invece di un fallimento silenzioso.
Come risolvere
- 1.Conferma a quale account anonym.legal appartiene il token configurato.
- 2.Aggiorna quell'account al piano Basic o superiore.
- 3.Riprova la richiesta — non è necessaria alcuna reinstallazione o riconfigurazione una volta aggiornato l'account.
Il token di integrazione non può leggere le chiavi di crittografia — è un bug?
Una richiesta che tenta di recuperare materiale chiave decrittato con il token configurato viene rifiutata.
Perché succede
No — è intenzionale. Il token usato da queste app è un token con ambito di integrazione, deliberatamente più limitato di un token API dell'intero account: può analizzare e anonimizzare contenuti, ma ogni endpoint che restituirebbe materiale chiave decrittato risponde 403 a un token con ambito di integrazione, così un server Nextcloud compromesso non può mai essere usato per decrittare la tua cronologia di crittografia reversibile.
Cosa fare
- 1.Questo è un comportamento previsto, non un errore da correggere — le app non hanno mai bisogno di materiale chiave decrittato per il loro flusso di lavoro di analisi/anonimizzazione/deanonimizzazione.
- 2.Se un flusso di lavoro richiede realmente l'accesso all'intero account, usa un token API con ambito completo al di fuori di queste app, in un contesto che controlli.
Hai ancora bisogno di aiuto?
Se nessuna delle soluzioni sopra funziona, contattaci e ti aiuteremo a risolvere il problema.