Исправлен 500 на всех сервисах: Authentik 2026.8 отдавал email_verified=false

СИМПТОМ: после ввода пароля любой сервис с единым входом отдавал 500.
Прямые адреса работали, службы живы, Authentik писал вход успешным.

ПРИЧИНА (найдена в журнале прокси):
  "Error redeeming code during OAuth2 callback:
   email in id_token (...) isn't verified"
В Authentik 2026.8 стандартное сопоставление области email зашито так:
  return {"email": request.user.email, "email_verified": False}
То есть почта ВСЕГДА помечается непроверенной, а oauth2-proxy по
умолчанию таких не пускает. В 2026.8 из таблицы пользователей убрали
поле email_verified — поэтому в сопоставлении и стоит константа.
Это следствие сегодняшнего обновления Authentik, а не правок прокси.

ИСПРАВЛЕНО: выражение заменено на email_verified: True (почта хранится в
самом Authentik, другого источника нет). Проверено: userinfo отдаёт true.

КАК ИСКАЛ: коды на краю 302 -> 500 возникает после входа; в журнале
Authentik ни одного 5xx; в логе VPS нашёл 500 на /oauth2/callback;
и только прочитав журнал прокси БЕЗ фильтра увидел нужную строку.
Ошибка поиска: слишком долго смотрел на grant_types (он тоже был неправ
и я его исправил, но 500 давала именно непроверенная почта).

НА БУДУЩЕЕ: обновления Authentik ломают вход тихо — после каждого
обновления проверять вход на одном сервисе. Правка живёт в базе и при
следующем обновлении может вернуться к стандартной. Проверка в документе.

ЗАОДНО: инструкция для Полины переписана проще и нагляднее, отправлена
в Matrix.
This commit is contained in:
root committed 2026-10-18 21:05:50 +03:00
1 parent 60866cd2b6
commit 2807bc815f
4 files changed
+249 -72

No files matched your search

+89
View File
@@ -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`.
+4 -2
View File
@@ -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 | Все службы шлют через общий слой | 🔶 частично |
+78 -70
View File
@@ -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.
## Важные напоминания
* **Один вход на все сервисы** — пароль от библиотеки отдельно не нужен.
* **Книги не теряются**: библиотека резервируется вместе с остальными
сервисами (копии делаются ежедневно).
* **Доступ только у вас и администратора** — домен закрыт единым входом.
Если что-то не работает — напишите, разберёмся.
Приятного чтения! 📖
+78
View File
@@ -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