Автор: George Curta ·
Усунення проблем і FAQ
Вирішення поширених проблем anonym.legal Nextcloud: відхилення allowlist хостів SSRF, сповіщення про версію та помилки плану Basic у двох застосунках.
URL-адресу бекенд-API відхилено (allowlist SSRF)
Застосунок відмовляється зберігати URL-адресу бекенд-API, або запити завершуються помилкою «URL не дозволено».
Чому це відбувається
Перед будь-яким запитом обидва застосунки перевіряють налаштовану URL-адресу бекенд-API за allowlist хостів, що перевіряється під час виконання (UrlGuard). Цей захист від SSRF існує для того, щоб шкідлива або неправильно налаштована URL-адреса ніколи не могла призвести до того, що Bearer-токен застосунку потрапить на контрольований зловмисником хост. Дозволено лише anonym.legal та anonymize.business (хост DEV) — усі інші хости відхиляються за задумом.
Як виправити
- 1.Використовуйте точно https://anonym.legal (production) або https://anonymize.business (DEV) як URL-адресу бекенд-API.
- 2.Видаліть будь-який зайвий шлях, порт або друкарську помилку з URL-адреси — allowlist перевіряє точну відповідність імені хоста.
- 3.Якщо ви вважаєте, що легітимний хост відхиляється помилково, зверніться до підтримки — allowlist навмисно недоступний для редагування користувачем.
Сповіщення «Доступна нова версія»
У налаштуваннях адміністратора застосунку з'являється сповіщення про наявність новішої версії.
Чому це відбувається
Обидва застосунки періодично перевіряють наявність новішої версії та показують просте сповіщення адміністратору з посиланням на список змін, коли вона доступна. Це сповіщення про ручне оновлення, а не автоматичне оновлення — на вашому інстансі Nextcloud нічого не встановлюється самостійно.
Як виправити
- 1.Перейдіть за посиланням на список змін у сповіщенні, щоб переглянути, що змінилося.
- 2.Завантажте новий архів(и) застосунку зі сторінки GitHub releases.
- 3.Розпакуйте у каталог apps/ і виконайте occ upgrade — ті самі кроки ручного встановлення, що й для початкового встановлення — у зручний для вас час.
Помилка 403: «план Basic або вищий»
Виклики API із застосунку завершуються статусом 403 і повідомленням про необхідність плану Basic або вищого.
Чому це відбувається
Обидва застосунки для Nextcloud вимагають облікового запису anonym.legal на плані Basic або вищому. Безкоштовний план не включає доступ до API, від якого залежать ці застосунки, тому замість тихої відмови бекенд повертає 403 із повідомленням «Інтеграція з Nextcloud вимагає плану Basic або вищого. Будь ласка, оновіть свій план.»
Як виправити
- 1.Перевірте, якому обліковому запису anonym.legal належить налаштований токен.
- 2.Оновіть цей обліковий запис до плану Basic або вищого.
- 3.Повторіть запит — після оновлення облікового запису перевстановлення чи повторне налаштування не потрібні.
Токен для інтеграцій не може прочитати ключі шифрування — це помилка?
Запит, який намагається отримати розшифрований ключовий матеріал за допомогою налаштованого токена, відхиляється.
Чому це відбувається
Ні — це навмисна поведінка. Токен, який використовують ці застосунки, є токеном з обмеженою областю дії для інтеграцій, навмисно більш обмеженим, ніж повний токен API облікового запису: він може аналізувати й анонімізувати вміст, але будь-яка кінцева точка, що повертає розшифрований ключовий матеріал, відповідає токену з обмеженою областю дії кодом 403, тож скомпрометований сервер Nextcloud ніколи не можна використати для розшифрування історії оборотного шифрування.
Що робити
- 1.Це очікувана поведінка, а не помилка, яку потрібно виправляти — застосункам ніколи не потрібен розшифрований ключовий матеріал для їхнього робочого процесу аналізу/анонімізації/деанонімізації.
- 2.Якщо робочому процесу справді потрібен повний доступ до облікового запису, використовуйте повний токен API поза цими застосунками, у контексті, який ви контролюєте.
Потрібна додаткова допомога?
Якщо жодне з наведених рішень не допомогло, зверніться до нас, і ми допоможемо вирішити проблему.