Аутентификация - Сценарии ExtSdk2 — различия между версиями

Материал из razgovorov.ru
Перейти к: навигация, поиск
 
(не показаны 32 промежуточные версии этого же участника)
Строка 7: Строка 7:
 
В некоторых случаях, например при первом запуске или перед отправкой большого количества документов иногда возникает желание (для упрощения алгоритма) проверить действителен ли идентификатор сессии, для этого можно использовать метод ReadCurrentUserInfo.  Который в случае если сессии не действительна, так же как и остальные методы вернет ошибку аутентификации
 
В некоторых случаях, например при первом запуске или перед отправкой большого количества документов иногда возникает желание (для упрощения алгоритма) проверить действителен ли идентификатор сессии, для этого можно использовать метод ReadCurrentUserInfo.  Который в случае если сессии не действительна, так же как и остальные методы вернет ошибку аутентификации
  
−
После успешного получения COM-объекта и подключения к модулю ExtSdk2 мы можем перейти к методам авторизации.
+
После получения COM-объекта и подключения к модулю ExtSdk2 мы можем перейти к методам авторизации. Более детальное описание находится в сценарии Подключение к ExtSdk2 через OLE.
 +
Для любой авторизации стоит использовать методы COM-объекта [[CallMethodWithoutAuth]] или [[CallMethodWithoutAuthXML]], если параметры передаются в формате xml.
 
== Аутентификация по логину паролю ==
 
== Аутентификация по логину паролю ==
−
Авторизация по логину паролю выполняется с использованием метода AuthByPassword, принимающего логин и пароль в качестве параметров. Данный метод нужно вызывать через методы COM-объекта CallMethodWithoutAuth или CallMethodWithoutAuthXML, если параметры передаются в формате xml.
+
Авторизация по логину паролю выполняется с использованием метода [[AuthByPassword_-_аутентификация_по_паролю_(ExtSdk2)|AuthByPassword]], принимающего логин и пароль в качестве параметров.
 +
=== Пример кода для авторизации по логину паролю ===
 +
<syntaxhighlight lang="python" line='line'>
  
−
=== Аутентификация по логину паролю ===
+
    ole = win32com.client.Dispatch("Tensor.SbisPluginClientCOM")
 +
 
 +
    query_id = str(uuid.uuid4())
 +
    guid_module = ole.GetModule("ExtSdk2")
 +
    module_method = "ExtSdk2.AuthByPassword"
 +
    parameters_module_method = json.dumps({"Login": "login", "Password": "password"}, ensure_ascii=True)
 +
    host = online.sbis.ru
 +
 
 +
    ole.CallMethodWithoutAuth( query_id, guid_module, module_method, parameters_module_method, host )
 +
 
 +
    json_string = ole.ReadAllObject()
 +
     
 +
</syntaxhighlight>
 +
 
 +
=== Пример успешной авторизации по логину паролю ===
 +
Параметры запроса в [[CallMethodWithoutAuth]]
 +
<source lang="json">
 +
# parameters_module_method
 +
 
 +
{
 +
  "Login": "Иванов",
 +
  "Password": "123"
 +
}
 +
</source>
 +
 
 +
Ответ
 +
<source lang="json">
 +
{
 +
  'Result': 'Yzg0NGI3MjU0NmM4NDQyNTg5MjQ4NTM0NGRiMjcwYWY',
 +
  'Stat': ...
 +
}
 +
</source>
 +
где «Yzg0NGI3MjU0NmM4NDQyNTg5MjQ4NTM0NGRiMjcwYWY» — это идентификатор сессии, используйте его при вызове остальных методов модуля ExtSdk2 через методы COM-объекта [[CallMethod|CallMethod]] и [[CallMethodXML|CallMethodXML]].
  
 
== Аутентификация по сертификату ==
 
== Аутентификация по сертификату ==
−
Для аутентификации по сертификату пользователю сначала нужно показать список сертификатов подходящих для аутентификации. Получить такой список можно при помощи метода ….  
+
Для аутентификации по сертификату пользователю сначала нужно показать список сертификатов подходящих для аутентификации. Получить такой список можно при помощи метода [[ReadCertListForAuth_-_Получить_список_сертификатов_для_аутентификации_(ExtSdk2)|ReadCertListForAuth]].
  
−
После того как пользователь выбрал сертификат для аутентификации вызывается метод AuthenticateByCertificate
+
После того как пользователь выбрал сертификат для аутентификации вызывается метод [[AuthByCert_-_аутентификация_по_сертификату_(ExtSdk2)|AuthByCert]], принимающий отпечаток сертификата, по которому необходимо авторизоваться.
  
