/Methods/Login

<< Click to Display Table of Contents >>

Navigation:  API MasterSCADA 4D > Подключение к исполнительной системе по JSON > JSON для HTTP-запросов > Описание JSON-запросов > Общие методы >

/Methods/Login

Login - запрос на создание новой сессии пользователя.

Данные запроса

{"sessionId": <id текущей сессии>,

"login": " ", - имя пользователя

"password":" " - пароль

"reuseSession": True, - True - если задано и текущая сессия активна, то в ней заменяется пользователь, при этом сама сессия сохраняется (sessionId остается старым)

"newPassword": " ", - новый пароль. Если указан, то должна произойти смена пароля (при этом в поле password должен быть указан старый пароль/хеш пароля)

}

Данные ответа

{"code":0,

"startMnemoscheme":" ", - строковый ID стартового окна для данного оператора

"sessionId":" ", - ID созданной сессии

"groups":" " - список групп, к которым принадлежит авторизованный пользователь, созданный в RT (пустой, если авторизованный пользователь создан в DT)

}

Пример

Запрос

{"login":"sa","password":"123"}

Ответ

{

   code: 0,

   startMnemoscheme: "18095",

   sessionId: "1234",

   groups: ["Group1", "Group2"],

   rights: {

       58278: {

           rights: {},

           windows: {

               "Окно 1": {

                   rights: {

                       OpenWindow: {

                           roleName: 9 - битовая маска прав

                       },

                   },

                   elementName: "описание прав контрола",

               },

           },

       },

   },

}

Во всех следующих пакетах протокола sessionId должен передаваться как параметр запроса. В случае, если в какой-то метод протокола в параметре запроса не передал корректный sessionId (или для текущей сессии окончено время сессии), то по этому методу будет возвращен code = OpcUa_BadSessionIdInvalid (0x80250000).

При получении данного кода необходимо отобразить окно логина и заново вызвать Login.