Хешировать значение

Некоторые сервисы требуют передавать электронную почту, номер телефона или другие идентификаторы не в исходном виде.

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

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

Когда использовать инструмент

Используйте инструмент «Хешировать значение», если внешний сервис ожидает получить хеш вместо исходного значения.

Чаще всего он используется в следующих сценариях:

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

Если сервис ожидает получить исходное значение, использовать хеширование не нужно.

Как работает инструмент

Инструмент получает значение из предыдущего шага связки и применяет к нему выбранный алгоритм хеширования.

Процесс выглядит так: Исходное значение → алгоритм хеширования → результат.

После хеширования результат можно сразу использовать в HTTP-запросе, вебхуке или любом следующем шаге связки.

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

Поля инструмента

Алгоритм

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

Чаще всего используются:

• sha256 — современный и наиболее распространенный алгоритм, который поддерживают многие сервисы и платформы;
• md5 — встречается в некоторых устаревших системах, вебхуках и пользовательских интеграциях;
• hmac-* — используются в случаях, когда для создания результата дополнительно требуется секретный ключ.

Если в документации сервиса указан конкретный алгоритм, используйте именно его. Иначе результат может не пройти проверку или не совпасть с ожидаемым значением.

Значение

Данные, которые необходимо преобразовать.

Это может быть:

• значение из триггера;
• результат другого инструмента;
• строка, подготовленная на предыдущем шаге автоматизации.

Соль перед значением

Необязательный текст, который добавляется перед значением до хеширования.

Формула: hash(salt_before + value)

Обычно это поле оставляют пустым. Заполняйте его только в том случае, если это прямо указано в документации сервиса.

Соль после значения

Необязательный текст, который добавляется после значения до хеширования.

Формула: hash(value + salt_after)

Большинству интеграций это поле не требуется, однако некоторые системы используют такой способ дополнительной проверки.

Ключ

Используется только с алгоритмами HMAC.

Если вы используете обычные алгоритмы хеширования, например sha256 или md5, оставьте это поле пустым.

Пример 1. Создание проверочного значения для вебхука

В этом примере хеширование используется для проверки подлинности запроса.

Связка запускается при появлении нового лида в Битрикс24.

Затем шаг JavaScript подготавливает строку для проверки, объединяя несколько значений в один текст.

Перед созданием результата скрипт:

• удаляет лишние пробелы из имени клиента;
• оставляет в номере телефона только цифры;
• объединяет необходимые значения в одну строку.

Полученная строка передается в инструмент «Хешировать значение».

Настройка инструмента:

• Алгоритм — md5;
• Значение — stringToHash из шага JavaScript;

После этого поле «Результат» передается в исходящий HTTP-запрос.

В результате сервис на стороне получателя может проверить запрос, не получая исходное секретное значение.

Пример 2. Хеширование номера телефона перед отправкой в сервис

Еще один распространенный сценарий — передача номера телефона во внешний сервис, который принимает такие данные только в хешированном виде.

Например, связка может запускаться после появления нового клиента в CRM. Альбато получает номер телефона, приводит его к нужному формату, создает хеш с помощью алгоритма SHA-256 и передает результат в следующий шаг связки или внешний сервис.

На стороне сервиса данные обрабатываются таким же способом. Если результаты совпадают, система сможет связать событие с нужным пользователем. Благодаря этому данные точнее сопоставляются и корректно обрабатываются.

Связка может состоять из четырех шагов:

1. CRM передает данные клиента и информацию о событии.
2. Инструмент «Форматирование номера телефона» приводит номер к единому формату.
3. Инструмент «Хешировать значение» создает хеш с помощью алгоритма SHA-256.
4. Внешний сервис получает данные события и хешированный идентификатор.

Настройка инструмента:

• Алгоритм — sha256;
• Значение — отформатированный номер телефона из предыдущего шага.

После этого передайте поле «Результат» в следующий шаг автоматизации или в поле идентификатора пользователя в нужном сервисе. Остальные данные можно заполнить значениями из триггера и предыдущих шагов.

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

Итоги

Инструмент «Хешировать значение» позволяет автоматически преобразовывать данные в формат, который требуется внешним сервисам.

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

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