Авторизация пользователей из внешних систем - История изменений

Татьяна Машковцева в 17:07, 13 марта 2024

2024-03-13T17:07:21Z

Дмитрий Смятский в 12:31, 31 марта 2020

2020-03-31T12:31:44Z

Илья Шалетин: /* Особенности авторизации из внешних систем */

2020-02-12T14:28:59Z

‎Особенности авторизации из внешних систем

Илья Шалетин в 14:28, 12 февраля 2020

2020-02-12T14:28:23Z

Илья Шалетин в 13:52, 12 февраля 2020

2020-02-12T13:52:27Z

Илья Шалетин в 13:51, 12 февраля 2020

2020-02-12T13:51:59Z

Илья Шалетин в 13:51, 12 февраля 2020

2020-02-12T13:51:16Z

Илья Шалетин в 13:48, 12 февраля 2020

2020-02-12T13:48:45Z

Илья Шалетин в 13:48, 12 февраля 2020

2020-02-12T13:48:23Z

Илья Шалетин в 13:47, 12 февраля 2020

2020-02-12T13:47:39Z

@@ Строка 1: / Строка 1: @@
-[[Category:Функции]] [[Category:Интеграция]]
+[[Category:Функции]]
-Система Nemo позволяет обращаться к ней как базе пользователей для авторизации из других систем (например форума на сайте, собственного ПО компании и т.п)
+[[Category:Интеграция]]
-Для этого нужно сделать следующее:
+Для этого необходимо на адрес вида <syntaxhighlight lang="text" enclose="none" style="font-size: 1.2em; padding: 0 3px; background: #F0F0F0; border: 1px dashed #2F6FAB;">https://domain/api__external_authorization</syntaxhighlight> отправить POST-запрос в стандартном формате ответа об авторизуемом пользователе. При получении запроса система {{NameSystem}} обрабатывает полученные данные, авторизует пользователя и перенаправляет пользователя на страницу поиска авиабилетов. В случае неудачной авторизации, у пользователя появится возможность стандартной авторизации по номеру телефона.
-необходимо на адрес вида '''https://domain/api__external_authorization''' отправить POST-запрос в стандартном формате ответа об авторизуемом пользователе. При получении запроса система Nemo.Travel обрабатывает полученные данные, авторизует пользователя и перенаправляет пользователя на страницу поиска авиабилетов. В случае неудачной авторизации, у пользователя появится возможность стандартной авторизации по номеру телефона.
+=== Запрос передачи авторизуемого пользователя ===
-<br>
+Системе {{NameSystem}} можно передать информацию об авторизованном во внешней системе пользователе путем отправки на URL <syntaxhighlight lang="text" enclose="none" style="font-size: 1.2em; padding: 0 3px; background: #F0F0F0; border: 1px dashed #2F6FAB;">https://domain/api__external_authorization</syntaxhighlight> POST-запроса в следующем формате:
 * Пример значения параметра:
-<pre>Request
+<pre>
+{
@@ Строка 96: / Строка 93: @@
 </definitions></pre> </!-->
-* directionType не является обязательным полем и означает допустимый тип перелета (если указан параметр OW, то пользователю доступны для бронирования только OW-перелеты).
+* <syntaxhighlight lang="text" enclose="none" style="font-size: 1.2em; padding: 0 3px; background: #F0F0F0; border: 1px dashed #2F6FAB;">directionType</syntaxhighlight> не является обязательным полем и означает допустимый тип перелета (если указан параметр OW, то пользователю доступны для бронирования только OW-перелеты).
-* OrderId - номер заказа, который сделан анонимом. Данный параметр(необязательный) привяжет созданный заказ к авторизованному пользователю и сделает его владельцем, чтобы можно было далее с этими данными работать.
+* <syntaxhighlight lang="text" enclose="none" style="font-size: 1.2em; padding: 0 3px; background: #F0F0F0; border: 1px dashed #2F6FAB;">orderId</syntaxhighlight> — номер заказа, который сделан анонимом. Данный параметр(необязательный) привяжет созданный заказ к авторизованному пользователю и сделает его владельцем, чтобы можно было далее с этими данными работать.
 * Пример расчета hash на языке PHP:
 <pre>$hash = hash('sha256', $request . $salt);</pre>
-$request - значение POST-параметра из запроса, $salt - секретная строка, известная только получателю и отправителю.
+<syntaxhighlight lang="text" enclose="none" style="font-size: 1.2em; padding: 0 3px; background: #F0F0F0; border: 1px dashed #2F6FAB;">$request</syntaxhighlight> — значение POST-параметра из запроса, <syntaxhighlight lang="text" enclose="none" style="font-size: 1.2em; padding: 0 3px; background: #F0F0F0; border: 1px dashed #2F6FAB;">$salt</syntaxhighlight> — секретная строка, известная только получателю и отправителю.
-В настройках Nemo.Travel должна быть включена возможность авторизации во внешней системе и задана секретная строка.
+В настройках {{NameSystem}} должна быть включена возможность авторизации во внешней системе и задана секретная строка.
 Секретное слово для генерации хеша будет отдельно выдано специалистами технической поддержки.
-==Особенности авторизации из внешних систем==
+== Особенности авторизации из внешних систем ==
 * Привязка пользователей идет по домену. Если необходимо добавить пользователей в корневое агентство, то запросы будут идти на домен:
-'''домен_аг-ва/tests/nsa/frame.php'''
+<syntaxhighlight lang="text" enclose="none" style="font-size: 1.2em; padding: 0 3px; background: #F0F0F0; border: 1px dashed #2F6FAB;">https://domain/tests/nsa/frame.php</syntaxhighlight>.
 * Чтобы после авторизации пользователя перенаправлять его не на страницу поиска, а на любую другую выбранную страницу, необходимо указать в json после хеша домен перенаправления.
+* Авторизация пользователя происходит по его ID. Для добавления нового пользователя, которого нет в системе {{NameSystem}}, нужно также указать его ID.
 * Если данные пользователя переданы частично, они останутся без изменений до передачи новых данных.
+* Если часть данных данных отличается от имеющихся в системе {{NameSystem}}, то они перезапишутся.
-* Если часть данных данных отличается от имеющихся в системе Nemo, то они перезапишутся.
+* Если необходимо ограничить изменения пассажиров (туристов), подтянутых при авторизации, в разделе '''Управление продажами''' → '''Авиабилеты''' → '''Процессы''' → '''Форма бронирования''' можно включить настройку {{Setting|Режим работы: сотрудники авиакомпании}}. Если настройка включена и в процессе оформления заказа пользователь изменит ФИО или дату рождения подтянутого пассажира, то при попытке забронировать заказ пользователь получит ошибку «Разрешено бронирование пассажиров только из списка туристов».
 == См. также ==
-*[[Авторизация]]
+* [[Авторизация]]
-*[[Пользователь]]
+* [[Пользователь]]

@@ Строка 40: / Строка 40: @@
 "docNumber": "7844454454",
 "loyaltyNumber": "1231223213223"
-}]
+}],
 }</pre>
