Szerző: George Curta ·
Hibaelhárítás és GYIK
Javítsa ki a gyakori anonym.legal Nextcloud hibákat: az SSRF host-engedélylista elutasítását, új verzió értesítést és a Basic-csomag korlátozási hibáit.
A backend API URL elutasítva (SSRF-engedélylista)
Az alkalmazás nem menti el a backend API URL-t, vagy a kérések „URL nem engedélyezett” hibával meghiúsulnak.
Miért történik ez?
Mindkét alkalmazás egy futásidőben ellenőrzött host-engedélylista (UrlGuard) alapján validálja a konfigurált backend API URL-t, mielőtt bármilyen kérést küldene. Ez az SSRF-védelem azért létezik, hogy egy rosszindulatú vagy hibásan konfigurált URL soha ne juttathassa el az alkalmazás Bearer tokenjét egy támadó által irányított hosthoz. Csak az anonym.legal és az anonymize.business (a DEV host) engedélyezett — minden más host tervezésből adódóan elutasításra kerül.
Megoldás
- 1.Használja pontosan a https://anonym.legal (éles) vagy https://anonymize.business (DEV) URL-t backend API URL-ként.
- 2.Távolítson el minden záró elérési utat, portot vagy elírást az URL-ből — az engedélylista pontosan a hostnevet egyezteti.
- 3.Ha úgy gondolja, hogy egy jogos host kerül elutasításra, forduljon az ügyfélszolgálathoz — az engedélylista szándékosan nem felhasználó által szerkeszthető.
„Új verzió érhető el” értesítés
Az alkalmazás admin beállításai egy értesítést mutatnak arról, hogy újabb verzió létezik.
Miért történik ez?
Mindkét alkalmazás rendszeresen ellenőrzi, hogy elérhető-e újabb verzió, és egy egyszerű admin értesítést jelenít meg a changelog hivatkozásával, ha van elérhető frissítés. Ez egy manuális frissítési értesítés, nem automatikus frissítés — semmi sem települ magától a Nextcloud-példányán.
Megoldás
- 1.Kövesse az értesítésben található changelog hivatkozást, hogy áttekintse a változásokat.
- 2.Töltse le az új alkalmazásarchívumo(ka)t a GitHub releases oldaláról.
- 3.Csomagolja ki az apps/ könyvtárba, és futtassa az occ upgrade parancsot — ugyanazok a manuális telepítési lépések, mint a kezdeti telepítésnél — a saját ütemezése szerint.
403-as hiba: „Basic vagy magasabb csomag”
Az alkalmazásból érkező API-hívások 403-as állapottal és egy, a Basic vagy magasabb csomag szükségességéről szóló üzenettel meghiúsulnak.
Miért történik ez?
Mindkét Nextcloud alkalmazáshoz Basic vagy magasabb szintű anonym.legal fiók szükséges. Az ingyenes csomag nem tartalmazza azt az API-hozzáférést, amelytől ezek az alkalmazások függenek, ezért a backend 403-as választ ad a „Nextcloud integration requires Basic plan or higher. Please upgrade your plan.” üzenettel, csendes hiba helyett.
Megoldás
- 1.Ellenőrizze, melyik anonym.legal fiókhoz tartozik a konfigurált token.
- 2.Frissítse azt a fiókot Basic vagy magasabb csomagra.
- 3.Próbálja újra a kérést — a fiók frissítése után nincs szükség újratelepítésre vagy újrakonfigurálásra.
Az integrációs token nem tudja beolvasni a titkosítási kulcsokat — ez hiba?
Egy olyan kérés, amely a konfigurált tokennel próbál visszafejtett kulcsanyagot lekérni, elutasításra kerül.
Miért történik ez?
Nem — ez szándékos. Az ezen alkalmazások által használt token egy integrációs hatókörű token, amely szándékosan korlátozottabb, mint egy teljes fiókos API token: elemezhet és anonimizálhat tartalmat, de minden olyan végpont, amely visszafejtett kulcsanyagot adna vissza, 403-as választ ad egy integrációs hatókörű tokenre, így egy kompromittált Nextcloud szerver soha nem használható fel a visszafordítható titkosítású előzményei visszafejtésére.
Mit tegyen
- 1.Ez elvárt viselkedés, nem javítandó hiba — az alkalmazásoknak soha nincs szükségük visszafejtett kulcsanyagra az elemzés/anonimizálás/visszaanonimizálás munkafolyamatukhoz.
- 2.Ha egy munkafolyamatnak valóban szüksége van teljes fiókhoz való hozzáférésre, használjon egy teljes hatókörű API tokent ezeken az alkalmazásokon kívül, egy Ön által kontrollált környezetben.
Továbbra is segítségre van szüksége?
Ha a fenti megoldások egyike sem működik, forduljon hozzánk, és segítünk megoldani a problémát.