AuthByCert - аутентификация по сертификату (ExtSdk2) — различия между версиями
(Новая страница: «== Описание == Аутентификация пользователя по сертификату == Алгоритм работы == Аутентифиц…») |
|||
(не показано 15 промежуточных версий 2 участников) | |||
Строка 4: | Строка 4: | ||
Аутентифицирует пользователя по сертификату. | Аутентифицирует пользователя по сертификату. | ||
− | В случае включенной у пользователя двухфакторной аутентификации возвращает ошибку с кодом | + | В случае включенной у пользователя двухфакторной аутентификации возвращает ошибку с кодом 303. См. раздел [[Аутентификация_-_Сценарии_ExtSdk2#Двухфакторная аутентификация|Двухфакторная аутентификация]]. |
== Параметры == | == Параметры == | ||
− | * {{Шаблон:ApiParam| | + | * {{Шаблон:ApiParam|Imprint|1|строка|отпечаток сертификата}} |
== Результат == | == Результат == | ||
Возвращает объект с идентификатором сессии, которую нужно использовать для последующих вызовов. | Возвращает объект с идентификатором сессии, которую нужно использовать для последующих вызовов. | ||
− | * {{Шаблон:ApiParam| | + | * {{Шаблон:ApiParam|Result||строка|Идентификатор сессии}} |
− | * {{Шаблон:ApiParam| | + | * {{Шаблон:ApiParam|Stat||объект|[[Stat_-_ExtSdk2_Объект|статистика времени выполнения операции]]}} |
== Исключения == | == Исключения == | ||
== Пример успешного вызова == | == Пример успешного вызова == | ||
− | ===Запрос=== | + | ====Запрос==== |
<source lang="json"> | <source lang="json"> | ||
+ | { | ||
+ | "Imprint": отпечаток сертификата | ||
+ | } | ||
</source> | </source> | ||
− | ===Ответ=== | + | ====Ответ==== |
<source lang="json"> | <source lang="json"> | ||
+ | { | ||
+ | 'Result': 'Yzg0NGI3MjU0NmM4NDQyNTg5MjQ4NTM0NGRiMjcwYWY', | ||
+ | 'Stat': ... | ||
+ | } | ||
</source> | </source> | ||
+ | где «Yzg0NGI3MjU0NmM4NDQyNTg5MjQ4NTM0NGRiMjcwYWY» — это идентификатор сессии, используйте его при вызове остальных методов модуля ExtSdk2 через методы COM-объекта [[CallMethod|CallMethod]] и [[CallMethodXML|CallMethodXML]]. | ||
==Пример ответа при включенной двухфакторной аутентификации== | ==Пример ответа при включенной двухфакторной аутентификации== | ||
<source lang="json"> | <source lang="json"> | ||
+ | { | ||
+ | 'code': 303, | ||
+ | 'detail': 'Требуется подтверждение действия', | ||
+ | 'dump': { | ||
+ | 'MethodToValidate': 'САП.AuthenticateByCertificatePart2', | ||
+ | 'ResourceID': '3a23a986-3b0f-4763-89a5-519f7da8a271', | ||
+ | 'SessionID': '00610413-006104f7-eeba-fbd5a09730f7eaba' | ||
+ | }, | ||
+ | ... | ||
+ | } | ||
</source> | </source> | ||
+ | |||
+ | [[Категория:Методы ExtSdk2]] |
Текущая версия на 10:23, 14 июля 2021
Содержание
Описание
Аутентификация пользователя по сертификату
Алгоритм работы
Аутентифицирует пользователя по сертификату.
В случае включенной у пользователя двухфакторной аутентификации возвращает ошибку с кодом 303. См. раздел Двухфакторная аутентификация.
Параметры
- Imprint ! (строка) - отпечаток сертификата
Результат
Возвращает объект с идентификатором сессии, которую нужно использовать для последующих вызовов.
- Result (строка) - Идентификатор сессии
- Stat (объект) - статистика времени выполнения операции
Исключения
Пример успешного вызова
Запрос
{
"Imprint": отпечаток сертификата
}
Ответ
{
'Result': 'Yzg0NGI3MjU0NmM4NDQyNTg5MjQ4NTM0NGRiMjcwYWY',
'Stat': ...
}
где «Yzg0NGI3MjU0NmM4NDQyNTg5MjQ4NTM0NGRiMjcwYWY» — это идентификатор сессии, используйте его при вызове остальных методов модуля ExtSdk2 через методы COM-объекта CallMethod и CallMethodXML.
Пример ответа при включенной двухфакторной аутентификации
{
'code': 303,
'detail': 'Требуется подтверждение действия',
'dump': {
'MethodToValidate': 'САП.AuthenticateByCertificatePart2',
'ResourceID': '3a23a986-3b0f-4763-89a5-519f7da8a271',
'SessionID': '00610413-006104f7-eeba-fbd5a09730f7eaba'
},
...
}