Autor: ·

Domov/Dokumentace/Nextcloud/Řešení problémů

Řešení problémů a FAQ

Vyřešte běžné problémy anonym.legal pro Nextcloud: odmítnutí allowlistem hostitelů SSRF, upozornění na novou verzi a chyby plánu Basic ze dvou aplikací.

URL backendového API byla odmítnuta (seznam povolených hostitelů SSRF)

Aplikace odmítne uložit URL backendového API, nebo požadavky selžou s chybou, že URL není povolena.

Proč k tomu dochází

Obě aplikace před jakýmkoli požadavkem ověří nakonfigurovanou URL backendového API proti za běhu ověřovanému seznamu povolených hostitelů (UrlGuard). Tato ochrana proti SSRF existuje, aby škodlivá nebo špatně nakonfigurovaná URL nikdy nemohla umožnit, aby se Bearer token aplikace dostal k hostiteli ovládanému útočníkem. Povoleny jsou pouze anonym.legal a anonymize.business (hostitel DEV) — každý jiný hostitel je záměrně odmítnut.

Jak to opravit

  1. 1.Použijte přesně https://anonym.legal (produkce) nebo https://anonymize.business (DEV) jako URL backendového API.
  2. 2.Odstraňte jakoukoli koncovou cestu, port nebo překlep z URL — seznam povolených hostitelů porovnává přesný název hostitele.
  3. 3.Pokud si myslíte, že je odmítán legitimní hostitel, kontaktujte podporu — seznam povolených hostitelů záměrně nelze upravovat uživatelem.

Upozornění "Je k dispozici nová verze"

Administrátorské nastavení aplikace zobrazuje upozornění, že existuje novější verze.

Proč k tomu dochází

Obě aplikace pravidelně kontrolují dostupnost novější verze a v takovém případě zobrazí prosté oznámení pro administrátora s odkazem na seznam změn. Jde o upozornění na ruční upgrade, ne o automatickou aktualizaci — na vaší instanci Nextcloud se nic neinstaluje samo.

Jak to opravit

  1. 1.Přejděte přes odkaz na seznam změn v upozornění a zkontrolujte, co se změnilo.
  2. 2.Stáhněte si nový archiv/archivy aplikace ze stránky GitHub releases.
  3. 3.Rozbalte je do apps/ a spusťte occ upgrade — stejné ruční kroky instalace jako při první instalaci — podle vlastního harmonogramu.

Chyba 403: "plán Basic nebo vyšší"

Volání API z aplikace selžou se stavem 403 a zprávou o vyžadování plánu Basic nebo vyššího.

Proč k tomu dochází

Obě aplikace pro Nextcloud vyžadují účet anonym.legal na plánu Basic nebo vyšším. Bezplatný plán nezahrnuje přístup k API, na kterém tyto aplikace závisí, takže backend místo tichého selhání vrací 403 se zprávou "Nextcloud integration requires Basic plan or higher. Please upgrade your plan."

Jak to opravit

  1. 1.Ověřte, ke kterému účtu anonym.legal nakonfigurovaný token patří.
  2. 2.Upgradujte tento účet na plán Basic nebo vyšší.
  3. 3.Zkuste požadavek znovu — po upgradu účtu není potřeba žádná přeinstalace ani rekonfigurace.

Integrační token neumí číst šifrovací klíče — je to chyba?

Požadavek, který se s nakonfigurovaným tokenem pokusí získat dešifrovaný klíčový materiál, je odmítnut.

Proč k tomu dochází

Ne — je to záměrné. Token, který tyto aplikace používají, je token omezený na integraci, záměrně omezenější než API token celého účtu: dokáže analyzovat a anonymizovat obsah, ale každý koncový bod, který by vrátil dešifrovaný klíčový materiál, tokenu omezenému na integraci vrátí 403, takže kompromitovaný server Nextcloud nelze nikdy použít k dešifrování vaší historie vratného šifrování.

Co dělat

  1. 1.Toto je očekávané chování, ne chyba k opravě — aplikace pro svůj pracovní postup analyzovat/anonymizovat/deanonymizovat nikdy nepotřebují dešifrovaný klíčový materiál.
  2. 2.Pokud nějaký pracovní postup skutečně potřebuje přístup k celému účtu, použijte token API s plným rozsahem mimo tyto aplikace, v kontextu, který ovládáte.

Stále potřebujete pomoc?

Pokud žádné z výše uvedených řešení nefunguje, ozvěte se nám a pomůžeme vám problém vyřešit.