База знаний PMTA›Блок конфигурации§ 3.3.24

<include-config>

Подключение конфигурации по HTTP с заголовками запроса

Когда за конфигурацией надо ходить с ключом

Блок делает ровно то же, что include с адресом: тянет файл конфигурации по HTTP. Разница одна и практическая — можно задать заголовки запроса.

Ради чего. Адрес в обычной форме не может содержать имя пользователя, строку запроса и якорь — то есть передать ключ доступа через него негде. Заголовок Authorization решает это, и именно его приводит примером руководство.

Место записи то же, что у include: корень файла, <source>, <domain>, <virtual-mta>, <smtp-pattern-list>. Адрес обязан быть абсолютным, со схемой http или https, без имени пользователя, строки запроса и якоря.

Заголовки узел не разбирает — только проверяет форму строки. Что именно вы передаёте и куда, остаётся на вашей ответственности.

Пример в конфигурации

# ключ доступа передаётся заголовком, а не адресом
<include-config https://10.1.2.3:4000/my/config/file>
    http-extra-headers /etc/pmta/include-config-http-headers.txt
</include-config>

Пример руководства. В файле заголовков — строки вида Authorization: 14ac5499…, по одной на строку. Тот же файл читают все, кто имеет доступ к узлу: права на него держат как на конфигурацию.

жёлтым — — имена директив, голубым — блоки. Так же они подсвечены и в тексте карточки.

Директивы блока: 1

Основа 1

http-extra-headersФайл с заголовками запроса за конфигурацией

Совместимость

PowerMTA 6.0

описана в руководстве этой версии · платформа: любая

С какой версии директива доступна, вендор указывает не для всех — здесь пометки нет. Имя встречается и в издании руководства 5.0.

⇄

Связанные записи

0 связей

Сюда ссылаются

includeGlobalТа же подгрузка по HTTP, но с возможностью задать заголовки запроса — например, авторизацию. inference

◇

Что ещё почитать

3 статьи

◇Принять, направить, доставитьПуть письма внутри узла: принять, решить куда, доставить — и между этими тремя шагами живут все настройки.◇Четыре типа значений, на которых написан весь конфигЛогическое, образец домена, регулярное выражение и промежуток времени — определены один раз в § 3.2 и дальше используются всеми директивами.◇Перезагрузка настроек против перезапуска службыКонфигурация читается при старте, дальше правки подхватываются командой перезагрузки — кроме тех директив, которые руководство помечает как требующие перезапуска.

В Хабе

Цена ошибки: обратимо: вредит, пока стоит
Сценарии: Жизненный цикл конфигурации