Weryfikacja własności w Overvis

Weryfikacja potwierdza fizyczny dostęp do urządzenia TR-100E podczas łączenia go z Overvis za pomocą kodu PIN. Kod jest wyświetlany na urządzeniu przez maksymalnie 5 minut. Użytkownik może wprowadzić ten kod w Overvis albo potwierdzić połączenie, wybierając opcję Tak na urządzeniu TR-100E.

Kod stanowi część stanu roboczego: nie jest zapisywany w pamięci Flash/EEPROM ani zwracany przez interfejs API stanu.

POST /api/service/challenge/set/

Ustawia, zastępuje lub usuwa weryfikację.

Dostęp: wyłącznie WireGuard, Bearer/implicit (user). Żądanie z sieci LAN zwraca 403 ERROR_NO_ACCESS.

Ustawienie

{
  "code": "001274"
}

Pole code jest wymagane i musi zawierać od 1 do 12 cyfr ASCII. Kod jest przekazywany jako ciąg znaków, aby zachować zera wiodące. Nowe żądanie zastępuje poprzednią weryfikację i ponownie uruchamia 300-sekundowy licznik czasu.

Odpowiedź 200:

{
  "status": "pending",
  "remainingSec": 300
}

Usunięcie

{
  "code": null
}

Odpowiedź 200:

{
  "status": "idle",
  "remainingSec": 0
}

Pusta treść żądania lub nieprawidłowy kod JSON powoduje zwrócenie 400 ERROR_API_PARSING. Brakujące pole, nieprawidłowy typ, pusty ciąg znaków albo kod, który jest zbyt długi lub zawiera znaki inne niż cyfry, powoduje zwrócenie 400 ERROR_INVALID_ARGUMENT. Błąd walidacji nie zmienia bieżącej weryfikacji.

GET /api/service/challenge/status/

Pobiera spójną migawkę stanu weryfikacji.

Dostęp: wyłącznie WireGuard, Bearer/implicit (user). Żądanie z sieci LAN zwraca 403 ERROR_NO_ACCESS.

Odpowiedź 200:

{
  "status": "accepted",
  "remainingSec": 247
}

`status`	Znaczenie
`idle`	Weryfikacja jest nieaktywna lub została usunięta
`pending`	Kod jest wyświetlany, ale nie otrzymano jeszcze fizycznej odpowiedzi
`accepted`	Użytkownik wybrał opcję Tak na urządzeniu TR-100E
`rejected`	Użytkownik wybrał opcję Nie na urządzeniu TR-100E

Wartość remainingSec zmniejsza się od 300 do 1 w stanach pending, accepted i rejected; w stanie idle wynosi 0. Odpowiedź użytkownika nie uruchamia ponownie ani nie zatrzymuje licznika czasu. Po upływie pierwotnych 300 sekund urządzenie automatycznie przywraca stan weryfikacji idle.

Po wybraniu opcji Tak urządzenie TR-100E wyświetla ekran oczekiwania do czasu, gdy Overvis odczyta stan accepted i wyśle code: null. Usunięcie weryfikacji kończy przepływ interfejsu użytkownika i przywraca ekran główny.

Jeśli użytkownik potwierdzi własność, wprowadzając kod w Overvis, usługa chmurowa porównuje go z pierwotną wartością i po pomyślnej weryfikacji wysyła code: null, aby usunąć monit z wyświetlacza.