|
3.2.2.3. Метод CloudCertificateLogin
|
|
|
Метод CloudCertificateLogin принимает запрос в формате JSON в кодировке UTF8 и возвращает маркер временного доступа, зашифрованный с помощью ключа, сертификат которого передан в запросе.
После расшифровки с помощью закрытого ключа доверенного сертификата этот маркер следует записывать в обязательное поле Assistant-Key заголовка HTTP-запроса при вызове других методов Такском-Доклайнз Web API.
Формат данных для тела запроса:
{
Certificate: {
Thumbprint: "%ОТПЕЧАТОК СЕРТИФИКАТА%",
Pin: "%ПИН-КОД СЕРТИФИКАТА (опционально)%"
},
CloudCryptoService: {
Login: "%ЛОГИН СЕРВИСА ОБЛАЧНОЙ КРИПТОГРАФИИ%",
Password: "%ПАРОЛЬ СЕРВИСА ОБЛАЧНОЙ КРИПТОГРАФИИ%"
},
TrustedCertificate:[%ТЕЛО ДОВЕРЕННОГО СЕРТИФИКАТА (массив байт)%]
}
Время действия маркера составляет 2 минуты, считая от момента его получения или последнего использования в запросе. При использовании в запросе просроченного маркера доступа будет получена ошибка HTTP с кодом 401.
При вызове метода CloudCertificateLogin новый маркер доступа не создаётся, если не закончился срок действия предыдущего маркера.
HTTP-запрос
HTTP-Method: POST
|
Адрес запроса (URI)
| |
|
https://<server>.taxcom.ru/v<version>/API/CloudCertificateLogin
| |
|
Заголовок запроса
| |
|
Integrator-Id
|
Идентификатор интеграционного решения. Формат этого идентификатора:
COMPANY_AAAAAAAA-AAAA-AAAA-AAAA-AAAAAAAAAAAA
|
|
Тело запроса
| |
|
Данные в формате JSON в кодировке UTF8:
{
Certificate: {
Thumbprint: "%ОТПЕЧАТОК СЕРТИФИКАТА%",
Pin: "%ПИН-КОД СЕРТИФИКАТА (опционально)%"
},
CloudCryptoService: {
Login: "%ЛОГИН СЕРВИСА ОБЛАЧНОЙ КРИПТОГРАФИИ%",
Password: "%ПАРОЛЬ СЕРВИСА ОБЛАЧНОЙ КРИПТОГРАФИИ%"
},
TrustedCertificate:[%ТЕЛО ДОВЕРЕННОГО СЕРТИФИКАТА (массив байт)%]
}
| |
При использовании метода CloudCertificateLogin авторизация проходит в два этапа. После получения и расшифровки токена на клиенте необходимо вызвать метод ActivateSession, записав в поле Assistant-Key расшифрованный маркер доступа.
После активации сессии, взаимодействие с Web API проводится аналогично взаимодействию с использованием локальных сертификатов.