# 🔐 Двухфакторная аутентификация (2FA) - Подробное руководство

## Что такое 2FA?

Двухфакторная аутентификация (2FA) - это дополнительный уровень безопасности для вашего аккаунта Telegram. Помимо пароля, Telegram требует второй фактор проверки.

## 🚀 Как работает авторизация с 2FA

### Этап 1: Отправка номера телефона
```
Вы → Введите номер телефона → Бот отправляет SMS
```

### Этап 2: Ввод SMS-кода
```
Вы → Получите SMS → Введите 5-значный код
```

### Этап 3: Проверка 2FA пароля ⭐ (если включена 2FA)
```
Система → Требуется пароль 2FA
Вы → Введите пароль, который вы установили в Telegram
```

## ❌ Ошибка: "Требуется двухфакторная аутентификация"

Это означает, что в вашем аккаунте Telegram **включена 2FA**.

### Решение: Введите пароль

Когда бот просит пароль 2FA:
1. Это тот пароль, который вы установили в настройках Telegram
2. **НЕ** это SMS-код
3. **НЕ** это пароль от почты

Пароль 2FA обычно:
- От 5 до 255 символов
- Может содержать буквы, цифры, спецсимволы
- Чувствителен к регистру

### Пример
```
Бот: Требуется двухфакторная аутентификация
     Введите пароль вашего аккаунта Telegram:

Вы: MySecurePassword2024
```

## 🆘 Если забыли пароль 2FA

### Вариант 1: Использовать восстановительный код
Когда вы установили 2FA, Telegram дал вам **восстановительный код** (обычно 32 символа).

```
Бот: Требуется двухфакторная аутентификация

Вы: (введите восстановительный код вместо пароля)
```

### Вариант 2: Отключить 2FA через веб-версию
1. Откройте https://web.telegram.org/
2. Авторизуйтесь (без 2FA проверки в веб-версии)
3. Перейдите в Настройки → Приватность и безопасность → Двухфакторная аутентификация
4. Отключите 2FA
5. Повторите авторизацию в боте

### Вариант 3: Восстановить доступ
Если не можете сделать ничего из выше:
1. Напишите в поддержку Telegram
2. Восстановите доступ через SMS

## ✅ Как включить 2FA (для тех, кто хочет)

В Telegram:
1. Настройки → Приватность и безопасность
2. Двухфакторная аутентификация → Включить
3. Установите пароль (не SMS-код!)
4. **Сохраните восстановительный код в безопасном месте!**

## 📊 Типичные ошибки при вводе пароля

| Ошибка | Причина | Решение |
|--------|---------|---------|
| "Неверный пароль" | Пароль введен неправильно | Проверьте регистр, опечатки |
| "Пароль истек" | Слишком долго не вводили | Повторите авторизацию |
| "Код истек" | SMS-код действовал ~5 минут | Получите новый код, повторите |
| "Много попыток" | Много неверных попыток | Подождите 1-2 часа |

## 💡 Советы

1. **Запомните пароль 2FA** - он не вводится часто
2. **Сохраняйте восстановительный код** - только вы должны его знать
3. **Используйте надежный пароль** - минимум 8 символов
4. **Не делитесь кодами** - никто не должен просить восстановительный код

## 🔐 Безопасность в боте

Когда вы вводите пароль 2FA в бот:
- ✅ Пароль не сохраняется в базу данных
- ✅ Пароль обрабатывается только Telethon
- ✅ Пароль не логируется
- ✅ После авторизации сессия сохраняется (пароль больше не нужен)

## 📝 Полный процесс с 2FA

```
1. /start
   ↓
2. 🤖 UserBot → 🔐 Авторизация
   ↓
3. 🚀 Начать авторизацию
   ↓
4. Введите номер: +7 (999) 123-45-67
   ↓
5. 📨 SMS отправлен на ваш номер
   ↓
6. Введите SMS-код: 12345
   ↓
7. ⚠️ Требуется пароль 2FA!
   ↓
8. Введите пароль: MySecurePassword2024
   ↓
9. ✅ Авторизация успешна!
   ↓
10. UserBot готов к работе
```

## ⚡ Быстрая помощь

**Q: Где найти пароль 2FA?**
A: Это пароль, который **ВЫ установили** в Telegram. Не SMS-код, не пароль от почты.

**Q: Что если забыл?**
A: Используйте восстановительный код или выключите 2FA через веб-версию.

**Q: Можно ли не вводить пароль?**
A: Нет, если 2FA включена, пароль обязателен для авторизации.

**Q: Это опасно вводить пароль?**
A: Нет, бот обрабатывает пароль безопасно (не сохраняет, не логирует).

**Q: Нужен ли пароль при каждой авторизации?**
A: Нет, только первый раз. Дальше сессия используется автоматически.

---

**Нужна помощь? Проверьте логи бота или напишите в поддержку Telegram.**