Uwierzytelnianie
Pobierz dane autoryzacji
Dział zatytułowany „Pobierz dane autoryzacji”GET /api/authorization/get/
Pola odpowiedzi:
| Pole | Typ | Opis |
|---|---|---|
isWireguardAdminAccess | boolean | Dostęp administratora jest przyznawany automatycznie dla serwera VPN (zgodnie z ustawieniami). |
isWireguardPowerUserAccess | boolean | Dostęp autoryzowanego użytkownika jest przyznawany automatycznie dla serwera VPN (zgodnie z ustawieniami). |
leftButtonAuthorizedSessionMs | integer / null | Po naciśnięciu przycisku urządzenia: czas w milisekundach do wygaśnięcia tymczasowego dostępu autoryzowanego użytkownika albo null, jeśli dostęp ma inny typ. |
leftLoggedInSessionMs | integer / null | Po zalogowaniu hasłem: czas w milisekundach do wygaśnięcia dostępu autoryzowanego użytkownika albo null, jeśli dostęp ma inny typ. |
sinceAuthorizationCodeSetMs | integer / null | Czas w milisekundach od momentu ustawienia zdalnego kodu autoryzacji albo null, jeśli minęły więcej niż 2 minuty. |
sinceButtonPressedMs | integer / null | Czas w milisekundach od momentu naciśnięcia przycisku urządzenia albo null, jeśli minęła więcej niż 1 godzina. |
Przykładowa odpowiedź:
{ "isWireguardAdminAccess": true, "isWireguardPowerUserAccess": false, "leftButtonAuthorizedSessionMs": null, "leftLoggedInSessionMs": null, "sinceAuthorizationCodeSetMs": 109700, "sinceButtonPressedMs": 5100}Ustaw tymczasowy kod autoryzacji
Dział zatytułowany „Ustaw tymczasowy kod autoryzacji”Pozwala serwerowi VPN wyświetlić tymczasowy 8-cyfrowy kod na wyświetlaczu urządzenia.
Kod pozostaje wyświetlany przez 2 minuty.
POST /api/authorization/code/set/
Parametry żądania:
| Pole | Typ | Opis |
|---|---|---|
authorizationCode | integer / null | Kod potwierdzający dla serwera fizyczny dostęp użytkownika do urządzenia lub null, aby usunąć kod. |
Przykładowe żądanie:
{ "authorizationCode": 12345678}Odpowiedź:
Pusty JSON po pomyślnym wykonaniu polecenia.
{}Pobierz sól do hashowania hasła
Dział zatytułowany „Pobierz sól do hashowania hasła”Zapewnia unikalny ciąg znaków salt używany przez klienta do hashowania hasła przed uwierzytelnieniem.
GET /api/login/salt/
Odpowiedź:
| Pole | Typ | Opis |
|---|---|---|
salt | string | Unikalny ciąg znaków salt do hashowania hasła. |
Przykładowa odpowiedź:
{ "salt": "sFtqKto6hnaURPGQLJOCT1QMx7myDEGLBsCz3a2L"}Uwierzytelnianie użytkownika
Dział zatytułowany „Uwierzytelnianie użytkownika”Umożliwia użytkownikowi uwierzytelnienie i otrzymanie tokenu dostępu.
POST /api/login/
Parametry żądania:
| Pole | Typ | Opis |
|---|---|---|
username | string | Nazwa użytkownika. Użyj admin. |
password | string | Hash SHA1 hasła w formacie szesnastkowym. |
Uwaga: Hash hasła SHA1 jest obliczany jako SHA1(username + password + salt).
Przykładowe żądanie:
{ "username": "admin", "password": "90d54ed4126a0924528810aa5673a6d616d5f274"}Odpowiedź:
Po pomyślnym uwierzytelnieniu zwracany jest token i jego czas wygaśnięcia.
| Pole | Typ | Opis |
|---|---|---|
authType | string | Typ uwierzytelniania (Bearer). |
token | string | Token dostępu. |
ttlSec | integer | Czas życia tokenu w sekundach. |
{ "authType": "Bearer", "token": "ej5k2pVg4Pd8yBdUqFPq8bdaStpeAZhyelpmkhtOivdK8r7E", "ttlSec": 60}Wylogowanie
Dział zatytułowany „Wylogowanie”Kończy bieżącą sesję użytkownika i unieważnia token.
POST /api/cmd/logout/
Przykładowe żądanie:
{}Odpowiedź:
Pusty JSON po pomyślnym wykonaniu polecenia.
{}