README.md

# Интеграция WordPress с JINR SSO

Это руководство предназначено для помощи в процессе интеграции вашего сайта на WordPress с системой единого входа ОИЯИ (JINR SSO). Это позволит пользователям авторизоваться на вашем сайте, используя их учетные данные JINR.

## Тестирование и совместимость

- **Совместимост с PHP**: Подключение и функционал плагина были протестированы и подтверждены для работы с PHP версии 8.
- **WordPress**: Проверено на совместимость с WordPress версии 6.5.5.

## Инструкция по настройке

### Шаг 1: Регистрация вашего сайта в системе JINR SSO

Первым делом, вам необходимо получить `Client ID` и `Client Secret`, для этого регистрируем ваш сайт на OAuth-сервере JINR.

- Инструкции и условия регистрации описаны на [сайте JINR](https://login.jinr.ru/info.html).

### Шаг 2: Установка плагина на ваш сайт WordPress
![Пример изображения](https://git.jinr.ru/nica_modules/jinr-sso-wordpress-integration/-/raw/main/OAuth.png)

Был взят оригинальный плагин, упрощен и оптимизирован, вырезано все лишнее.
Следуйте данным шагам для установки необходимого плагина:

1. Перейдите в админ-панель WordPress и выберите раздел "Плагины".
2. Нажмите на кнопку "Добавить новый".
3. Затем нажмите на кнопку "Загрузить плагин".
4. Выберите локальный файл плагина oauth-client-for-user-authentication.zip.
5. Нажмите на кнопку "Установить сейчас".
6. После завершения установки нажмите на кнопку "Активировать плагин".

### Шаг 3: Конфигурация плагина

После установки и активации плагина необходимо перейти к его настройке:

1. Перейдите в раздел **OAuth Client** в административной панели.
2. Выполните следующие настройки:

   **Настройки OAuth клиента:**

   - **OAuth Server**: Выберите Custom OAuth
   - **App Name**: Укажите название вашего сайта
   - **Callback URL / Redirect URL**: Данный URL будет автоматически сгенерированным

   **Ключи и endpoints:**

   - **Client ID / Application ID**: Укажите полученный от JINR `Client ID`
   - **Client Secret**: Введите полученный `Client Secret`
   - **Scope**: `email,userinfo`
   - **Authorization Endpoint**: `https://login.jinr.ru/cgi-bin/authorize`
   - **Token Endpoint**: `https://login.jinr.ru/cgi-bin/token`
   - **Userinfo Endpoint**: `https://login.jinr.ru/cgi-bin/infojson`

   **Сопоставление атрибутов:**

   - **username**: Укажите `login`
   - **Email**: Укажите `mail`

### Шаг 4: Тестирование интеграции

После завершения настройки, проверьте корректность работы интеграции, попытайтесь войти через JINR SSO.

Более детальную информацию по настройке и возможным проблемам вы всегда можете найти в документации выбранного вами плагина.