Autor: George Curta ·
Rozwiązywanie problemów i FAQ
Rozwiąż problemy z anonym.legal w Nextcloud: odrzucenie z listy dozwolonych hostów SSRF, powiadomienie o wersji oraz błędy planu Basic z obu aplikacji.
Adres URL API backendu odrzucony (lista dozwolonych hostów SSRF)
Aplikacja odmawia zapisania adresu URL API backendu, lub żądania kończą się błędem niedozwolonego adresu URL.
Dlaczego tak się dzieje
Obie aplikacje weryfikują skonfigurowany adres URL API backendu względem listy dozwolonych hostów zweryfikowanej w czasie działania (UrlGuard) przed wykonaniem jakiegokolwiek żądania. To zabezpieczenie SSRF istnieje, aby złośliwy lub błędnie skonfigurowany adres URL nigdy nie mógł spowodować, że token Bearer aplikacji trafi do hosta kontrolowanego przez atakującego. Dozwolone są tylko anonym.legal i anonymize.business (host DEV) — każdy inny host jest celowo odrzucany.
Jak to naprawić
- 1.Użyj dokładnie https://anonym.legal (produkcja) lub https://anonymize.business (DEV) jako adresu URL API backendu.
- 2.Usuń wszelkie końcowe ścieżki, porty lub literówki z adresu URL — lista dozwolonych hostów dopasowuje dokładnie nazwę hosta.
- 3.Jeśli uważasz, że prawidłowy host jest odrzucany, skontaktuj się z pomocą techniczną — lista dozwolonych hostów jest celowo nieedytowalna przez użytkownika.
Powiadomienie "Dostępna jest nowa wersja"
Ustawienia administratora aplikacji pokazują powiadomienie, że istnieje nowsza wersja.
Dlaczego tak się dzieje
Obie aplikacje okresowo sprawdzają dostępność nowszej wersji i wyświetlają zwykłe powiadomienie administratora z linkiem do dziennika zmian, gdy jest ona dostępna. To jest powiadomienie o ręcznej aktualizacji, a nie automatyczna aktualizacja — nic nie instaluje się samo w Twojej instancji Nextcloud.
Jak to naprawić
- 1.Skorzystaj z linku do dziennika zmian w powiadomieniu, aby przejrzeć, co się zmieniło.
- 2.Pobierz nowe archiwum(-a) aplikacji ze strony wydań GitHub.
- 3.Rozpakuj do apps/ i uruchom occ upgrade — te same ręczne kroki instalacji co przy instalacji początkowej — według własnego harmonogramu.
Błąd 403: "Plan Basic lub wyższy"
Wywołania API z aplikacji kończą się statusem 403 i komunikatem o wymogu planu Basic lub wyższego.
Dlaczego tak się dzieje
Obie aplikacje Nextcloud wymagają konta anonym.legal w planie Basic lub wyższym. Plan darmowy nie obejmuje dostępu do API, od którego zależą te aplikacje, więc backend zwraca 403 z komunikatem "Nextcloud integration requires Basic plan or higher. Please upgrade your plan." zamiast cichego błędu.
Jak to naprawić
- 1.Potwierdź, do którego konta anonym.legal należy skonfigurowany token.
- 2.Ulepsz to konto do planu Basic lub wyższego.
- 3.Ponów żądanie — po ulepszeniu konta nie jest potrzebna ponowna instalacja ani konfiguracja.
Token integracji nie może odczytać kluczy szyfrowania — czy to błąd?
Żądanie próbujące pobrać odszyfrowany materiał klucza za pomocą skonfigurowanego tokena zostaje odrzucone.
Dlaczego tak się dzieje
Nie — to celowe. Token używany przez te aplikacje to token o zakresie integracji, celowo bardziej ograniczony niż pełny token API konta: może analizować i anonimizować treść, ale każdy punkt końcowy, który zwracałby odszyfrowany materiał klucza, odrzuca token o zakresie integracji z błędem 403, dzięki czemu przejęty serwer Nextcloud nigdy nie może zostać użyty do odszyfrowania Twojej historii odwracalnego szyfrowania.
Co zrobić
- 1.To oczekiwane zachowanie, a nie błąd do naprawienia — aplikacje nigdy nie potrzebują odszyfrowanego materiału klucza dla swojego przepływu analizy/anonimizacji/deanonimizacji.
- 2.Jeśli jakiś przepływ pracy naprawdę wymaga pełnego dostępu do konta, użyj tokena API o pełnym zakresie poza tymi aplikacjami, w kontekście, który kontrolujesz.
Nadal potrzebujesz pomocy?
Jeśli żadne z powyższych rozwiązań nie zadziała, skontaktuj się z nami, a pomożemy Ci rozwiązać problem.