Ленты RSS
Kizora проверяет адрес по расписанию и публикует новые записи в канал. Поддерживаются RSS и Atom.
Когда использовать
- Новости игры или проекта в канал сервера.
- Блог студии, за которой следит сообщество.
- Релизы на сайте, у которого нет вебхука.
Перед настройкой
- Модуль Ленты включён.
- Есть канал для публикаций.
- У бота есть Отправка сообщений и Встроенные ссылки.
Как подключить
Через панель. Сервер, раздел Ленты и вебхуки: адрес, канал, интервал, шаблон сообщения.
Через Discord. Группа команд /лента-сервера: добавить, список, пауза, возобновить, удалить.
Настройки
| Настройка | Значение |
|---|---|
| Интервал проверки | По умолчанию 15 минут, от 5 минут до суток |
| Лент на сервер | До 20 |
| Записей за одну проверку | До 5 |
| Шаблон сообщения | По умолчанию заголовок и ссылка |
Ограничение «до 5 записей за проверку» защищает канал от ленты, которая выложила тридцать статей разом.
История не публикуется
Лента, подключённая сегодня, не выливает в канал двести записей за год. Первый проход запоминает, что в ней было, и молчит; публикуется то, что появилось после подключения.
Повторов не бывает
Запись узнаётся по отпечатку, а не по ссылке: ссылка меняется при переезде сайта. Одна и та же запись после смены домена опубликуется второй раз только если сменились и идентификатор, и ссылка с заголовком — а это редкость.
Отпечатки хранятся год.
Что происходит с мёртвым источником
Ошибка — не повод отключать ленту: сайт лежит десять минут в месяц. Пауза между попытками растёт — незачем ходить раз в минуту к тому, что не отвечает третий день.
После 10 неудач подряд лента отключается, и администратору говорится, почему. Её можно починить и включить снова.
Состояния ленты: активна, сломана (отключена после ошибок), на паузе (выключена вручную).
Права
- Kizora:
feeds.manage— подключать, приостанавливать, возвращать и убирать ленты, а также видеть список подключённых источников.
Ленты и входящие вебхуки разведены по разным правам намеренно. Худшее, что можно сделать чужой лентой, — отключить её или увести в другой канал. Вебхук — это секрет, которым подписывают входящие запросы, то есть учётные данные стороннего сервиса; ими распоряжается integrations.manage. Выдать человеку RSS, не выдав вместе с ними ключи от GitHub, теперь можно.
- Discord у бота: Отправка сообщений, Встроенные ссылки.
Безопасность
Kizora не ходит по внутренним адресам: localhost, приватные диапазоны и служебные адреса облаков закрыты. Разрешены только http и https, перенаправление проверяется как новый адрес, а размер ответа и время ожидания ограничены.
Подробнее — Безопасность интеграций.
Частые проблемы
- Лента подключилась и молчит. Так и должно быть до первой новой записи: история не публикуется.
- Лента отключилась сама. Десять неудач подряд; посмотрите причину в панели.
- Адрес не принимается. Он не
http/httpsили ведёт на внутренний хост.