Автор: George Curta ·
Устранение неполадок и FAQ
Устраните проблемы anonym.legal в Nextcloud: отказ из-за списка разрешённых хостов SSRF, уведомление о новой версии и ошибки тарифа Basic для приложений
URL API бэкенда отклонён (разрешённый список SSRF)
Приложение отказывается сохранить URL API бэкенда, или запросы завершаются ошибкой о недопустимом URL.
Почему это происходит
Оба приложения проверяют настроенный URL API бэкенда по проверяемому во время выполнения разрешённому списку хостов (UrlGuard), прежде чем сделать любой запрос. Эта защита от SSRF существует для того, чтобы вредоносный или неправильно настроенный URL никогда не мог заставить Bearer-токен приложения достичь хоста, контролируемого злоумышленником. Разрешены только anonym.legal и anonymize.business (хост DEV) — любой другой хост отклоняется намеренно.
Как исправить
- 1.Используйте точно https://anonym.legal (продакшн) или https://anonymize.business (DEV) в качестве URL API бэкенда.
- 2.Удалите из URL любой конечный путь, порт или опечатку — разрешённый список сверяет имя хоста в точности.
- 3.Если вы считаете, что легитимный хост отклоняется по ошибке, обратитесь в поддержку — разрешённый список намеренно нельзя редактировать пользователю.
Уведомление «Доступна новая версия»
В настройках администратора приложения отображается уведомление о том, что существует более новая версия.
Почему это происходит
Оба приложения периодически проверяют наличие новой версии и показывают простое уведомление администратору со ссылкой на список изменений, когда таковая доступна. Это уведомление о ручном обновлении, а не автоматическое обновление — ничего не устанавливается само по себе на вашем экземпляре Nextcloud.
Как исправить
- 1.Перейдите по ссылке на список изменений в уведомлении, чтобы просмотреть, что изменилось.
- 2.Скачайте новый архив(ы) приложения со страницы релизов GitHub.
- 3.Распакуйте в apps/ и выполните occ upgrade — те же ручные шаги установки, что и при первоначальной установке — по вашему собственному графику.
Ошибка 403: «Тариф Basic или выше»
Вызовы API из приложения завершаются со статусом 403 и сообщением о необходимости тарифа Basic или выше.
Почему это происходит
Оба приложения Nextcloud требуют аккаунт anonym.legal на тарифе Basic или выше. Бесплатный тариф не включает доступ к API, от которого зависят эти приложения, поэтому бэкенд возвращает 403 с сообщением "Nextcloud integration requires Basic plan or higher. Please upgrade your plan." вместо тихого сбоя.
Как исправить
- 1.Убедитесь, какому аккаунту anonym.legal принадлежит настроенный токен.
- 2.Обновите этот аккаунт до тарифа Basic или выше.
- 3.Повторите запрос — переустановка или переконфигурация не требуются после обновления аккаунта.
Токен интеграции не может читать ключи шифрования — это ошибка?
Запрос, пытающийся получить расшифрованный ключевой материал с настроенным токеном, отклоняется.
Почему это происходит
Нет — это сделано намеренно. Токен, используемый этими приложениями, — это токен с ограниченной областью действия для интеграций, намеренно более ограниченный, чем полный API-токен аккаунта: он может анализировать и анонимизировать содержимое, но любая конечная точка, которая вернула бы расшифрованный ключевой материал, отвечает статусом 403 токену с ограниченной областью действия для интеграций, так что скомпрометированный сервер Nextcloud никогда нельзя использовать для расшифровки истории вашего обратимого шифрования.
Что делать
- 1.Это ожидаемое поведение, а не ошибка, которую нужно исправлять — приложениям никогда не нужен расшифрованный ключевой материал для их рабочего процесса анализа/анонимизации/деанонимизации.
- 2.Если рабочему процессу действительно нужен полный доступ к аккаунту, используйте API-токен с полной областью действия вне этих приложений, в контексте, который вы контролируете.
Всё ещё нужна помощь?
Если ни одно из вышеперечисленных решений не помогло, свяжитесь с нами, и мы поможем вам решить проблему.