testing_project/Documentation: reference/reference_lua/box_session/on_auth — Russian @ Weblate: tarantool> function f ()

Zen

	English	Russian	Actions
	Define a trigger for execution during :ref:`authentication <authentication-users>`.	Определение триггера, используемого во время :ref:`аутентификации <authentication-users>`.
	The ``on_auth`` trigger function is invoked in these circumstances:	Вызов функции ``on_auth`` с триггером происходит в следующих обстоятельствах:
	The :ref:`console.connect <console-connect>` function includes an authentication check for all users except 'guest'. For this case, the ``on_auth`` trigger function is invoked after the ``on_connect`` trigger function, if and only if the connection has succeeded so far.	Функция :ref:`console.connect <console-connect>` включает в себя проверку аутентификации всех пользователей, кроме 'guest'. Вызов функции ``on_auth`` с триггером происходит после триггера ``on_connect`` только в том случае, если подключение было успешным.
	The :ref:`binary protocol <admin-security>` has a separate :ref:`authentication packet <box_protocol-authentication>`. For this case, connection and authentication are considered to be separate steps.	В :ref:`бинарном протоколе <admin-security>` есть отдельный :ref:`пакет для аутентификации <box_protocol-authentication>`. В этом случае подключение и аутентификация считаются отдельными действиям.
	Unlike other trigger types, ``on_auth`` trigger functions are invoked before the event. Therefore a trigger function like :code:`function auth_function () v = box.session.user(); end` will set :code:`v` to "guest", the user name before the authentication is done. To get the user name after the authentication is done, use the special syntax: :code:`function auth_function (user_name) v = user_name; end`	В отличие от других типов триггеров, вызов функций с триггером ``on_auth`` происходит до события. Таким образом, функция с таким триггером, как :code:`function auth_function () v = box.session.user(); end`, определит :code:`v` как "guest", то есть имя пользователя до проведения аутентификации. Чтобы получить имя пользователя после проведения аутентификации, используйте специальный синтаксис: :code:`function auth_function (user_name) v = user_name; end`
	If the trigger fails by raising an error, the error is sent to the client and the connection is closed.	Если триггер не выполняется и выдает ошибку, эта ошибка отправляется на клиент, и подключение разрывается.
	Parameters	Параметры
	function which will become the trigger function	функция, в которой будет триггер
	existing trigger function which will be replaced by trigger-function	существующая функция с триггером, которую заменит новая
	return	возвращает
	nil or function pointer	nil или указатель функции
	If the parameters are (nil, old-trigger-function), then the old trigger is deleted.	Если указаны параметры (nil, old-trigger-function), старый триггер будет удален.
	If both parameters are omitted, then the response is a list of existing trigger functions.	Если не указан ни один параметр, ответом будет список существующих функций с триггером.
	Details about trigger characteristics are in the :ref:`triggers <triggers-box_triggers>` section.	Подробная информация о характеристиках триггера находится в разделе :ref:`Триггеры <triggers-box_triggers>`.
	Example 1	Пример 1
	tarantool> function f () > x = x + 1 > end tarantool> box.session.on_auth(f)	tarantool> function f () > x = x + 1 > end tarantool> box.session.on_auth(f)
	Example 2	Пример 2
	This is a more complex example, with two server instances.	Более сложный пример с двумя экземплярами сервера.
	The first server instance listens on port 3301; its default user name is 'admin'. There are three ``on_auth`` triggers:	Первый экземпляр сервера настроен на прослушивание по порту 3301; имя пользователя по умолчанию -- 'admin'. Есть три триггера ``on_auth``:
	The first trigger has a function with no arguments, it can only look at ``box.session.user()``.	В первом триггере есть функция без аргументов, которая только смотрит на ``box.session.user()``.
	The second trigger has a function with a ``user_name`` argument, it can look at both of: ``box.session.user()`` and ``user_name``.	Во втором триггере есть функция с аргументом ``user_name``, которая может смотреть на ``box.session.user()`` и ``user_name``.
	The third trigger has a function with a ``user_name`` argument and a ``status`` argument, it can look at all three of: ``box.session.user()`` and ``user_name`` and ``status``.	В третьем триггере есть функция с аргументом ``user_name`` и аргументом ``status``, которая может смотреть на ``box.session.user()`` и ``user_name``, и``status``.
	The second server instance will connect with :ref:`console.connect <console-connect>`, and then will cause a display of the variables that were set by the trigger functions.	Второй экземпляр сервера подключится по :ref:`console.connect <console-connect>`, а затем отобразит переменные, определенные функциями с триггером.
	-- On the first server instance, which listens on port 3301 box.cfg{listen=3301} function function1() print('function 1, box.session.user()='..box.session.user()) end function function2(user_name) print('function 2, box.session.user()='..box.session.user()) print('function 2, user_name='..user_name) end function function3(user_name, status) print('function 3, box.session.user()='..box.session.user()) print('function 3, user_name='..user_name) if status == true then print('function 3, status = true, authorization succeeded') end end box.session.on_auth(function1) box.session.on_auth(function2) box.session.on_auth(function3) box.schema.user.passwd('admin')	-- На первом экземпляре сервера, прослушивание на котором настроено на порт 3301 box.cfg{listen=3301} function function1() print('function 1, box.session.user()='..box.session.user()) end function function2(user_name) print('function 2, box.session.user()='..box.session.user()) print('function 2, user_name='..user_name) end function function3(user_name, status) print('function 3, box.session.user()='..box.session.user()) print('function 3, user_name='..user_name) if status == true then print('function 3, status = true, authorization succeeded') end end box.session.on_auth(function1) box.session.on_auth(function2) box.session.on_auth(function3) box.schema.user.passwd('admin')
	-- On the second server instance, that connects to port 3301 console = require('console') console.connect('admin:admin@localhost:3301')	-- На втором экземпляре сервера, который подключается по порту 3301 console = require('console') console.connect('admin:admin@localhost:3301')
	The result looks like this:	Теперь результат выглядит следующим образом:
	function 3, box.session.user()=guest function 3, user_name=admin function 3, status = true, authorization succeeded function 2, box.session.user()=guest function 2, user_name=admin function 1, box.session.user()=guest