−
Если у пользователя настроена двухфакторная аутентификация вы получите ошибку ….. . Сценарий работы с двухфакторной аутентификацией описан в этом разделе.
+
=== Пример кода для авторизации по сертификату ===
 +
<source lang="json">
 +
 
 +
    ole = win32com.client.Dispatch("Tensor.SbisPluginClientCOM")
 +
 
 +
    query_id = str(uuid.uuid4())
 +
    guid_module = ole.GetModule("ExtSdk2")
 +
    module_method = "ExtSdk2.AuthByCert"
 +
    parameters_module_method = json.dumps({"Imprint": "Отпечаток сертификата"}, ensure_ascii=True)
 +
    host = online.sbis.ru
 +
 
 +
    ole.CallMethodWithoutAuth( query_id, guid_module, module_method, parameters_module_method, host )
 +
 
 +
    json_string = ole.ReadAllObject()
 +
 
 +
</source>
 +
 
 +
=== Пример успешной авторизации по сертификату ===
 +
Параметры запроса в [[CallMethodWithoutAuth]]
 +
<source lang="json">
 +
# parameters_module_method
 +
 
 +
{
 +
  "Imprint": "Строка в 40 знаков",
 +
}
 +
</source>
 +
 
 +
Ответ
 +
<source lang="json">
 +
{
 +
  'Result': 'Yzg0NGI3MjU0NmM4NDQyNTg5MjQ4NTM0NGRiMjcwYWY',
 +
  'Stat': ...
 +
}
 +
</source>
 +
где «Yzg0NGI3MjU0NmM4NDQyNTg5MjQ4NTM0NGRiMjcwYWY» — это идентификатор сессии, используйте его при вызове остальных методов модуля ExtSdk2 через методы COM-объекта [[CallMethod|CallMethod]] и [[CallMethodXML|CallMethodXML]].
  
 
==Аутентификация по токену==
 
==Аутентификация по токену==
 +
