Le Token — La clé de sécurité

Le Token est une clé secrète unique générée automatiquement par SookSook.

Exemple :

ssk_iot_8d54f5f4e8d1f84f...

À quoi sert le Token ?

Le Token sert à :

• authentifier le capteur,
• sécuriser les échanges,
• empêcher les faux appareils,
• empêcher les envois frauduleux,
• vérifier que le capteur est autorisé.

Sans token valide → données refusées

Si un appareil essaye d’envoyer des données sans le bon token :

❌ les données sont refusées.

SookSook répond :

token inconnu

ou :

capteur inactif

Pourquoi c’est important ?

Sans système de token :

• n’importe qui pourrait envoyer de fausses données,
• polluer les historiques,
• déclencher de faux états,
• créer de fausses alarmes,
• modifier des valeurs critiques.

Le token protège donc la plateforme.

Fonctionnement de la sécurité

Lorsqu’un capteur envoie un JSON :

{
  "token":"ssk_iot_xxxxx",
  "device_id":"10t-cc",
  "temperature":42
}

SookSook :

Étape 1

Recherche le token.

Étape 2

Vérifie qu’il existe.

Étape 3

Vérifie que le capteur est actif.

Étape 4

Vérifie que le Device ID correspond bien au token.

Protection contre l’usurpation

Même si quelqu’un connaît le Device ID :

10t-cc

cela ne suffit pas.

Il faut également :

✅ le bon token associé.

Sinon :

❌ accès refusé.

Liaison Token ↔ Device ID

Dans SookSook :

• un token appartient à un seul capteur,
• et un capteur possède son propre token.

Cela évite :

• qu’un capteur se fasse passer pour un autre,
• qu’un appareil envoie des données sur le mauvais équipement,
• les collisions de données.

Régénération du token

L’utilisateur peut régénérer un token à tout moment.

Cela permet :

• de bloquer un ancien appareil,
• remplacer un capteur,
• sécuriser à nouveau une installation,
• invalider un token compromis.

L’ancien token devient immédiatement inutilisable.

Exemple concret

Cas réel : Monte-charge 10T-CC

Le profil SookSook possède :

Device ID : 10t-cc

Le capteur physique installé sur le monte-charge possède :

Token : ssk_iot_7f84d1...

Le capteur envoie :

{
  "token":"ssk_iot_7f84d1...",
  "device_id":"10t-cc",
  "position":14,
  "temperature":36,
  "etat_contact":1
}

SookSook :

✅ authentifie le capteur
✅ vérifie l’identité
✅ stocke les données
✅ met à jour les widgets
✅ rafraîchit les graphiques
✅ historise les mesures

Pourquoi séparer Device ID et Token ?

Car ils n’ont pas le même rôle.

Device ID

= identité technique visible.

Token

= clé de sécurité secrète.

Analogie simple

Device ID

Comme une plaque d’immatriculation.

Token

Comme une clé sécurisée ou un badge d’accès.

Avantage pour la traçabilité

Chaque donnée reçue est automatiquement associée :

• au bon équipement,
• au bon historique,
• au bon profil,
• au bon contexte technique.

Cela permet :

• une supervision fiable,
• une traçabilité complète,
• une historisation propre,
• une meilleure maintenance,
• une meilleure analyse des événements terrain.