Перейти к основному содержимому

AuthenticateConfirm (V2)

warning

Метод устарел. Рекомендуемый способ авторизации описан в инструкции Авторизация.

Метод AuthenticateConfirm возвращает авторизационный токен после аутентификации по сертификату методом Authenticate.

POST /V2/AuthenticateConfirm

Параметры запроса

  • token — строка в формате Base64, полученная после расшифровки тела ответа метода Authenticate.
  • thumbprint — отпечаток сертификата пользователя. Необязательный параметр. Если не указан, в теле запроса нужно передать сертификат пользователя в DER-кодировке.
  • saveBinding — параметр для сохранения привязки пользователя доверенного сервиса. Укажите значение true, если нужно сохранить привязку. Необязательный параметр. По умолчанию имеет значение false.

Заголовки запроса

  • Authorization — данные, необходимые для авторизации. В заголовке нужно передать DiadocAuth ddauth_api_client_id.

Тело запроса

Если параметр thumbprint не указан, тело запроса должно содержать X.509 сертификат пользователя в DER-кодировке. Иначе может быть пустым.

Коды ответа

  • 200 — операция успешно завершена.
  • 400 — данные в запросе имеют неверный формат или отсутствуют обязательные параметры.
  • 401 — в запросе отсутствует HTTP-заголовок Authorization, или в этом заголовке отсутствует параметр ddauth_api_client_id, или переданный в нем ключ разработчика не зарегистрирован в Диадоке.
  • 403 — доступ запрещен.
  • 405 — используется неподходящий HTTP-метод.
  • 500 — при обработке запроса возникла непредвиденная ошибка.

Тело ответа

Тело ответа содержит авторизационный токен.

Если в метод передаются одновременно отпечаток сертификата и сертификат, то отпечаток сертификата имеет более высокий приоритет. В этом случае сертификат из тела запроса игнорируется.

Привязка пользователя доверенного сервиса

Сохранить привязку пользователя доверенного сервиса с пользователем Диадока можно при аутентификации по сертификату или логину и паролю. Для этого в заголовке нужно указывать ключ X-Diadoc-ServiceKey, полученный доверенным сервисом, и идентификатор пользователя в доверенном сервисе X-Diadoc-ServiceUserId.

При аутентификации по логину и паролю привязка производится автоматически. При аутентификации по сертификату автоматическая привязка не производится: для привязки укажите параметр saveBinding = true.

Оцените материал страницы

Нашли ошибку или столкнулись с проблемой?

СКБ Контурс 1988 года