mirror of
https://github.com/osmarks/mycorrhiza.git
synced 2024-10-30 11:46:16 +00:00
41 lines
3.8 KiB
Plaintext
41 lines
3.8 KiB
Plaintext
|
# Авторизация через Телеграм
|
|||
|
|
//Эта статья предназначена для администраторов вики.//
|
|||
|
|
|
|||
|
|
Если вы хотите, можете разрешить пользователям входить на вашу вики с помощью **Телеграм**.
|
|||
|
|
|
|||
|
|
Телеграм (Telegram) – проприетарное приложение для обмена сообщениями с полмиллиарда пользователей по всему миру. Узнайте больше на [[https://telegram.org]].
|
|||
|
|
|
|||
|
|
## Настройка интеграции с Телеграм
|
|||
|
|
Чтобы включить Телеграм-авторизацию, необходимо создать Телеграм-бота и связать его с вашей вики.
|
|||
|
|
|
|||
|
|
### Создание бота
|
|||
|
|
Откройте чат с [[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]].
|
|||
|
|
* Телеграм-пользователи без @имени не смогут авторизоваться.
|
|||
|
|
* Телеграм-пользователи с именем, уже занятым на вики, также не смогут авторизоваться.
|
|||
|
|
* В целом, это экспериментальная функция. Применяйте её на свой страх и риск.
|