digest

Посчитать хеш
Вспомогательное вычисление

Считает хеш строки по HMAC-SHA256 или SipHash с ключом — строкой (–key) или шестнадцатеричным значением (–hexkey).

Пригодится там, где значения сравнивают по хешу, — например, чтобы проверить значение, посчитанное другой системой тем же алгоритмом и ключом.

Ограничения названы в руководстве: алгоритмы и формы ключа взаимоисключающие; у SipHash ключ до 16 байт — короткий дополняется нулевыми байтами, длинный не принимается.

Главная ловушка — сравнивать с хешем другого вида. Команда печатает шестнадцатеричную строку; значение, закодированное иначе или посчитанное с другим ключом, с ней не совпадёт, даже если исходная строка та же.
Что делает Хаб. Не вызывает.
Рекомендуемые значения

Когда звать:

Вопрос Эта ли команда
HMAC-SHA256 строки с ключом да — –hmac-sha256
короткий хеш SipHash да — –siphash, ключ до 16 байт
проверить подпись письма нет
Алгоритмы, формы ключа и ограничения SipHash — из руководства (§ 6.3.32). Разбор ловушки — наш.
Пример в конфигурации
# HMAC-SHA256 и SipHash одной строки одним ключом
pmta digest --hmac-sha256 --key=secretkey port25pmta digest --siphash --key=secretkey port25
Примеры руководства: первая строка печатает 64 шестнадцатеричных знака, вторая — 16.
жёлтым — — имена директив, голубым — блоки. Так же они подсвечены и в тексте карточки.
Совместимость
PowerMTA 6.0
описана в руководстве этой версии · платформа: любая
С какой версии директива доступна, вендор указывает не для всех — здесь пометки нет. Имя встречается и в издании руководства 5.0.
Как проверить на узле
Сверить результат с примером руководства:
pmta digest --hmac-sha256 --key=secretkey port25
Руководство приводит для этой строки 614648A140A88192D375C22E606BEC922E8CFA71A5063C067E6BE7CB49C506AA; другой результат значит другой ключ или другую строку.
В Хабе
Цена ошибки
безопасно: неверное значение ничего не ломает
Сценарии
Подавление адресов · Собрать телеметрию