Von George Curta ·
Fehlerbehebung & FAQ
Beheben Sie häufige anonym.legal-Nextcloud-Probleme: die SSRF-Host-Allowlist-Ablehnung, den Hinweis auf neue Versionen und Basic-Plan-Fehler beider Apps
Backend-API-URL abgelehnt (SSRF-Allowlist)
Die App weigert sich, eine Backend-API-URL zu speichern, oder Anfragen schlagen mit einem Fehler „URL nicht erlaubt“ fehl.
Warum das passiert
Beide Apps prüfen die konfigurierte Backend-API-URL vor jeder Anfrage gegen eine zur Laufzeit geprüfte Host-Allowlist (UrlGuard). Dieser SSRF-Schutz stellt sicher, dass eine bösartige oder falsch konfigurierte URL das Bearer-Token der App niemals zu einem von einem Angreifer kontrollierten Host gelangen lässt. Nur anonym.legal und anonymize.business (der DEV-Host) sind erlaubt — jeder andere Host wird bewusst abgelehnt.
So beheben Sie es
- 1.Verwenden Sie exakt https://anonym.legal (Produktion) oder https://anonymize.business (DEV) als Backend-API-URL.
- 2.Entfernen Sie jeden zusätzlichen Pfad, Port oder Tippfehler aus der URL — die Allowlist vergleicht exakt den Hostnamen.
- 3.Wenn Sie glauben, dass ein legitimer Host abgelehnt wird, kontaktieren Sie den Support — die Allowlist ist bewusst nicht vom Nutzer bearbeitbar.
Hinweis „Eine neue Version ist verfügbar“
Die Admin-Einstellungen der App zeigen einen Hinweis, dass eine neuere Version existiert.
Warum das passiert
Beide Apps prüfen regelmäßig auf eine neuere Version und zeigen einen einfachen Admin-Hinweis mit einem Link zum Änderungsprotokoll an, sobald eine verfügbar ist. Dies ist ein manueller Upgrade-Hinweis, kein automatisches Update — nichts installiert sich selbst auf Ihrer Nextcloud-Instanz.
So beheben Sie es
- 1.Folgen Sie dem Link zum Änderungsprotokoll im Hinweis, um zu sehen, was sich geändert hat.
- 2.Laden Sie das neue App-Archiv bzw. die App-Archive von der GitHub-Releases-Seite herunter.
- 3.Entpacken Sie sie in apps/ und führen Sie occ upgrade aus — dieselben manuellen Installationsschritte wie bei der Erstinstallation — zu Ihrem eigenen Zeitpunkt.
403-Fehler: „Basic-Plan oder höher“
API-Aufrufe aus der App schlagen mit Status 403 und einer Meldung über den erforderlichen Basic-Plan oder höher fehl.
Warum das passiert
Beide Nextcloud-Apps erfordern ein anonym.legal-Konto im Basic-Plan oder höher. Der kostenlose Plan enthält nicht den API-Zugriff, auf den diese Apps angewiesen sind, daher liefert das Backend 403 mit der Meldung „Nextcloud integration requires Basic plan or higher. Please upgrade your plan.“ statt eines stillen Fehlschlags.
So beheben Sie es
- 1.Prüfen Sie, zu welchem anonym.legal-Konto das konfigurierte Token gehört.
- 2.Upgraden Sie dieses Konto auf den Basic-Plan oder höher.
- 3.Wiederholen Sie die Anfrage — sobald das Konto upgegradet ist, ist keine Neuinstallation oder Neukonfiguration nötig.
Integrationstoken kann keine Verschlüsselungsschlüssel lesen — ist das ein Fehler?
Eine Anfrage, die mit dem konfigurierten Token versucht, entschlüsseltes Schlüsselmaterial abzurufen, wird abgelehnt.
Warum das passiert
Nein — das ist beabsichtigt. Das Token, das diese Apps verwenden, ist ein integrationsbegrenztes Token, bewusst eingeschränkter als ein vollständiges Konto-API-Token: Es kann Inhalte analysieren und anonymisieren, aber jeder Endpunkt, der entschlüsseltes Schlüsselmaterial zurückgeben würde, liefert für ein integrationsbegrenztes Token 403 — so kann ein kompromittierter Nextcloud-Server niemals genutzt werden, um Ihren Verlauf umkehrbarer Verschlüsselung zu entschlüsseln.
Was zu tun ist
- 1.Dies ist erwartetes Verhalten, kein zu behebender Fehler — die Apps benötigen für ihren Analyse-/Anonymisierungs-/Deanonymisierungs-Workflow niemals entschlüsseltes Schlüsselmaterial.
- 2.Falls ein Workflow tatsächlich vollständigen Kontozugriff benötigt, verwenden Sie außerhalb dieser Apps ein API-Token mit vollem Umfang, in einem von Ihnen kontrollierten Kontext.
Brauchen Sie noch Hilfe?
Wenn keine der oben genannten Lösungen funktioniert, kontaktieren Sie uns und wir helfen Ihnen, das Problem zu lösen.