Создать ID сессии

Создать ID сессии

Создать ID сессии ​

Создаёт новую Сессию, с помощью которой можно аутентифицировать последующие запросы.

Этот запрос возвращает ID созданной сессии. ID сессии также включён в заголовке ответа Set-Cookie.

Запрос ​

HTTP Запрос ​

text
POST /node/api/users/session

Параметры пути ​

Параметры не требуются.

Параметры тела запроса ​

Вы можете создать новую сессию используя логин и пароль, токен аутентификации или внешний сервис аутентификации (например Keycloak).

Логин/Email и пароль ​

ПараметрТипОписание
loginString

обязательный | Логин или email пользователя. | | password | String

обязательный | Пароль пользователя. |

Токен аутентификации ​

ПараметрТипОписание
auth-tokenStringТокен аутентификации.

Внешний сервис аутентификации ​

ПараметрТипОписание
auth-serviceStringИмя сервиса аутентификации. Сейчас Центральный Пульт поддерживает только keycloak.
auth-service-paramsObjectПараметры аутентификации
auth-service-params.tokenObjectТокен аутентификации сервиса.

Тело запроса ​

Вы можете создать новую сессию используя логин и пароль, токен аутентификации или внешний сервис аутентификации (например Keycloak).

Login/Email and password ​

Есть у пользователя задан email, то он может использовать его вместо логина для создания Сессии:

  • Login
  • Email
json
{
    "login": "user.name",
    "password": "P665bPVi"
}
json
{
    "login": "user.email@example.com",
    "password": "P665bPVi"
}

Токен аутентификации ​

json
{
    "auth-token": <...>
}

Внешний сервис аутентификации ​

Keycloak ​
json
{
    "auth-service": "keycloak",
    "auth-service-params": {
        "token": "..."
    }
}

Ответ ​

Тело ответа содержит строку с ID созданной сессии:

text
"a5f946dc-4c21-4ccd-b78b-f0a5fce94f4d"

NOTE

ID сессии в теле ответа окружён кавычками. Это может вызывать проблемы с некоторыми запросами и потребует удалить кавычки из строки перед её использованием.

Заголовок Set-Cookie:

text
sid=6de74cf1-b0cd-4a06-9dc2-5b215c7543ef; Path=/

Пример ​

Запрос ​

Пример создания Сессии с помощью логина и пароля пользователя:

  • Bash
  • JavaScript
  • NodeJS
  • Python
bash
login=<...>
password=<...>
saymon_hostname=<...>
url=https://$saymon_hostname/node/api/users/session

curl -X POST $url \
    -H "Content-Type: application/json" \
    -d @- <<EOF
{
    "login": "$login",
    "password": "$password"
}
EOF
javascript
let login = <...>
let password = <...>
let saymonHostname = <...>
let path = "/node/api/users/session";

let headers = new Headers();
headers.append("Content-Type", "application/json");

let data = JSON.stringify({
    "login": login,
    "password": password
});

let requestOptions = {
    method: "POST",
    headers: headers,
    body: data
};

fetch(saymonHostname + path, requestOptions)
    .then(response => response.text())
    .then(result => console.log(result))
    .catch(error => console.log("error", error));
javascript
const http = require("http");

let login = <...>
let password = <...>
let saymonHostname = <...>
let path = "/node/api/users/session";

let options = {
    "method": "POST",
    "hostname": saymonHostname,
    "headers": {
      "Content-Type": "application/json"
    },
    "path": path
};

let req = http.request(options, function (res) {
    let chunks = [];

    res.on("data", function (chunk) {
        chunks.push(chunk);
    });

    res.on("end", function (chunk) {
        let body = Buffer.concat(chunks);
        console.log(body.toString());
    });

    res.on("error", function (error) {
        console.error(error);
    });
});

let data = JSON.stringify({
    login: login,
    password: password
});

req.write(data);
req.end();
python
import requests

login = <...>
password = <...>
saymon_hostname = <...>
url = "https://" + saymon_hostname + "/node/api/users/session"
body = {"login": login, "password": password}

response = requests.request("POST", url, json=body)
session_id = response.text
print(session_id)

После создания Сессии, её ID нужно передавать в заголовке Cookie для аутентификации последующих запросов. Пример ниже демонстрирует как это сделать с запросом Получить текущего пользователя:

  • Bash
  • JavaScript
  • NodeJS
  • Python
bash
session_id=<...>
saymon_hostname=<...>
url=https://$saymon_hostname/node/api/users/current

curl -X GET $url -H "Cookie: sid=$session_id"
javascript
let sessionId = <...>
let saymonHostname = <...>
let path = "/node/api/users/current";

let headers = new Headers();
headers.append("Cookie", "sid=" + sessionId);

let requestOptions = {
    method: "GET",
    headers: headers
};

fetch(saymonHostname + path, requestOptions)
    .then(response => response.text())
    .then(result => console.log(result))
    .catch(error => console.log("error", error));
javascript
const http = require("http");

let sessionId = <...>
let saymonHostname = <...>
let path = "/node/api/users/current";

let options = {
    "method": "GET",
    "hostname": saymonHostname,
    "headers": {
        "Cookie": "sid=" + sessionId
    },
    "path": path
};

let req = http.request(options, function (res) {
    let chunks = [];

    res.on("data", function (chunk) {
        chunks.push(chunk);
    });

    res.on("end", function (chunk) {
        let body = Buffer.concat(chunks);
        console.log(body.toString());
    });

    res.on("error", function (error) {
        console.error(error);
    });
});

req.end();
python
import requests

session_id = <...>
saymon_hostname = <...>
url = "https://" + saymon_hostname + "/node/api/users/current"
headers = {"Cookie": "sid=" + session_id}

response = requests.request("GET", url, headers=headers)
print(response.text)

Ответ ​

text
"a5f946dc-4c21-4ccd-b78b-f0a5fce94f4d"

Смотрите также ​