=== Вираж: единый вход ===
Contributors: Бюро Цифровых Технологий
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 1.2.2

Болельщик вошёл в личный кабинет «Виража» — и на сайте клуба он тоже авторизован.

== Как это работает ==

Основная схема — одна сессия на весь домен. Болельщик входит в кабинете
(`my.example.com`), CRM ставит cookie на `.example.com`, и её видят все поддомены,
включая сайт. Плагин спрашивает у CRM, кто пришёл с этой cookie
(`POST /sso/introspect`, заголовок `X-Sso-Secret`), и ставит сессию WordPress.
Выход в любом из двух мест гасит сеанс в обоих: кабинет гасит сессию в CRM,
плагин при выходе с сайта зовёт `POST /sso/revoke`.

В браузере лежит только случайный идентификатор — сам сеанс хранится на сервере CRM,
и даже там от идентификатора остаётся лишь sha256. Ключ сайта знают только два сервера.

Резервная схема — одноразовый тикет, на случай когда кабинет и сайт на разных доменах
второго уровня и общая cookie до кабинета не доходит: кабинет берёт тикет своим токеном
и отдаёт плагину (`/wp-json/virazh-sso/v1/session` или `?virazh_sso=<тикет>`),
плагин обменивает его через `POST /sso/redeem`.

== Установка ==

1. Плагины → Добавить новый → Загрузить плагин → `virazh-sso.zip` → Активировать.
2. В `wp-config.php` — до строки `require_once ABSPATH . 'wp-settings.php';`:
   `define( 'COOKIE_DOMAIN', '.example.com' );`
   Без этого сессия WordPress остаётся на одном хосте. Плагин предупредит в админке.
3. Настройки → «Вираж: единый вход»:
   * Адрес API CRM — например `https://crm.example.com/api/v1`;
   * Ключ сайта: значение `SSO_SHARED_SECRET` из CRM;
   * Доменная сессия — включена, имя cookie по умолчанию `virazh_sso`;
   * Адреса личного кабинета — нужны только для резервной схемы;
   * «Сопоставлять по email» — оставьте включённым, только если CRM проверяет адрес
     при регистрации. Иначе болельщик, указавший чужой email, получит чужой аккаунт
     на сайте. Поиск по идентификатору болельщика и телефону работает всегда.
4. Кнопка «Проверить связь с CRM» на странице настроек: она сразу скажет, принят ли ключ.
   Неверный ключ иначе выглядит как «ничего не происходит» — болельщик просто остаётся гостем.
5. Проверка: `/wp-json/virazh-sso/v1/status` показывает, кем сайт считает посетителя,
   видит ли он cookie кабинета (`identity_seen`) и какой `cookie_domain` в силе.

Ключ сайта выдаётся отдельно для каждого потребителя: у сайта свой, у магазина свой.
Если ключ утёк, в CRM отзывают именно его, а остальные продолжают работать.

== Важно про кеш ==

Мимо страничного кеша (плагин кеширования, nginx fastcgi_cache, CDN) обязаны проходить
запросы с любой из двух cookie:

* `wordpress_logged_in_*` — иначе вошедший увидит страницу гостя;
* `virazh_sso` — cookie кабинета. Без этого правила запрос не доходит до PHP, плагин
  не успевает поставить сессию, и болельщик остаётся неавторизованным.

Плагин со своей стороны помечает такие ответы `DONOTCACHEPAGE` и заголовками `no-store`,
но кеш перед PHP о них не знает, поэтому правило нужно прописать руками. Пример для nginx:

`if ($http_cookie ~* "wordpress_logged_in_|virazh_sso") { set $skip_cache 1; }`

Запросы к `/wp-json/virazh-sso/*` кешировать нельзя.

== За прокси и CDN ==

Лимит попыток входа считается по адресу посетителя. За Cloudflare или балансировщиком
все приходят с одного адреса, и лимит выбьют первые же болельщики. Разрешить плагину
верить заголовкам прокси — строкой в `wp-config.php`:

`define( 'VIRAZH_SSO_TRUST_PROXY', true );`

Берутся `CF-Connecting-IP`, `X-Real-IP`, `X-Forwarded-For` — в таком порядке. Без этой
строки заголовки игнорируются: подделать их может кто угодно.

== Хуки для темы ==

* `virazh_sso_logged_in` ($user_id, $profile) — болельщик вошёл через SSO.
* `virazh_sso_user_created` ($user_id, $profile) — создан новый пользователь сайта.

Профиль CRM лежит в метаполях: `virazh_crm_id`, `virazh_phone`, `virazh_points`,
`virazh_avatar`, `virazh_sso_last_login`.

== Changelog ==

= 1.2.2 =
* GET /status больше не отвечает logged_in=false при действующей cookie WordPress, если запрос пришёл без REST-nonce. Проверка только читает статус и не меняет авторизацию остальных методов REST.

= 1.2.1 =
* Вход по одноразовому тикету на внешнем домене больше не привязывается к недоступной доменной cookie и не сбрасывается на следующем запросе.

= 1.2.0 =
* Кнопка «Проверить связь с CRM»: видно, принят ли ключ, не дожидаясь первого болельщика.
* Ключ при вставке очищается от пробелов и невидимых символов из переписки.

= 1.1.1 =
* Страницы с cookie кабинета не попадают в страничный кеш, в readme описано правило для nginx.
* Выход через REST защищён от запроса с постороннего сайта.
* Сопоставление по email стало настройкой и учитывает признак подтверждения адреса из CRM.
* Лимит попыток умеет считать по адресу из заголовков прокси (VIRAZH_SSO_TRUST_PROXY).
* Интроспекция ждёт CRM 4 секунды вместо 8, обмен тикета — 6.
* Подсказка COOKIE_DOMAIN не ошибается на доменах вида club.co.uk.
* При удалении плагина ключ сайта и временные записи вычищаются из базы.
* Подключается файл перевода.

= 1.1.0 =
* Доменная сессия как основная схема: вход узнаётся по cookie кабинета, выход двусторонний.
* Проверка COOKIE_DOMAIN и предупреждение в админке.
* Ответ /status дополнен состоянием доменной сессии.

= 1.0.0 =
* Первая версия: обмен тикета, фоновый и ссылочный вход, выход, страница настроек.
