Par George Curta ·
Dépannage et questions fréquentes
Résolvez les problèmes d'anonym.legal dans Nextcloud : rejet de la liste d'autorisation SSRF, notification de nouvelle version, erreurs du plan Basic.
URL API du backend rejetée (liste d'autorisation SSRF)
L'application refuse d'enregistrer une URL API de backend, ou les requêtes échouent avec une erreur d'URL non autorisée.
Pourquoi cela se produit
Les deux applications valident l'URL API du backend configurée par rapport à une liste d'autorisation d'hôtes validée à l'exécution (UrlGuard) avant d'effectuer toute requête. Cette protection SSRF existe pour qu'une URL malveillante ou mal configurée ne puisse jamais faire atteindre un hôte contrôlé par un attaquant avec le token Bearer de l'application. Seuls anonym.legal et anonymize.business (l'hôte DEV) sont autorisés — tout autre hôte est rejeté, par conception.
Comment résoudre
- 1.Utilisez exactement https://anonym.legal (production) ou https://anonymize.business (DEV) comme URL API du backend.
- 2.Supprimez tout chemin, port ou faute de frappe supplémentaire de l'URL — la liste d'autorisation correspond exactement au nom d'hôte.
- 3.Si vous pensez qu'un hôte légitime est rejeté, contactez le support — la liste d'autorisation n'est délibérément pas modifiable par l'utilisateur.
Notification « Une nouvelle version est disponible »
Les paramètres administrateur de l'application affichent une notification indiquant qu'une version plus récente existe.
Pourquoi cela se produit
Les deux applications vérifient périodiquement l'existence d'une version plus récente et affichent une simple notification administrateur avec un lien vers le journal des modifications lorsqu'une est disponible. Il s'agit d'une notification de mise à niveau manuelle, pas d'une mise à jour automatique — rien ne s'installe de lui-même sur votre instance Nextcloud.
Comment résoudre
- 1.Suivez le lien du journal des modifications dans la notification pour voir ce qui a changé.
- 2.Téléchargez la ou les nouvelles archives d'application depuis la page GitHub releases.
- 3.Extrayez dans apps/ et exécutez occ upgrade — les mêmes étapes d'installation manuelle que l'installation initiale — selon votre propre calendrier.
Erreur 403 : « Plan Basic ou supérieur »
Les appels API depuis l'application échouent avec un statut 403 et un message concernant l'exigence d'un plan Basic ou supérieur.
Pourquoi cela se produit
Les deux applications Nextcloud nécessitent un compte anonym.legal avec un plan Basic ou supérieur. Le plan gratuit n'inclut pas l'accès API dont ces applications dépendent, donc le backend renvoie 403 avec le message « Nextcloud integration requires Basic plan or higher. Please upgrade your plan. » au lieu d'un échec silencieux.
Comment résoudre
- 1.Confirmez à quel compte anonym.legal appartient le token configuré.
- 2.Mettez à niveau ce compte vers le plan Basic ou supérieur.
- 3.Réessayez la requête — aucune réinstallation ou reconfiguration n'est nécessaire une fois le compte mis à niveau.
Le token d'intégration ne peut pas lire les clés de chiffrement — est-ce un bug ?
Une requête qui tente de récupérer le matériel de clé déchiffré avec le token configuré est rejetée.
Pourquoi cela se produit
Non — c'est intentionnel. Le token utilisé par ces applications est un token à portée d'intégration, délibérément plus limité qu'un token API de compte complet : il peut analyser et anonymiser du contenu, mais tout endpoint qui renverrait du matériel de clé déchiffré renvoie 403 à un token à portée d'intégration, afin qu'un serveur Nextcloud compromis ne puisse jamais être utilisé pour déchiffrer l'historique de votre chiffrement réversible.
Que faire
- 1.Il s'agit d'un comportement attendu, pas d'un bug à corriger — les applications n'ont jamais besoin de matériel de clé déchiffré pour leur flux d'analyse/anonymisation/désanonymisation.
- 2.Si un flux de travail a réellement besoin d'un accès complet au compte, utilisez un token API à portée complète en dehors de ces applications, dans un environnement que vous contrôlez.
Besoin d'aide supplémentaire ?
Si aucune des solutions ci-dessus ne fonctionne, contactez-nous et nous vous aiderons à résoudre le problème.