Authentification et jetons
Connexion à l’appareil et jeton. Après la connexion, token et c-id doivent appartenir à la même session.
Déroulement de connexion à l’appareil
Configuration du serveur
https://<host>:<port>/initPOST /init
c-id: clientId · body: empty
sessionKey = Base64Decode(token). Dérivée des deux côtés à la connexion ; ne pas envoyer comme Bearer. logout ou revokeSession révoque la session, pas le changement de mot de passe.
Créer dans Connexions → Jetons API de l’appareil. Copier clientId et token ensemble. Supprimer le jeton le révoque. Envoyer Bearer uniquement par HTTPS.
Le chiffrement HTTP ne protège pas le code web téléchargé. La première connexion exige une identité serveur fiable ; utiliser HTTPS de confiance dans le navigateur.
Si trop de connexions non authentifiées sont ouvertes, le serveur renvoie HTTP 429 avec un corps vide avant le passage à WebSocket. Réessayez plus tard.
WebSocket /auth · AuthErrorCode · Erreurs
Premier frame : 10 s. Puis 60 s pour finir le handshake. Connexion et approbation : 300 s au total.
INVALID_LOGIN_REQUEST- Vérifiez la demande de connexion et démarrez une nouvelle négociation.
PASSWORD_SETUP_REQUIRED- Définissez d’abord un mot de passe de connexion sur l’appareil.
INVALID_PASSWORD- Vérifiez le mot de passe et réessayez.
PEER_IDENTITY_CHANGED- Vérifiez l’identité de l’appareil avant de continuer.
REMOTE_ACCESS_DISABLED- Activez l’accès distant sur l’appareil.
REJECTED- Le propriétaire a refusé la connexion.
TIMEOUT- Lancez une nouvelle demande de connexion.
TOO_MANY_LOGIN_ATTEMPTS- Patientez avant de réessayer.
Opérations
Jeton d’API Bearer
Utiliser un jeton d’API distinct pour envoyer du JSON via HTTPS sans chiffrement du corps.
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
Révoquer la session authentifiée actuelle du client appelant.
mutation logout {
logout
}