Тикет для авторизации на сайте
Алгоритм генерации
Для генерации тикета нужно выполнить следующие шаги:
- Сгенерировать сообщение. Содержание сообщения зависит от типа тикета:
- тикет с идентификатором клиента;
- тикет с e-mail адресом;
- тикет с номером мобильного телефона; Виды сообщений в зависимости от типа тикета описаны ниже.
- Вычислить хеш от сообщения по алгоритму hmac (секретный ключ можно скопировать из точки интеграции или запросить у владельца проекта). В качестве алгоритма хэширования в hmac надо использовать sha512.
- Перевести сообщение и хеш в HEX строки. Для преобразования сообщения в массив байт использовать кодировку UTF-8. Важно, если библиотека хэширования возвращает хэш в виде HEX строки, не надо повторно кодировать ее в HEX.
- Объединение строк через символ "|": <hex строка сообщения>|<hex строка хеша>.
- MyWebSite — системное имя поля, в котором хранится идентификатор пользователя на сайте. Настраивается в системе Mindbox.
Code
Частые ошибки
- Убедитесь, что указывайте время в часовом поясе UTC+0 (минус три часа от Московского времени).
- При использовании тикета с идентификатором клиента убедитесь, что заменили ID из примера (MyWebSite) тот, который реально создан в вашем проекте Mindbox.
Сообщение для тикета c идентификатором
Сообщение следующего формата:
ExternalIdentityAuthentication|<externalIdentitySystemName>|<identity>|<дата и время в часовом поясе UTC+0 в формате yyyy-MM-dd HH:mm:ss>
- где externalIdentitySystemName — системное имя поля, в котором хранится идентификатор пользователя на сайте. Настраивается в системе Mindbox.
- identity – идентификатор клиента.
- тикет считается валидным в течение получаса с указанной в нем даты и времени.
Пример:
ExternalIdentityAuthentication|MyWebSite|1543|2015-12-10 09:12:25
Обратите внимание, что MyWebSite нужно заменить на системное имя идентификатора.
Сообщение для тикета с email-адресом
Сообщение следующего формата:
EmailAuthenticationHex|<email клиента>|<дата и время в часовом поясе UTC+0 в формате yyyy-MM-dd HH:mm:ss>
- тикет считается валидным в течение получаса с указанной в нем даты и времени
Пример:
EmailAuthenticationHex|test@mail.ru|2015-12-10 09:12:25
Сообщение для тикета с номером мобильного телефона
Сообщение следующего формата:
MobilePhoneAuthenticationHex|<номер мобильного телефона клиента>|<дата и время в часовом поясе UTC+0 в формате yyyy-MM-dd HH:mm:ss>
- тикет считается валидным в течение получаса с указанной в нем даты и времени
- номер мобильного телефона должен быть в международном формате, без знака выбора страны (+), без пробелов и дефисов.
Пример:
MobilePhoneAuthenticationHex|79000000001|2015-12-10 09:12:25
- при вводе пустой строки, будет использовано текущее значение даты и времени в часовом поясе UTC+0
Для тестирования алгоритма генерации тикета можно воспользоваться консольным приложением для сравнения результатов: DirectCrmTicketGenerator.exe