Что такое сообщение SAML?

SAML (Security Assertion Markup Language) 2.0 лежит в основе многих систем единого входа (SSO). Когда вы входите в приложение через поставщика удостоверений вашей компании, например Okta, Microsoft Entra ID, Google Workspace или Keycloak, приложение отправляет поставщику удостоверений запрос (AuthnRequest), а тот возвращает ответ, который сообщает, кто вы (Response с Assertion). Оба документа представлены в формате XML, но передаются в закодированном виде, поэтому в журнале сети браузера они выглядят как длинные последовательности случайных символов.

Как декодировать сообщение

Вставьте сообщение в любом из видов, в которых вы могли его получить:

  • Значение поля SAMLRequest или SAMLResponse, скопированное из вкладки сети в инструментах разработчика браузера или из расширения для отслеживания SAML.
  • Полный URL или тело формы вида SAMLResponse=…&RelayState=…, содержащее такое поле. Также отображаются RelayState и, для подписанного перенаправления, алгоритм подписи.
  • Сам XML, чтобы просмотреть его поля.

Декодер самостоятельно определяет способ кодирования:

  • Привязка HTTP-POST передаёт XML в кодировке Base64 в скрытом поле формы.
  • Привязка HTTP-Redirect сжимает XML с помощью DEFLATE, кодирует его в Base64, а затем выполняет URL-кодирование результата, чтобы его можно было поместить в ссылку. Декодер выполняет все три шага в обратном порядке.

Также обрабатываются переносы строк, Base64 для URL и знаки «плюс», преобразованные в пробелы при декодировании формы.

Что отображается

  • Привязка и параметр: способ кодирования сообщения и указание, является ли оно запросом или ответом.
  • Сообщение: поля, которые обычно проверяют при настройке или отладке SSO. Среди них — издатель (кто отправил сообщение), адрес назначения, статус (Success или ошибка, например Responder / AuthnFailed), идентификатор имени (кто вошёл в систему) и его формат, аудитория (для какого приложения предназначено утверждение) и период действия (Not before и Not on or after). Также отображаются контекст аутентификации, индекс сеанса и сведения о наличии подписи у сообщения, утверждения или URL — в случае привязки HTTP-Redirect.
  • Атрибуты: атрибуты пользователя, переданные поставщиком удостоверений, например адрес электронной почты, имя и группы, со всеми значениями каждого атрибута.
  • Декодированный XML: всё сообщение с отступами, готовое для копирования или скачивания.

Полезно знать

  • Декодер показывает, есть ли подпись, но не проверяет её: для этого нужен сертификат поставщика удостоверений, а проверка входит в обязанности поставщика услуг.
  • Зашифрованное утверждение (EncryptedAssertion) можно прочитать только с помощью закрытого ключа поставщика услуг. Поэтому декодер сообщает о его наличии, но не может показать его содержимое.
  • Время в сообщениях SAML указано в UTC. Частая причина неудачного входа — расхождение часов на серверах. В этом случае время Not before оказывается в будущем или время Not on or after уже прошло.
  • Всё происходит в вашем браузере. Вставленные данные никуда не отправляются — это важно, поскольку ответ SAML может содержать персональные данные.

Возможности

  • Декодирование сообщений HTTP-Redirect (сжатых методом DEFLATE) и HTTP-POST (Base64)
  • Принимает значения, полные URL, тела форм и обычный XML
  • Отображает издателя, статус, субъект, условия и сведения об аутентификации
  • Показывает все атрибуты и их значения
  • XML с отступами можно скопировать или скачать
  • Работает в браузере