Autenticazione e Token
Accesso al dispositivo e token. Dopo l’accesso, token e c-id devono appartenere alla stessa sessione.
Flusso di accesso al dispositivo
Configurazione del server
https://<host>:<port>/initPOST /init
c-id: clientId · body: empty
sessionKey = Base64Decode(token). Derivata da entrambe le parti al login; non inviarla come Bearer. logout o revokeSession revoca la sessione; cambiare password non basta.
Crea in Connessioni → Token API dell’app del dispositivo. Copia clientId e token insieme. Elimina il token per revocarlo. Invia Bearer solo via HTTPS.
La cifratura del corpo HTTP non protegge il codice web scaricato. Al primo uso serve un’identità server attendibile; nel browser usa HTTPS attendibile.
Se sono aperte troppe connessioni non autenticate, il server restituisce HTTP 429 con un corpo vuoto prima del passaggio a WebSocket. Riprova più tardi.
WebSocket /auth · AuthErrorCode · Errori
Primo frame: 10 s. Poi 60 s per completare il handshake. Login e approvazione: 300 s totali.
INVALID_LOGIN_REQUEST- Controlla la richiesta di accesso e avvia un nuovo handshake.
PASSWORD_SETUP_REQUIRED- Imposta prima una password di accesso sul dispositivo.
INVALID_PASSWORD- Controlla la password e riprova.
PEER_IDENTITY_CHANGED- Verifica l’identità del dispositivo prima di continuare.
REMOTE_ACCESS_DISABLED- Attiva l’accesso remoto sul dispositivo.
REJECTED- Il proprietario ha rifiutato l’accesso.
TIMEOUT- Avvia una nuova richiesta di accesso.
TOO_MANY_LOGIN_ATTEMPTS- Attendi prima di riprovare.
Operazioni
Token API Bearer
Usare un token API separato per inviare JSON tramite HTTPS senza cifrare il corpo.
curl --request POST \
--url 'https://<device-host>:<https-port>/graphql' \
--header 'c-id: <client-id>' \
--header 'Authorization: Bearer <api-token>' \
--header 'Content-Type: application/json' \
--data '{"query":"{ app { deviceName capabilities access } }"}'logout
Revocare la sessione autenticata corrente del client chiamante.
mutation logout {
logout
}