Для авторизации по токену необходимо сначала получить [https://sbis.ru/help/integration/api/auth/service?tb=tab1 токен] от администратора интересующего аккаунта.
  
−
==Аутентификация по тикету==
+
После получения токена вызывается метод [[AuthByToken_-_аутентификация_по_токену_(ExtSdk2)|AuthByToken]].
 +
 
 +
=== Пример кода для авторизации по токену===
 +
<source lang="json">
 +
 
 +
    ole = win32com.client.Dispatch("Tensor.SbisPluginClientCOM")
 +
 
 +
    query_id = str(uuid.uuid4())
 +
    guid_module = ole.GetModule("ExtSdk2")
 +
    module_method = "ExtSdk2.AuthByToken"
 +
    parameters_module_method = json.dumps({"Token": "токен"}, ensure_ascii=True)
 +
    host = online.sbis.ru
 +
 
 +
    ole.CallMethodWithoutAuth( query_id, guid_module, module_method, parameters_module_method, host )
 +
 
 +
    json_string = ole.ReadAllObject()
 +
</source>
 +
 
 +
=== Пример успешной авторизации по токену===
 +
Параметры запроса в CallMethodWithoutAuth
 +
<source lang="json">
 +
# parameters_module_method
 +
 
 +
{
 +
  "Token": "taMjS16IMM3RMWg0STDD0UBRDc0CN5TVnjQbIoZT6NdtUbAtkLZ4lTVYhJYRx5IMzR3wlNEYEMSm1M5sMNjWjfuA3QpZjMkht57DWqntTNj2UkMTpSuE4FEF",
 +
}
 +
</source>
 +
 
 +
Ответ
 +
<source lang="json">
 +
{
 +
  'Result': 'Yzg0NGI3MjU0NmM4NDQyNTg5MjQ4NTM0NGRiMjcwYWY',
 +
  'Stat': ...
 +
}
 +
</source>
 +
где «Yzg0NGI3MjU0NmM4NDQyNTg5MjQ4NTM0NGRiMjcwYWY» — это идентификатор сессии, используйте его при вызове остальных методов модуля ExtSdk2 через методы COM-объекта [[CallMethod|CallMethod]] и [[CallMethodXML|CallMethodXML]].
  
 
==Двухфакторная аутентификация ==  
 
==Двухфакторная аутентификация ==  
 +
Если у пользователя настроена двухфакторная аутентификация вы получите ошибку вида json
 +
<source lang="json">
 +
{
 +
  'code': 303,
 +
  'detail': 'Требуется подтверждение действия',
 +
  'dump': {
 +
    'MethodToValidate': 'САП.AuthenticateExPart2',
 +
    'ResourceID': '3a23a986-3b0f-4763-89a5-519f7da8a271',
 +
    'SessionID': '00610413-006104f7-eeba-fbd5a09730f7eaba'
 +
  },
 +
  ...
 +
}
 +
</source>
 +
 +
Необходимые данные лежат в dump ошибки, из которого нужно взять все три поля.
 +
 +
Далее следует вызвать метод [[AuthSendCode_-_Отправить_пользователю_код_подтверждения_(ExtSdk2)|AuthSendCode]], принимающий на вход ResourceID и SessionID и возвращающий ResourceID, который следует сравнить с имеющимся.
 +
=== Пример кода для AuthSendCode===
 +
<source lang="json">
 +
 +
    query_id = str(uuid.uuid4())
 +
    guid_module = ole.GetModule("ExtSdk2")
 +
    module_method = "ExtSdk2.AuthSendCode"
 +
    parameters_module_method = json.dumps({"ResourceID": "3a23a986-3b0f-4763-89a5-519f7da8a271", "SessionID": 00610413-006104f7-eeba-fbd5a09730f7eaba}, ensure_ascii=True)
 +
    host = online.sbis.ru
 +
 +
    ole.CallMethodWithoutAuth( query_id, guid_module, module_method, parameters_module_method, host )
 +
 +
    json_string = ole.ReadAllObject()
 +
</source>
 +
 +
=== Пример успешного вызова AuthSendCode ===
 +
<source lang="json">
 +
# parameters_module_method
 +
 +
{
 +
  "ResourceID": "3a23a986-3b0f-4763-89a5-519f7da8a271",
 +
  "SessionID": "00610413-006104f7-eeba-fbd5a09730f7eaba"
 +
}
 +
</source>
 +
 +
Ответ
 +
<source lang="json">
 +
{
 +
  'Result': '3a23a986-3b0f-4763-89a5-519f7da8a271',
 +
  'Stat': ...
 +
}
 +
</source>
 +
 +
В Result лежит исходный ResourceID
 +
 +
При успешном выполнении [[AuthSendCode_-_Отправить_пользователю_код_подтверждения_(ExtSdk2)|AuthSendCode]] и получении кода аутентификации по SMS необходимо вызвать метод [[AuthConfirmCode_-_подтвердить_код_двухфакторной_аутентификации_(ExtSdk2)|AuthConfirmCode]], принимающий json-объект с кодом, ResourceID и MethodToValidate, который будет вызван в последствии.
 +
 +
=== Пример кода для AuthConfirmCode===
 +
<source lang="json">
 +
 +
    query_id = str(uuid.uuid4())
 +
    guid_module = ole.GetModule("ExtSdk2")
 +
    module_method = "ExtSdk2.AuthConfirmCode"
 +
    parameters_module_method = json.dumps({"Param": { "Код": "пришедший код", "Идентификатор": "3a23a986-3b0f-4763-89a5-519f7da8a271", "ВызываемыйМетод": "САП.AuthenticateExPart2" } }, ensure_ascii=True)
 +
    host = online.sbis.ru
 +
 +
    ole.CallMethodWithoutAuth( query_id, guid_module, module_method, parameters_module_method, host )
 +
 +
    json_string = ole.ReadAllObject()
 +
</source>
 +
 +
=== Пример успешного вызова AuthConfirmCode===
 +
<source lang="json">
 +
# parameters_module_method
  
 +
{
 +
  "Param": {
 +
      "Код": "пришедший код",
 +
      "Идентификатор": "3a23a986-3b0f-4763-89a5-519f7da8a271",
 +
      "ВызываемыйМетод": "САП.AuthenticateExPart2"
 +
  }
 +
}
 +
</source>
  
 +
Ответ
 +
<source lang="json">
 +
{
 +
  'Result': 'Yzg0NGI3MjU0NmM4NDQyNTg5MjQ4NTM0NGRiMjcwYWY',
 +
  'Stat': ...
 +
}
 +
</source>
 +
где «Yzg0NGI3MjU0NmM4NDQyNTg5MjQ4NTM0NGRiMjcwYWY» — это идентификатор сессии, используйте его при вызове остальных методов модуля ExtSdk2 через методы COM-объекта [[CallMethod|CallMethod]] и [[CallMethodXML|CallMethodXML]].
  
 
[[Категория:Сценарии ExtSdk2]]
 
[[Категория:Сценарии ExtSdk2]]

Текущая версия на 15:47, 14 февраля 2022

Для получения доступа к методам API требуется аутентифицироваться. Количество активных сессий у пользователя и аккаунта ограничено, поэтому Вам нужно аккуратно подойти к вопросу аутентификации. Например, не нужно аутентифицироваться перед каждым запросом.

СБИС поддерживает несколько способов аутентификации (по логину паролю, по сертификату), все они равнозначные и Вы можете воспользоваться любым из них. В результате успешной аутентификации Вы получите строку с идентификатором сессии, которую нужно сохранить и использовать при работе с API до тех пор пока не получите ошибку аутентификации.

Общая стратегия аутентификации следующая – Если у Вас есть сохраненный идентификатор сессии, то начинаете работу – делаете вызовы. Методы аутентификации Вы вызываете, если у Вас нет идентификатора сессии или если вы получили ошибку аутентификации.

В некоторых случаях, например при первом запуске или перед отправкой большого количества документов иногда возникает желание (для упрощения алгоритма) проверить действителен ли идентификатор сессии, для этого можно использовать метод ReadCurrentUserInfo. Который в случае если сессии не действительна, так же как и остальные методы вернет ошибку аутентификации

После получения COM-объекта и подключения к модулю ExtSdk2 мы можем перейти к методам авторизации. Более детальное описание находится в сценарии Подключение к ExtSdk2 через OLE. Для любой авторизации стоит использовать методы COM-объекта CallMethodWithoutAuth или CallMethodWithoutAuthXML, если параметры передаются в формате xml.

Аутентификация по логину паролю

Авторизация по логину паролю выполняется с использованием метода AuthByPassword, принимающего логин и пароль в качестве параметров.

Пример кода для авторизации по логину паролю

    ole = win32com.client.Dispatch("Tensor.SbisPluginClientCOM")

    query_id = str(uuid.uuid4())
    guid_module = ole.GetModule("ExtSdk2")
    module_method = "ExtSdk2.AuthByPassword"
    parameters_module_method = json.dumps({"Login": "login", "Password": "password"}, ensure_ascii=True)
    host = online.sbis.ru

    ole.CallMethodWithoutAuth( query_id, guid_module, module_method, parameters_module_method, host )

    json_string = ole.ReadAllObject()

Пример успешной авторизации по логину паролю

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

# parameters_module_method

{
   "Login": "Иванов",
   "Password": "123"
}

Ответ 

{
  'Result': 'Yzg0NGI3MjU0NmM4NDQyNTg5MjQ4NTM0NGRiMjcwYWY',
  'Stat': ...
}

где «Yzg0NGI3MjU0NmM4NDQyNTg5MjQ4NTM0NGRiMjcwYWY» — это идентификатор сессии, используйте его при вызове остальных методов модуля ExtSdk2 через методы COM-объекта CallMethod и CallMethodXML.

Аутентификация по сертификату

Для аутентификации по сертификату пользователю сначала нужно показать список сертификатов подходящих для аутентификации. Получить такой список можно при помощи метода ReadCertListForAuth.

После того как пользователь выбрал сертификат для аутентификации вызывается метод AuthByCert, принимающий отпечаток сертификата, по которому необходимо авторизоваться.

Пример кода для авторизации по сертификату

    ole = win32com.client.Dispatch("Tensor.SbisPluginClientCOM")

    query_id = str(uuid.uuid4())
    guid_module = ole.GetModule("ExtSdk2")
    module_method = "ExtSdk2.AuthByCert"
    parameters_module_method = json.dumps({"Imprint": "Отпечаток сертификата"}, ensure_ascii=True)
    host = online.sbis.ru

    ole.CallMethodWithoutAuth( query_id, guid_module, module_method, parameters_module_method, host )

    json_string = ole.ReadAllObject()

Пример успешной авторизации по сертификату

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

# parameters_module_method

{
   "Imprint": "Строка в 40 знаков",
}

Ответ 

{
  'Result': 'Yzg0NGI3MjU0NmM4NDQyNTg5MjQ4NTM0NGRiMjcwYWY',
  'Stat': ...
}

где «Yzg0NGI3MjU0NmM4NDQyNTg5MjQ4NTM0NGRiMjcwYWY» — это идентификатор сессии, используйте его при вызове остальных методов модуля ExtSdk2 через методы COM-объекта CallMethod и CallMethodXML.

Аутентификация по токену

Для авторизации по токену необходимо сначала получить токен от администратора интересующего аккаунта.

После получения токена вызывается метод AuthByToken.

Пример кода для авторизации по токену

    ole = win32com.client.Dispatch("Tensor.SbisPluginClientCOM")

    query_id = str(uuid.uuid4())
    guid_module = ole.GetModule("ExtSdk2")
    module_method = "ExtSdk2.AuthByToken"
    parameters_module_method = json.dumps({"Token": "токен"}, ensure_ascii=True)
    host = online.sbis.ru

    ole.CallMethodWithoutAuth( query_id, guid_module, module_method, parameters_module_method, host )

    json_string = ole.ReadAllObject()

Пример успешной авторизации по токену

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

# parameters_module_method

{
   "Token": "taMjS16IMM3RMWg0STDD0UBRDc0CN5TVnjQbIoZT6NdtUbAtkLZ4lTVYhJYRx5IMzR3wlNEYEMSm1M5sMNjWjfuA3QpZjMkht57DWqntTNj2UkMTpSuE4FEF",
}

Ответ 

{
  'Result': 'Yzg0NGI3MjU0NmM4NDQyNTg5MjQ4NTM0NGRiMjcwYWY',
  'Stat': ...
}

где «Yzg0NGI3MjU0NmM4NDQyNTg5MjQ4NTM0NGRiMjcwYWY» — это идентификатор сессии, используйте его при вызове остальных методов модуля ExtSdk2 через методы COM-объекта CallMethod и CallMethodXML.

Двухфакторная аутентификация

Если у пользователя настроена двухфакторная аутентификация вы получите ошибку вида json 

{
  'code': 303,
  'detail': 'Требуется подтверждение действия',
  'dump': {
    'MethodToValidate': 'САП.AuthenticateExPart2',
    'ResourceID': '3a23a986-3b0f-4763-89a5-519f7da8a271',
    'SessionID': '00610413-006104f7-eeba-fbd5a09730f7eaba'
  },
  ...
}

Необходимые данные лежат в dump ошибки, из которого нужно взять все три поля.

Далее следует вызвать метод AuthSendCode, принимающий на вход ResourceID и SessionID и возвращающий ResourceID, который следует сравнить с имеющимся.

Пример кода для AuthSendCode

    query_id = str(uuid.uuid4())
    guid_module = ole.GetModule("ExtSdk2")
    module_method = "ExtSdk2.AuthSendCode"
    parameters_module_method = json.dumps({"ResourceID": "3a23a986-3b0f-4763-89a5-519f7da8a271", "SessionID": 00610413-006104f7-eeba-fbd5a09730f7eaba}, ensure_ascii=True)
    host = online.sbis.ru

    ole.CallMethodWithoutAuth( query_id, guid_module, module_method, parameters_module_method, host )

    json_string = ole.ReadAllObject()

Пример успешного вызова AuthSendCode

# parameters_module_method

{
   "ResourceID": "3a23a986-3b0f-4763-89a5-519f7da8a271",
   "SessionID": "00610413-006104f7-eeba-fbd5a09730f7eaba"
}

Ответ 

{
  'Result': '3a23a986-3b0f-4763-89a5-519f7da8a271',
  'Stat': ...
}

В Result лежит исходный ResourceID

При успешном выполнении AuthSendCode и получении кода аутентификации по SMS необходимо вызвать метод AuthConfirmCode, принимающий json-объект с кодом, ResourceID и MethodToValidate, который будет вызван в последствии.

Пример кода для AuthConfirmCode

    query_id = str(uuid.uuid4())
    guid_module = ole.GetModule("ExtSdk2")
    module_method = "ExtSdk2.AuthConfirmCode"
    parameters_module_method = json.dumps({"Param": { "Код": "пришедший код", "Идентификатор": "3a23a986-3b0f-4763-89a5-519f7da8a271", "ВызываемыйМетод": "САП.AuthenticateExPart2" } }, ensure_ascii=True)
    host = online.sbis.ru

    ole.CallMethodWithoutAuth( query_id, guid_module, module_method, parameters_module_method, host )

    json_string = ole.ReadAllObject()

Пример успешного вызова AuthConfirmCode

# parameters_module_method

{
   "Param": {
      "Код": "пришедший код",
      "Идентификатор": "3a23a986-3b0f-4763-89a5-519f7da8a271",
      "ВызываемыйМетод": "САП.AuthenticateExPart2"
   }
}

Ответ 

{
  'Result': 'Yzg0NGI3MjU0NmM4NDQyNTg5MjQ4NTM0NGRiMjcwYWY',
  'Stat': ...
}

где «Yzg0NGI3MjU0NmM4NDQyNTg5MjQ4NTM0NGRiMjcwYWY» — это идентификатор сессии, используйте его при вызове остальных методов модуля ExtSdk2 через методы COM-объекта CallMethod и CallMethodXML.

Источник — «http://wiki.razgovorov.ru/index.php?title=Аутентификация_-_Сценарии_ExtSdk2&oldid=6012»