Собственная авторизация
Для разработки собственной авторизации необходимо понимание процесса авторизации, ниже представлен процесс от входа лаунчера, до ответа на вашем сайте
Как работает авторизация?
- Пользователь вводит логин и пароль в лаунчере
- Лаунчер отправляет запрос на ваш сервер авторизации
- Сервер проверяет учетные данные и отправляет ответ
- Лаунчер обрабатывает ответ и предоставляет или отказывает в доступе
На фото представлены 4 этапа отправки уведомления. Вот описание всех 4:
- Запрос от лаунчера к Gml.Backend
- Curl
- JavaScript
curl
--location 'http://localhost:5003/api/v1/integrations/auth/signin' \
--header 'Content-Type: application/json' \
--data '{
"Login": "ЛОГИН",
"Password": "ПАРОЛЬ"
}'
const myHeaders = new Headers();
myHeaders.append("Content-Type", "application/json");
const raw = JSON.stringify({
"Login": "ЛОГИН",
"Password": "ПАРОЛЬ"
});
const requestOptions = {
method: "POST",
headers: myHeaders,
body: raw,
redirect: "follow"
};
fetch("http://localhost:5003/api/v1/integrations/auth/signin", requestOptions)
.then((response) => response.text())
.then((result) => console.log(result))
.catch((error) => console.error(error));
- Gml.Backend - Ваш сайт
- Curl
- JavaScript
- Пример вашего ответа
curl --location 'http://ВАШ_АДРЕС' \
--header 'Content-Type: application/json' \
--data '{
"Login": "ЛОГИН",
"Password": "ПАРОЛЬ"
}'
const myHeaders = new Headers();
myHeaders.append("Content-Type", "application/json");
const raw = JSON.stringify({
"Login": "ЛОГИН",
"Password": "ПАРОЛЬ"
});
const requestOptions = {
method: "POST",
headers: myHeaders,
body: raw,
redirect: "follow"
};
fetch("http://ВАШ_АДРЕС", requestOptions)
.then((response) => response.text())
.then((result) => console.log(result))
.catch((error) => console.error(error));
200
- Успешная авторизация *
{
"Login": "GamerVII",
"UserUuid": "c07a9841-2275-4ba0-8f1c-2e1599a1f22f",
"Message": "Успешная авторизация"
}
401
- Ошибка аутентификации *
{
"Message": "Неверный логин или пароль"
}
401
- Ошибка аутентификации, нужен ввод 2FA **
{
"Message": "Введите проверочный код 2FA"
}
404
- Пользователь не найден
{
"Message": "Пользователь не найден"
}
403
- Пользователь не имеет доступа или заблокирован
{
"Message": "Пользователь заблокирован. Причина: Раздача на спавне"
}
* Обратите внимание, что не обязательно заполнять тело ответа, достаточно вернуть StatusCode (Обязательно)
Поля Message
и UserUuid
будут сгенерированы автоматически.
Ендпоинты 200 и 401 необходимо реализовать Обязательно
** В случае, если вы хотите проверять коды двухфакторной атентификации наличие сообщения "Введите проверочный код 2FA" — Обязательно
Собственная авторизация
Есть возможность реализовать свою, кастомную авторизацию через Endpoint. Для этого нужно на стороне вашего сервиса реализовать Endpoint
- Выберите в панель управление раздел:
Интеграции
->Аутентификация
->Аутентификация
->Собственная аутентификация
- Вставьте ссылку на реализованный endoint авторизации
Gml.Backend - Ваш сайт
Важно! Примеры реализации можете посмотреть на странице Github