Door George Curta ·
Probleemoplossing & FAQ
Los veelvoorkomende anonym.legal Nextcloud-problemen op: de SSRF-allowlist-weigering, de nieuwe-versiemelding en Basic-plan-fouten vanuit de twee apps.
Backend-API-URL geweigerd (SSRF-allowlist)
De app weigert een backend-API-URL op te slaan, of verzoeken mislukken met een URL-not-allowed-fout.
Waarom dit gebeurt
Beide apps valideren de geconfigureerde backend-API-URL tegen een tijdens runtime gevalideerde host-allowlist (UrlGuard) voordat er een verzoek wordt gedaan. Deze SSRF-beveiliging bestaat zodat een kwaadaardige of verkeerd geconfigureerde URL het Bearer-token van de app nooit naar een door een aanvaller gecontroleerde host kan laten gaan. Alleen anonym.legal en anonymize.business (de DEV-host) zijn toegestaan — elke andere host wordt bewust geweigerd.
Hoe op te lossen
- 1.Gebruik exact https://anonym.legal (productie) of https://anonymize.business (DEV) als backend-API-URL.
- 2.Verwijder elk achterliggend pad, poortnummer of typefout uit de URL — de allowlist matcht de hostnaam exact.
- 3.Als u denkt dat een legitieme host ten onrechte wordt geweigerd, neem dan contact op met de ondersteuning — de allowlist is opzettelijk niet door gebruikers te bewerken.
Melding "Er is een nieuwe versie beschikbaar"
De beheerdersinstellingen van de app tonen een melding dat er een nieuwere versie bestaat.
Waarom dit gebeurt
Beide apps controleren periodiek op een nieuwere versie en tonen een eenvoudige beheerdersmelding met een link naar het wijzigingslogboek wanneer er één beschikbaar is. Dit is een melding voor handmatige upgrade, geen automatische update — er wordt niets zelfstandig geïnstalleerd op uw Nextcloud-omgeving.
Hoe op te lossen
- 1.Volg de link naar het wijzigingslogboek in de melding om te bekijken wat er is veranderd.
- 2.Download het nieuwe app-archief (of de archieven) vanaf de GitHub-releasespagina.
- 3.Pak uit in apps/ en voer occ upgrade uit — dezelfde handmatige installatiestappen als bij de eerste installatie — op uw eigen moment.
403-fout: "Basic-plan of hoger"
API-aanroepen vanuit de app mislukken met een 403-status en een melding dat het Basic-plan of hoger vereist is.
Waarom dit gebeurt
Beide Nextcloud-apps vereisen een anonym.legal-account op het Basic-plan of hoger. Het gratis plan omvat niet de API-toegang waarvan deze apps afhankelijk zijn, dus de backend geeft 403 terug met de melding "Nextcloud integration requires Basic plan or higher. Please upgrade your plan." in plaats van stil te falen.
Hoe op te lossen
- 1.Bevestig tot welk anonym.legal-account het geconfigureerde token behoort.
- 2.Upgrade dat account naar het Basic-plan of hoger.
- 3.Probeer het verzoek opnieuw — zodra het account is geüpgraded, is geen herinstallatie of herconfiguratie nodig.
Integratietoken kan geen versleutelingssleutels lezen — is dat een bug?
Een verzoek dat met het geconfigureerde token ontsleuteld sleutelmateriaal probeert op te halen, wordt geweigerd.
Waarom dit gebeurt
Nee — dit is opzettelijk. Het token dat deze apps gebruiken is een integratie-specifiek token, opzettelijk beperkter dan een volledig accounttoken: het kan inhoud analyseren en anonimiseren, maar elk eindpunt dat ontsleuteld sleutelmateriaal zou teruggeven, geeft een integratie-specifiek token een 403, zodat een gecompromitteerde Nextcloud-server nooit kan worden gebruikt om uw geschiedenis van omkeerbare versleuteling te ontsleutelen.
Wat te doen
- 1.Dit is verwacht gedrag, geen fout om op te lossen — de apps hebben nooit ontsleuteld sleutelmateriaal nodig voor hun analyseren/anonimiseren/de-anonimiseren-workflow.
- 2.Als een workflow werkelijk volledige accounttoegang nodig heeft, gebruik dan een API-token met volledige scope buiten deze apps, in een context die u zelf beheert.
Heeft u nog hulp nodig?
Als geen van de bovenstaande oplossingen werkt, neem contact met ons op en wij helpen u het probleem op te lossen.