@@ Строка 94: / Строка 96: @@
 </definitions></pre> </!-->
 * Пример расчета hash на языке PHP:

@@ Строка 109: / Строка 109: @@
 '''домен_аг-ва/tests/nsa/frame.php'''
 Если же нужно авторизовывать пользователей для субагента, то необходимо прописать данному субагенту домен в настройках: '''Управление сайтом -> Домены и протоколы'''
- в поле: '''"Доменное имя сайта для загрузки настроек"'''
+в поле: '''Доменное имя сайта для загрузки настроек'''
 * Чтобы после авторизации пользователя перенаправлять его не на страницу поиска, а на любую другую выбранную страницу, необходимо указать в json после хеша домен перенаправления.
@@ Строка 117: / Строка 117: @@
 * Если данные пользователя переданы частично, они останутся без изменений до передачи новых данных.
 * Если часть данных данных отличается от имеющихся в системе Nemo, то они перезапишутся.
 == См. также ==
 *[[Авторизация]]
 *[[Пользователь]]

@@ Строка 11: / Строка 11: @@
 * POST - параметр
-* Пример значения параметра
+* Пример значения параметра:
 <pre>Request
@@ Строка 93: / Строка 93: @@
 </service>
 </definitions></pre> </!-->
 == См. также ==
 *[[Авторизация]]
 *[[Пользователь]]

@@ Строка 9: / Строка 9: @@
 Системе Nemo.Travel можно передать информацию об авторизованном во внешней системе пользователе путем отправки на URL https://domain/api__external_authorization POST запроса в следующем формате:
-POST - параметр
+* POST - параметр
-Пример значения параметра
+* Пример значения параметра
-request
+<pre>Request
-<pre>{
 "user": {

@@ Строка 15: / Строка 15: @@
 request
+<pre>{
 "user": {
@@ Строка 41: / Строка 41: @@
 "loyaltyNumber": "1231223213223"
 }]
+}</pre>
-<--!> <pre>?xml version ='1.0' encoding ='UTF-8' ?>
+<!--> <pre>?xml version ='1.0' encoding ='UTF-8' ?>
 <definitions name='Authorization'
   targetNamespace='http://example.org/Authorization'
@@ Строка 92: / Строка 92: @@
   </port>
 </service>
-</definitions></pre> </--!>
+</definitions></pre> </!-->
 == См. также ==
 *[[Авторизация]]
 *[[Пользователь]]

@@ Строка 4: / Строка 4: @@
 Для этого нужно сделать следующее:
-[http://hostname/authorization_reol.wsdl http://hostname/authorization_reol.wsdl]
+необходимо на адрес вида <pre>https://domain/api__external_authorization</pre> отправить POST-запрос в стандартном формате ответа об авторизуемом пользователе. При получении запроса система Nemo.Travel обрабатывает полученные данные, авторизует пользователя и перенаправляет пользователя на страницу поиска авиабилетов. В случае неудачной авторизации, у пользователя появится возможность стандартной авторизации по номеру телефона.
 <pre>?xml version ='1.0' encoding ='UTF-8' ?>