123 lines
4.2 KiB
Markdown
123 lines
4.2 KiB
Markdown
|
# 🔐 Настройка OAuth Провайдеров
|
|||
|
|
|
|||
|
|
## 🎯 Быстрая настройка для менеджера
|
|||
|
|
|
|||
|
|
### 1. Google OAuth
|
|||
|
|
|
|||
|
|
1. Перейти в [Google Cloud Console](https://console.cloud.google.com/)
|
|||
|
|
2. Создать проект или выбрать существующий
|
|||
|
|
3. **APIs & Services** → **Credentials** → **Create Credentials** → **OAuth 2.0 Client ID**
|
|||
|
|
4. **Application type**: Web application
|
|||
|
|
5. **Authorized redirect URIs**:
|
|||
|
|
- `https://v3.dscrs.site/oauth/google/callback`
|
|||
|
|
- `http://localhost:3000/oauth/google/callback` (для разработки)
|
|||
|
|
6. Скопировать **Client ID** и **Client Secret**
|
|||
|
|
|
|||
|
|
**Переменные окружения:**
|
|||
|
|
```bash
|
|||
|
|
GOOGLE_CLIENT_ID=your_google_client_id
|
|||
|
|
GOOGLE_CLIENT_SECRET=your_google_client_secret
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 2. GitHub OAuth
|
|||
|
|
|
|||
|
|
1. Перейти в [GitHub Developer Settings](https://github.com/settings/developers)
|
|||
|
|
2. **New OAuth App**
|
|||
|
|
3. **Authorization callback URL**: `https://v3.dscrs.site/oauth/github/callback`
|
|||
|
|
4. Скопировать **Client ID** и **Client Secret**
|
|||
|
|
|
|||
|
|
**Переменные окружения:**
|
|||
|
|
```bash
|
|||
|
|
GITHUB_CLIENT_ID=your_github_client_id
|
|||
|
|
GITHUB_CLIENT_SECRET=your_github_client_secret
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 3. VK OAuth
|
|||
|
|
|
|||
|
|
1. Перейти в [VK Developers](https://dev.vk.com/apps)
|
|||
|
|
2. **Создать приложение** → **Веб-сайт**
|
|||
|
|
3. **Настройки** → **Redirect URI**: `https://v3.dscrs.site/oauth/vk/callback`
|
|||
|
|
4. Скопировать **ID приложения** и **Защищённый ключ**
|
|||
|
|
|
|||
|
|
**Переменные окружения:**
|
|||
|
|
```bash
|
|||
|
|
VK_CLIENT_ID=your_vk_app_id
|
|||
|
|
VK_CLIENT_SECRET=your_vk_secure_key
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 4. Facebook OAuth
|
|||
|
|
|
|||
|
|
1. Перейти в [Facebook Developers](https://developers.facebook.com/)
|
|||
|
|
2. **My Apps** → **Create App** → **Consumer**
|
|||
|
|
3. **Facebook Login** → **Settings**
|
|||
|
|
4. **Valid OAuth Redirect URIs**: `https://v3.dscrs.site/oauth/facebook/callback`
|
|||
|
|
5. Скопировать **App ID** и **App Secret**
|
|||
|
|
|
|||
|
|
**Переменные окружения:**
|
|||
|
|
```bash
|
|||
|
|
FACEBOOK_CLIENT_ID=your_facebook_app_id
|
|||
|
|
FACEBOOK_CLIENT_SECRET=your_facebook_app_secret
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 5. Yandex OAuth
|
|||
|
|
|
|||
|
|
1. Перейти в [Yandex OAuth](https://oauth.yandex.ru/)
|
|||
|
|
2. **Создать новое приложение**
|
|||
|
|
3. **Callback URI**: `https://v3.dscrs.site/oauth/yandex/callback`
|
|||
|
|
4. **Права**: `login:info`, `login:email`, `login:avatar`
|
|||
|
|
5. Скопировать **ID** и **Пароль**
|
|||
|
|
|
|||
|
|
**Переменные окружения:**
|
|||
|
|
```bash
|
|||
|
|
YANDEX_CLIENT_ID=your_yandex_client_id
|
|||
|
|
YANDEX_CLIENT_SECRET=your_yandex_client_secret
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 🚀 Развертывание
|
|||
|
|
|
|||
|
|
### Локальная разработка
|
|||
|
|
```bash
|
|||
|
|
# .env файл
|
|||
|
|
GOOGLE_CLIENT_ID=...
|
|||
|
|
GOOGLE_CLIENT_SECRET=...
|
|||
|
|
GITHUB_CLIENT_ID=...
|
|||
|
|
GITHUB_CLIENT_SECRET=...
|
|||
|
|
# и т.д.
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### Продакшн (Dokku/Heroku)
|
|||
|
|
```bash
|
|||
|
|
# Установка переменных окружения
|
|||
|
|
dokku config:set myapp GOOGLE_CLIENT_ID=xxx GOOGLE_CLIENT_SECRET=yyy
|
|||
|
|
# или
|
|||
|
|
heroku config:set GOOGLE_CLIENT_ID=xxx GOOGLE_CLIENT_SECRET=yyy
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## ✅ Проверка настройки
|
|||
|
|
|
|||
|
|
1. Перезапустить приложение
|
|||
|
|
2. Проверить логи: `OAuth provider google: id=SET, key=SET`
|
|||
|
|
3. Тестовый вход: `https://v3.dscrs.site/oauth/google`
|
|||
|
|
|
|||
|
|
## 🔍 Диагностика проблем
|
|||
|
|
|
|||
|
|
**Ошибка "Provider not configured":**
|
|||
|
|
- Проверить переменные окружения
|
|||
|
|
- Убедиться что значения не пустые
|
|||
|
|
- Перезапустить приложение
|
|||
|
|
|
|||
|
|
**Ошибка redirect_uri_mismatch:**
|
|||
|
|
- Проверить точное соответствие URL в настройках провайдера
|
|||
|
|
- Убедиться что протокол (http/https) совпадает
|
|||
|
|
|
|||
|
|
**VK ошибка "Code challenge method is unsupported":**
|
|||
|
|
- Это нормально, VK не поддерживает PKCE
|
|||
|
|
- Система автоматически обрабатывает это
|
|||
|
|
|
|||
|
|
## 📞 Поддержка
|
|||
|
|
|
|||
|
|
При проблемах проверить:
|
|||
|
|
1. Логи приложения при запуске
|
|||
|
|
2. Настройки redirect URI у провайдера
|
|||
|
|
3. Корректность переменных окружения
|