1
0
mirror of https://github.com/osmarks/mycorrhiza.git synced 2024-12-14 06:10:26 +00:00
mycorrhiza/help/ru/telegram.myco

41 lines
3.8 KiB
Plaintext
Raw Normal View History

2021-09-06 17:46:34 +00:00
# Авторизация через Телеграм
//Эта статья предназначена для администраторов вики.//
Если вы хотите, можете разрешить пользователям входить на вашу вики с помощью **Телеграм**.
Телеграм (Telegram) — проприетарное приложение для обмена сообщениями с полмиллиарда пользователей по всему миру. Узнайте больше на [[https://telegram.org]].
2021-09-06 17:46:34 +00:00
## Настройка интеграции с Телеграм
Чтобы включить Телеграм-авторизацию, необходимо создать Телеграм-бота и связать его с вашей вики.
### Создание бота
Откройте чат с [[https://t.me/botfather | @BotFather]], ботом для создания других ботов. Создайте в нём бота. В следующих шагах вам понадобятся его имя (username) и ключ (token). Также вы можете задать его аватар, будет здорово, если он будет совпадать с логотипом вашей вики.
Создав бота, отправьте команду `/setdomain` и пропишите домен вашей вики.
Вам не нужно будет //размещать// этого бота. Достаточно лишь того, что он будет создан в BotFather. Вы также можете переиспользовать ранее созданного бота.
### Конфигурация
В секции `[Telegram]` файла `config.ini` впишите имя бота (без @) и его ключ:
```
[Telegram]
TelegramBotName = your_bot
TelegramBotToken = 0000000000:AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
```
Затем перезагрузите вики.
Если обе опции прописаны, движок включит авториазцию через Telegram.
## Использование
На страницах входа и регистрации появится синяя кнопка. После её нажатия пользователю предложат связаться с вашим ботом, чтобы подтвердить авторизацию. Имя пользователя в Телеграм (@username) будет переиспользовано в качестве имени в вики. По умолчанию пользователи Телеграм принадлежат к группе //редакторов (editor)//. Они могут использовать вики наравне с остальными.
## Ограничения
* Ваша вики должна размещаться на публичном домене или белом IP-адресе. Приватно размещённые вики (например, в localhost или локальной сети) не поддерживаются.
* Телеграм не поддерживает вики на HTTP, вы //обязаны// использовать HTTPS.
** Один из способов настроить HTTPS — использовать [[https://certbot.eff.org | certbot]] в связке с обратным прокси, например, [[https://nginx.org | nginx]].
2021-09-06 17:46:34 +00:00
* Телеграм-пользователи без @имени не смогут авторизоваться.
* Телеграм-пользователи с именем, уже занятым на вики, также не смогут авторизоваться.
* В целом, это экспериментальная функция. Применяйте её на свой страх и риск.