diff --git a/docs/FIX-500-LOGIN.md b/docs/FIX-500-LOGIN.md new file mode 100644 index 0000000..3bff7e0 --- /dev/null +++ b/docs/FIX-500-LOGIN.md @@ -0,0 +1,89 @@ +# Почему был 500 на всех сервисах с единым входом (18.10.2026) + +## Симптом + +После ввода пароля в Authentik **любой** сервис отдавал +`500 Internal Server Error`. Прямые адреса работали, сами службы были +живы, Authentik писал вход как успешный. + +## Настоящая причина + +В журнале одного из прокси нашлась точная строка: + +``` +Error redeeming code during OAuth2 callback: +email in id_token (maloyakapg@gmail.com) isn't verified +``` + +Дальше — в базе Authentik. Стандартное сопоставление области `email` +в версии **2026.8** выглядит так: + +```python +return { + "email": request.user.email, + "email_verified": False +} +``` + +**`email_verified` зашито жёстко в `False`.** А `oauth2-proxy` по +умолчанию не пускает дальше, если почта не помечена проверенной. Отсюда: +вход проходит, а на возврате — отказ и 500. + +В версии 2026.8 из таблицы пользователей **убрали поле `email_verified`** +(я проверил: колонки нет), поэтому в сопоставлении и стоит константа. + +Это следствие сегодняшнего обновления Authentik до 2026.8, а не правок +в прокси. До обновления работало. + +## Что сделано + +Выражение сопоставления заменено на: + +```python +return { + "email": request.user.email, + "email_verified": True +} +``` + +Почему `True` честно: почта хранится в самом Authentik, другого +источника у неё нет, отдельной процедуры подтверждения у нас не +заведено. То есть «проверена» здесь означает «взята из доверенного +источника», а не «кто-то нажал ссылку в письме». + +**Проверено:** `userinfo` теперь отдаёт `"email_verified": true`. + +## Как я искал (и где ошибался) + +1. Проверил коды на краю — везде 302, значит 500 возникает **после** + входа. Уже это сузило поиск. +2. Проверил журнал Authentik — **ни одного 5xx**. Значит отвечает не он. +3. Нашёл в логе VPS строки `GET /oauth2/callback ... 500` — падает + именно возврат с кодом. +4. Прочитал журнал прокси **без фильтра** (сначала фильтровал по + `error|fail` и нужная строка про `isn't verified` не попадала в + выборку) — и увидел причину. + +Ошибка поиска: я слишком долго смотрел на `grant_types`. Он тоже был +неправ (я это исправил раньше), но 500 давала именно непроверенная почта. + +## Что это значит на будущее + +* **Обновления Authentik ломают вход тихо.** Стоит после каждого + обновления проверять вход на одном сервисе. +* Правка сопоставления — в базе, при следующем обновлении Authentik + может вернуться стандартное выражение. Тогда вход снова сломается. + Проверка простая: `curl` к `userinfo` и смотреть `email_verified`. + +## Проверка одной командой + +``` +curl -s -X POST https://authentik.buryans.ru/application/o/token/ -k \ + -d grant_type=client_credentials -d client_id=sonarr-proxy \ + -d client_secret=СЕКРЕТ -d scope="openid email profile" \ + | python3 -c "import json,sys;print(json.load(sys.stdin)['access_token'])" \ + | xargs -I{} curl -s -k -H "Authorization: Bearer {}" \ + https://authentik.buryans.ru/application/o/userinfo/ +``` + +В ответе должно быть `"email_verified": true`. diff --git a/docs/TASKS.md b/docs/TASKS.md index 87308b7..3161529 100644 --- a/docs/TASKS.md +++ b/docs/TASKS.md @@ -34,12 +34,12 @@ | ЗАВЕРШИТЬ ОБНОВЛЕНИЯ | 15 | 15 | 0 | **0** | | СЕТЬ И ДОСТУП | 6 | 5 | 0 | **1** | | ЗВОНКИ И МЕДИА | 8 | 4 | 1 | **3** | -| СКВОЗНАЯ СВЯЗНОСТЬ | 16 | 8 | 2 | **6** | +| СКВОЗНАЯ СВЯЗНОСТЬ | 17 | 9 | 2 | **6** | | УЛУЧШЕНИЕ СЛУЖБ | 13 | 9 | 0 | **4** | | КНИЖНАЯ БИБЛИОТЕКА | 8 | 6 | 1 | **1** | | VPN (этапы 1–4) | 29 | 21 | 3 | **5** | | РЕЕСТР НАЙДЕННЫХ ПРОБЛЕМ | 17 | 12 | 1 | **4** | -| **ИТОГО** | **112** | **80** | **8** | **24** | +| **ИТОГО** | **113** | **81** | **8** | **24** | --- @@ -80,6 +80,7 @@ + ## 1. ЗАВЕРШИТЬ ОБНОВЛЕНИЯ @@ -136,6 +137,7 @@ | 4.1.4 | Вход через OIDC внутри Immich и Gitea | ⬜ прокси им не подходит | | 4.1.5 | Починить сторож buryan-agent (поднимал отключённое) | ✅ 28 контейнеров | | 4.1.6 | Провайдеры входа: заполнить grant_types | ✅ 9 провайдеров | +| 4.1.7 | 500 на всех сервисах после входа | ✅ Authentik 2026.8 отдавал email_verified=false | | 4.1.3 | Перевод прокси входа на внешние адреса | ✅ 15 прокси, один аккаунт | | 4.1.2 | Права по группам | ⬜ | | 4.2.1 | Все службы шлют через общий слой | 🔶 частично | diff --git a/docs/library/INSTRUCTION-POLINA.md b/docs/library/INSTRUCTION-POLINA.md index a2f36ce..f361ffc 100644 --- a/docs/library/INSTRUCTION-POLINA.md +++ b/docs/library/INSTRUCTION-POLINA.md @@ -1,97 +1,105 @@ -# Библиотека Buryans Hub — как пользоваться +# 📚 Твоя библиотека -Здравствуйте, Полина! +Привет, Полина! -Теперь у вас есть своя онлайн-библиотека. Всё в одном месте: каталог -прочитанного, поиск книг и сами книги. +Теперь у тебя есть личная онлайн-библиотека. В ней: -## С чего начать +* 📖 **твои книги** — можно читать и скачивать; +* 📋 **твой список чтения** — что уже прочитано; +* 🔎 **поиск** — где найти книгу, которой ещё нет. -**1. Адрес библиотеки:** https://books.buryans.ru +--- -Откроется страница входа. Войдите **тем же аккаунтом, что и в остальные -сервисы** (единый вход) — отдельный пароль не нужен. +## 🚪 Как войти -**2. Ваш каталог чтения:** https://books.buryans.ru/catalog/ +1. Открой ссылку: **https://books.buryans.ru** +2. Нажми «Войти». +3. Введи **свой обычный пароль** — тот же, что для остальных сервисов. + Отдельный пароль для библиотеки не нужен. -Там собрано всё, что вы прочитали: +Всё. Ты внутри. -| Что видно | Значение | +--- + +## 📋 Где твой список книг + +Открой: **https://books.buryans.ru/catalog/** + +Там четыре кнопки сверху: + +| Кнопка | Что показывает | |---|---| -| Книг в каталоге | 181 | -| Серий | 45 | -| Прочитано | 181 | -| Книг к поиску | 25 | +| **Обзор** | сколько прочитано и как дела с сериями | +| **Серии** | по каждой серии — сколько прочитано и вышла ли следующая | +| **Книги** | весь список прочитанного | +| **Что искать** | книги, которых у тебя ещё нет | -Разделы: +Сейчас в списке **181 книга** и **45 серий**. -* **Обзор** — сколько прочитано, состояние серий; -* **Серии** — по каждой серии: сколько прочитано, вышла ли следующая книга; -* **Книги** — полный список; -* **Что искать** — книги, которых ещё нет, со ссылками на поиск. +--- -## Как найти книгу +## 🔎 Как найти книгу, которой нет -В разделе **«Что искать»** у каждой книги есть кнопки: +1. Открой **«Что искать»**. +2. Найди нужную книгу. +3. Под ней — кнопки с названиями сайтов. Нажми любую: -| Кнопка | Что делает | +| Кнопка | Зачем | |---|---| -| **ЛитРес** | магазин: цена и покупка | -| **Bookmate** | подписка на книги | -| **Open Library** | мировой каталог: описание и ISBN | -| **archive.org** | большой архив, много старых книг | -| **ФантЛаб** | карточка книги, отзывы, серия | -| **Гутенберг** | бесплатные книги со свободными правами | -| **Флибуста**, **libgen**, **КулЛиб**, **ЛитМир** | библиотеки, где часто есть переводы | +| **ЛитРес** | купить книгу — там видна цена | +| **ФантЛаб** | почитать про книгу и серию | +| **Open Library** | описание и год издания | +| **archive.org** | старые книги, много бесплатных | +| **Флибуста**, **libgen** | там часто есть переводы | +| **Гутенберг** | совсем бесплатные книги | -Один поиск — везде сразу. Не нужно самой обходить десять сайтов. +Нажимаешь — открывается поиск именно по этой книге. Не надо самой +искать по десяти сайтам. -## Как положить книгу в библиотеку +--- -**Способ 1 (простой):** скачайте файл, откройте https://books.buryans.ru -и нажмите кнопку загрузки. Книги принимаются в форматах **EPUB, FB2, -PDF, MOBI, AZW3**. +## ⬆️ Как добавить книгу в библиотеку -**Способ 2 (ещё проще):** если книгу присылает программа-загрузчик — -она попадёт в библиотеку сама, через автоматическую папку приёма. +**Самый простой способ:** -После загрузки библиотека сама: -* прочитает название и автора из файла; -* подтянет описание и обложку; -* разложит по авторам и сериям. +1. Открой **https://books.buryans.ru** +2. Нажми кнопку **«Загрузить»** (вверху или в меню). +3. Выбери файл книги на телефоне или компьютере. -## Что можно делать с книгой +Подходят форматы: **EPUB, FB2, PDF, MOBI, AZW3**. -| Действие | Где | +Библиотека сама: +* прочитает название и автора; +* поставит обложку; +* положит книгу на нужную полку. + +--- + +## 📥 Как читать или скачать + +В карточке любой книги есть кнопки: + +* **«Скачать»** — сохранить файл; +* **«Читать»** — открыть прямо в браузере. + +--- + +## ❓ Если что-то не получается + +| Проблема | Что сделать | |---|---| -| Скачать | кнопка «Скачать» в карточке книги | -| Читать онлайн | кнопка «Читать» | -| Отправить на читалку | кнопка «Отправить на Kindle/Kobo» | -| Изменить название или обложку | «Редактировать» (вы — администратор библиотеки) | +| Не пускает войти | Проверь, что вводишь пароль от остальных сервисов. Если не помогает — напиши Роману | +| Книга не появляется | Подожди минуту и обнови страницу | +| Нет нужной книги | Посмотри «Что искать» или напиши — добавят | +| Страница не открывается | Проверь интернет, потом обнови | -## Если книги нет +--- -1. Откройте «Что искать» — там список того, что вы ещё не читали. -2. Нажмите «ЛитРес» — если книга переведена, она там есть с ценой. -3. Если перевода нет — смотрите Флибусту или libgen. -4. Можно попросить: напишите в чат, и книгу добавят. +## 💡 Полезно знать -## Про статистику +* **Один пароль на всё** — библиотека, чат, файлы. Запоминать ничего + нового не надо. +* **Книги не пропадут** — они сохраняются и резервируются. +* **Видишь только ты** — библиотека закрыта, доступ у тебя и у Романа. -Каталог считает сам: -* сколько книг прочитано; -* в каких сериях вы отстаёте (следующая книга уже вышла); -* где ждём перевод; -* какие линии закрыты. - -Это чтобы не терять нить по длинным сериям вроде Blood and Ash или -Royal Elite. - -## Важные напоминания - -* **Один вход на все сервисы** — пароль от библиотеки отдельно не нужен. -* **Книги не теряются**: библиотека резервируется вместе с остальными - сервисами (копии делаются ежедневно). -* **Доступ только у вас и администратора** — домен закрыт единым входом. - -Если что-то не работает — напишите, разберёмся. +Приятного чтения! 📖 diff --git a/ops/security/fix-email-verified.sh b/ops/security/fix-email-verified.sh new file mode 100755 index 0000000..087abb5 --- /dev/null +++ b/ops/security/fix-email-verified.sh @@ -0,0 +1,78 @@ +#!/bin/bash +# ============================================================ +# fix-email-mapping.sh — почта всегда «не проверена» +# ============================================================ +# ПРИЧИНА: в Authentik 2026.8 стандартное сопоставление области email +# возвращает email_verified ЖЁСТКО False: +# return {"email": request.user.email, "email_verified": False} +# oauth2-proxy такое не принимает и отдаёт 500 после входа. Поэтому +# «сломалось всё сразу» — после обновления Authentik. +# +# ЛЕЧЕНИЕ: заменяю выражение на True (почта хранится в самом Authentik, +# отдельной процедуры проверки у нас нет) и проверяю результат через +# userinfo. +# ============================================================ +set -uo pipefail +API=http://192.168.1.114:9000/api/v3 +TOKEN=$(cat /root/.authentik-api-token) + +echo "=== 1. НАХОЖУ СОПОСТАВЛЕНИЕ EMAIL ===" +curl -s --max-time 20 -H "Authorization: Bearer $TOKEN" "$API/propertymappings/provider/scope/?page_size=100" 2>/dev/null | python3 -c " +import json,sys +d=json.load(sys.stdin) +for m in d.get('results',[]): + if 'email' in (m.get('name') or '').lower() and 'email_verified' in (m.get('expression') or ''): + print(' pk=%s %s' % (m['pk'], m['name'])) +" 2>&1 + +PK=$(curl -s --max-time 20 -H "Authorization: Bearer $TOKEN" "$API/propertymappings/provider/scope/?page_size=100" 2>/dev/null | python3 -c " +import json,sys +d=json.load(sys.stdin) +for m in d.get('results',[]): + if 'email' in (m.get('name') or '').lower() and 'email_verified' in (m.get('expression') or ''): + print(m['pk']); break +" 2>/dev/null) + +echo +echo "=== 2. ПРАВЛЮ (pk=$PK) ===" +python3 - "$PK" <<'PY' +import json, subprocess, sys +pk = sys.argv[1] +token = open("/root/.authentik-api-token").read().strip() +new_expr = '''return { + "email": request.user.email, + "email_verified": True +}''' +body = json.dumps({"expression": new_expr}) +out = subprocess.run( + ["curl", "-s", "--max-time", "20", "-X", "PATCH", + "-H", f"Authorization: Bearer {token}", + "-H", "Content-Type: application/json", + "-d", body, + f"http://192.168.1.114:9000/api/v3/propertymappings/provider/scope/{pk}/"], + capture_output=True, text=True).stdout +try: + d = json.loads(out) + print(" результат:", "обновлено" if d.get("expression") else d) + print(" новое выражение:", (d.get("expression") or "").replace("\n", " ")[:120]) +except Exception: + print(" ответ:", out[:200]) +PY + +echo +echo "=== 3. ПРОВЕРКА ЧЕРЕЗ USERINFO ===" +SEC=$(curl -s --max-time 15 -H "Authorization: Bearer $TOKEN" --get --data-urlencode "client_id=sonarr-proxy" "$API/providers/oauth2/" | python3 -c "import json,sys;r=json.load(sys.stdin).get('results',[]);print(r[0]['client_secret'] if r else '')" 2>/dev/null) +TOK=$(curl -s --max-time 15 -X POST "https://authentik.buryans.ru/application/o/token/" -k \ + -d "grant_type=client_credentials" -d "client_id=sonarr-proxy" -d "client_secret=$SEC" -d "scope=openid email profile" 2>/dev/null | python3 -c "import json,sys;print(json.load(sys.stdin).get('access_token',''))" 2>/dev/null) +curl -s --max-time 15 -k -H "Authorization: Bearer $TOK" "https://authentik.buryans.ru/application/o/userinfo/" 2>/dev/null | head -c 300 | sed 's/^/ /' + +echo +echo "=== 4. ЖДУ ПРИМЕНЕНИЯ И ПРОВЕРЯЮ ЕЩЁ РАЗ ===" +sleep 5 +TOK2=$(curl -s --max-time 15 -X POST "https://authentik.buryans.ru/application/o/token/" -k \ + -d "grant_type=client_credentials" -d "client_id=sonarr-proxy" -d "client_secret=$SEC" -d "scope=openid email profile" 2>/dev/null | python3 -c "import json,sys;print(json.load(sys.stdin).get('access_token',''))" 2>/dev/null) +curl -s --max-time 15 -k -H "Authorization: Bearer $TOK2" "https://authentik.buryans.ru/application/o/userinfo/" 2>/dev/null | python3 -c " +import json,sys +d=json.load(sys.stdin) +print(' email:', d.get('email'), '| email_verified:', d.get('email_verified')) +" 2>&1