{"type":"doc","content":[{"type":"paragraph","content":[{"text":"Данный сценарий мы используем в том случае, если нам нужно совместить стандартные сценарии авторизации при помощи системных уведомлений и авторизацию через API. Для такого решения мы используем специальную настройку, которую можно установить на любом уровне авторизации, например, в приведенном ниже примере мы сначала авторизуем заказ в Кортеос, а потом делаем авторизацию в какой-то внешней системе при помощи API.","type":"text"}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"6016a4d9-9d70-4944-8d1f-f13b0345ae78"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"da76abc9-6d9e-486d-8caf-e65ed33fa120"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Настройка схемы авторизации","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":75.0},"content":[{"type":"media","attrs":{"width":1834,"id":"2e9ac94c-f1d4-421f-90c9-2c16eafd6609","collection":"contentId-788275","type":"file","height":823}}]},{"type":"paragraph","content":[{"text":"В этом примере, после того, как авторизация первого уровня будет пройдена по правилу одной подписи, по адресу ","type":"text"},{"text":"http://listener.corteos.ru/Home/Listen","type":"text","marks":[{"type":"link","attrs":{"href":"http://listener.corteos.ru/Home/Listen"}}]},{"text":" - можно использовать в том числе и для ваших тестов, - будет отправлен запрос такого вида:","type":"text"}]},{"type":"paragraph"},{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"{\n \"id_Complex\": 1123333,\n \"hash\": \"asda3124r4ndasdas23321aas\",\n \"id_Auth\": 1111\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"На самой странице редактирование указано описание возможных переменных:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"@id_ComplexReserve","type":"text","marks":[{"type":"strong"}]},{"text":" - номер авторизуемой командировки, предназначен для выгрузки при помощи метода SOAP API ","type":"text"},{"text":"GetReservationDetails","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/COR/pages/833721"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"@id_Authorization","type":"text","marks":[{"type":"strong"}]},{"text":" - идентификатор уровня авторизации, нужно передавать обратно при вызове метода согласования","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"@hash","type":"text","marks":[{"type":"strong"}]},{"text":" - подпись запроса для проверки целостности, следует передавать обратно при вызове метода согласования","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Использование в рабочем процессе","type":"text"}]},{"type":"paragraph","content":[{"text":"В командировке, к который применима наша схема авторизации, запускаем процесс согласования стандартным способом:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":80.0},"content":[{"type":"media","attrs":{"width":1899,"id":"f506733d-5e19-4771-b507-55948ab577a1","collection":"contentId-788275","type":"file","height":604}}]},{"type":"paragraph","content":[{"text":"Далее мы видим в списке авторизующих лиц такую запись:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":80.0},"content":[{"type":"media","attrs":{"width":1907,"id":"5fff6067-4268-424d-a5ff-f63cdf526b57","collection":"contentId-788275","type":"file","height":432}}]},{"type":"paragraph","content":[{"text":"После того, как подпись согласующего лица на первом уровне была получена, осуществляется обращение ко внешней системе через API в рамках настроенного выше процесса:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":80.0},"content":[{"type":"media","attrs":{"width":1889,"id":"6a8901c8-7178-4ea2-9ef8-8546a4a730c3","collection":"contentId-788275","type":"file","height":298}}]},{"type":"paragraph","content":[{"text":"Мы видим, что обращение к сервису произошло ровно в том момент, когда согласующее лицо согласовало командировку, если бы вместо этого произошло отклонение командировки, то обращение во внешюю систему не было бы отправлено и заказ вернулся бы в состояние черновика.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":80.0},"content":[{"type":"media","attrs":{"width":1906,"id":"06a78b26-ff18-4715-95b1-62a2456d9e61","collection":"contentId-788275","type":"file","height":470}}]},{"type":"paragraph","content":[{"text":"В указанном примере мы видим параметры, которые Кортеос передал во внешнюю систему, далее их следует использовать в веб-сервисе согласования.","type":"text"}]},{"type":"paragraph","content":[{"text":"Пример полученных в callback данных:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"{ \n \"id_Complex\": 766711, \n \"hash\": \"74829afd1d451bb43b3c5d299bd5411c\", \n \"id_Auth\": 417303 \n}","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"После получения данного уведомления можно выгрузить детали командировки при помощи метода API: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://corteos-platform.atlassian.net/wiki/spaces/COR/pages/833721"}},{"text":" ","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Веб-сервис для согласования","type":"text"}]},{"type":"paragraph","content":[{"text":"Для согласования используется веб-сервис: /PortableViews/ModComplexAuthViews/API/ComplexAuthAPI.asmx","type":"text"}]},{"type":"paragraph","content":[{"text":"WSDL: ","type":"text"},{"text":"https://jv3.corteos.ru/PortableViews/ModComplexAuthViews/API/ComplexAuthAPI.asmx?WSDL","type":"text","marks":[{"type":"link","attrs":{"href":"https://jv3.corteos.ru/PortableViews/ModComplexAuthViews/API/ComplexAuthAPI.asmx?WSDL"}}]}]},{"type":"paragraph","content":[{"text":"В сервис необходимо передать следующие поля:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start"},"content":[{"type":"media","attrs":{"width":642,"id":"08c57cd2-f51b-4971-980b-9f65a8f51bef","collection":"contentId-788275","type":"file","height":343}}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"id_Authorization ","type":"text","marks":[{"type":"strong"}]},{"text":"- ","type":"text"},{"text":"int","type":"text","marks":[{"type":"em"}]},{"text":", первичный ключ согласования, получаем из коллбэка на авторизацию(см. выше)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"IsSucceed ","type":"text","marks":[{"type":"strong"}]},{"text":"- ","type":"text"},{"text":"bool","type":"text","marks":[{"type":"em"}]},{"text":", статус согласования, true - согласовать, false - отклонить","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Comment ","type":"text","marks":[{"type":"strong"}]},{"text":"- ","type":"text"},{"text":"string","type":"text","marks":[{"type":"em"}]},{"text":", текстовое пояснение к операции, будет выведено в деталях командировки в таблице согласований","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Hash ","type":"text","marks":[{"type":"strong"}]},{"text":"- ","type":"text"},{"text":"string","type":"text","marks":[{"type":"em"}]},{"text":", подпись запроса, также получаем из коллбэка(см.выше)","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"В ответе на этот запрос мы получаем XML такого вида:","type":"text"}]},{"type":"paragraph"},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n Тест авторизации\n","type":"text"}]},{"type":"paragraph","content":[{"text":"В случае ошибки согласования мы получим SOAP Exception:","type":"text"}]},{"type":"paragraph"},{"type":"codeBlock","content":[{"text":"JavelinBL2.Exceptions.UserFriendlyException: В настоящий момент по данной командировке авторизация не проводится, поэтому Вы не можете её авторизовать.","type":"text"}]},{"type":"paragraph","content":[{"text":"Внешний вид таблицы согласований для согласованной через API командировки:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":75.0},"content":[{"type":"media","attrs":{"width":1853,"id":"69c14d71-3330-4099-b809-fec9088ea72e","collection":"contentId-788275","type":"file","height":241}}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Использование веб-сервиса из мода Авторизация командировок через API","type":"text"}]},{"type":"paragraph","content":[{"text":"Альтернативно вместо основного веб-сервиса можно использовать веб-сервис, описанный в приведенном ниже документе.","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineCard","attrs":{"url":"https://corteos-platform.atlassian.net/wiki/spaces/CD/pages/797385"}},{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"в методе мода Авторизации командировок через API есть такие параметры, которые надо заменить следующим образом:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"int ","type":"text"},{"text":"id_ComplexReserve ","type":"text","marks":[{"type":"strong"}]},{"text":"- тут передаем не id_ComplexReserve, а id_Auth из коллбэка","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"bool ","type":"text"},{"text":"authorize ","type":"text","marks":[{"type":"strong"}]},{"text":"- true или false - согласовать или отклонить","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"string ","type":"text"},{"text":"hash ","type":"text","marks":[{"type":"strong"}]},{"text":"- должен быть в специальном формате, “COMPLEXAUTH-{оригинальных хэш}”, в этом случае пойдет обращение к методу сложной авторизации","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Реализация данного сценария к коде ModExternalAuth","type":"text"}]},{"type":"codeBlock","attrs":{"language":"csharp"},"content":[{"text":"Match m = Regex.Match(hash, \"COMPLEXAUTH-(.+)\", RegexOptions.IgnoreCase);\nif (m.Success)\n{\n var svc = new ComplexAuthWS.ComplexAuthAPI();\n svc.Url = CurrentWebSite.CurrentEnvironment.CurrentWebSiteUrl + \"/PortableViews/ModComplexAuthViews/API/ComplexAuthAPI.asmx\";\n svc.Authorize(id_Authorization: id_ComplexReserve, IsSucceed: authorize, Comment: authorize ? \"согласовано\" : \"не согласовано\", Hash: m.Groups[1].Value);\n return \"ok\";\n}","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Веб-сервис для получения списка командировок, по которым была запрошена авторизация в заданный период ","type":"text"},{"text":"08.02.2022","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}},{"type":"textColor","attrs":{"color":"#ff5630"}}]},{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"Для получения списка необходимо использовать ","type":"text"},{"text":"веб-сервис:","type":"text","marks":[{"type":"strong"}]},{"text":" YourDomain/","type":"text"},{"text":"PortableViews/ModComplexAuthViews/API/ComplexAuthAPI.asmx","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"WSDL","type":"text","marks":[{"type":"strong"}]},{"text":": YourDomain/PortableViews/ModComplexAuthViews/API/ComplexAuthAPI.asmx?WSDL","type":"text"}]},{"type":"paragraph","content":[{"text":"Метод","type":"text","marks":[{"type":"strong"}]},{"text":": YourDomain/PortableViews/ModComplexAuthViews/API/ComplexAuthAPI.asmx?op=GetComplexReservesByStartAuth ","type":"text"}]},{"type":"paragraph","content":[{"text":"Параметры:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"string ","type":"text"},{"text":"Token","type":"text","marks":[{"type":"strong"}]},{"text":" – ","type":"text"},{"text":"токен клиента","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/CD/pages/798390"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DateTime ","type":"text"},{"text":"dateFrom","type":"text","marks":[{"type":"strong"}]},{"text":" – дата “с“ периода","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DateTime ","type":"text"},{"text":"dateTo","type":"text","marks":[{"type":"strong"}]},{"text":" – дата “по“ периода","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Вопросы","type":"text","marks":[{"type":"strong"}]},{"text":":","type":"text"}]},{"type":"expand","attrs":{"title":"ПОЧЕМУ ПУСТОЙ ОТВЕТ ПРИ ЗАПРОСЕ С АГЕНТСКИМ ТОКЕНОМ?"},"content":[{"type":"paragraph","content":[{"text":"Это клиентское api, поэтому для работы необходимо использовать клиентский токен","type":"text"}]}]},{"type":"expand","attrs":{"title":"КАК ПОД АГЕНТОМ ПОЛУЧИТЬ СПИСОК КОМАНИДРОВОК?"},"content":[{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Получить токен для агента ","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/CD/pages/798390"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Получить клиентский контекст под агентом","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/CD/pages/705994"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Отправить запрос","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Пример запроса","type":"text","marks":[{"type":"strong"}]},{"text":":","type":"text"}]},{"type":"expand","attrs":{"title":"Пример запроса"},"content":[{"type":"codeBlock","content":[{"text":"\n \n \n 190e4bf1-****-****-971a-7e7e2dbeb415\n \n \n \n \n 2021-11-26T10:00:00\n 2021-11-26T15:00:00\n \n \n","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":100.0},"content":[{"type":"media","attrs":{"width":1088,"id":"e2694d53-dd91-4825-85ec-5bf89067e472","collection":"contentId-788275","type":"file","height":364}}]},{"type":"mediaSingle","attrs":{"layout":"center","width":100.0},"content":[{"type":"media","attrs":{"width":1215,"id":"fdf632c3-8f4e-4a0b-a2c6-aa4095141db2","collection":"contentId-788275","type":"file","height":276}}]},{"type":"paragraph"}]},{"type":"paragraph","content":[{"text":"Пример ответа","type":"text","marks":[{"type":"strong"}]},{"text":":","type":"text"}]},{"type":"expand","attrs":{"title":"Пример ответа"},"content":[{"type":"codeBlock","content":[{"text":"\n \n \n \n \n \n \n \n \n","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":100.0},"content":[{"type":"media","attrs":{"width":1088,"id":"e2694d53-dd91-4825-85ec-5bf89067e472","collection":"contentId-788275","type":"file","height":364}}]},{"type":"paragraph"}]},{"type":"paragraph","content":[{"text":"Пример ошибки","type":"text","marks":[{"type":"strong"}]},{"text":":","type":"text"}]},{"type":"expand","attrs":{"title":"Пример ошибки авторизации"},"content":[{"type":"codeBlock","content":[{"text":"\n \n \n soap:Server\n System.Web.Services.Protocols.SoapException: Серверу не удалось обработать запрос. ---> System.Exception: Авторизация по токену\nОшибка при получении контроллера бизнес-логики:\nТокен 190e4bf1-****-****-971a-7e7e2dbeb415 не найден в системе, необходимо пройти авторизацию повторно.\n\n в JavelinView3.Base.WebServices.BaseV3WebService.GetBLController(Guid token, Boolean createNewInstance) в C:\\Projects\\jv3\\JavelinView3.Base\\WebServices\\_Common\\Code\\BaseWebService.cs:строка 291\n в JavelinView3.Base.WebServices.BaseV3WebService.GetBLController(Guid token, Boolean createNewInstance) в C:\\Projects\\jv3\\JavelinView3.Base\\WebServices\\_Common\\Code\\BaseWebService.cs:строка 348\n в JavelinView3.Base.WebServices.BaseV3WebService.TryAuthFromHeaders(Boolean createNewControllerInstance) в C:\\Projects\\jv3\\JavelinView3.Base\\WebServices\\_Common\\Code\\BaseWebService.cs:строка 199\n в ModComplexAuth.PortableViews.ModComplexAuthViews.API.ComplexAuthAPI.GetComplexReservesByStartAuth(DateTime dateFrom, DateTime dateTo) в C:\\Projects\\jv3\\ModComplexAuth\\PortableViews\\ModComplexAuthViews\\API\\ComplexAuthAPI.asmx.cs:строка 81\n --- Конец трассировки внутреннего стека исключений ---\n \n \n \n","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":100.0},"content":[{"type":"media","attrs":{"width":1254,"id":"4ad17f57-cf01-45de-84a3-d90ed0f12cb2","collection":"contentId-788275","type":"file","height":365}}]},{"type":"paragraph"}]},{"type":"paragraph"}],"version":1}

Browser not supported