Identifier tes utilisateurs (SSO)

Avec le SSO, ton serveur signe un jeton pour l’utilisateur connecté. Le widget le reconnaît alors directement : pas de compte Votecove à créer, et tu sais qui vote.

1. Récupère ta clé secrète

Dans Réglages → Intégrations, affiche la clé secrète SSO. Garde-la sur ton serveur : ne la mets jamais dans le code envoyé au navigateur.

2. Signe un jeton (JWT HS256)

Champs du jeton :

• id (obligatoire) : identifiant de l’utilisateur chez toi ;
• exp (obligatoire) : date d’expiration, dans moins de 7 jours ;
• email, name, avatar (facultatifs) ;
• mrr (facultatif) : revenu mensuel de ce client, en euros, pour prioriser par revenu.

Exemple en PHP :

$b64 = fn ($s) => rtrim(strtr(base64_encode($s), '+/', '-_'), '=');
$data = $b64(json_encode(['alg' => 'HS256', 'typ' => 'JWT'])).'.'.$b64(json_encode([
    'id' => $user->id, 'email' => $user->email, 'name' => $user->name, 'exp' => time() + 3600,
]));
$token = $data.'.'.$b64(hash_hmac('sha256', $data, getenv('VOTECOVE_SECRET'), true));

Exemple en Node.js :

import jwt from 'jsonwebtoken';
const token = jwt.sign({ id: user.id, email: user.email, name: user.name }, process.env.VOTECOVE_SECRET, { algorithm: 'HS256', expiresIn: '1h' });

3. Passe-le au widget

Mets le jeton dans data-token, ou appelle Votecove.identify(token) une fois l’utilisateur connecté (utile dans une application monopage). À la déconnexion, appelle Votecove.identify('').

Si ta clé a fuité, clique sur Générer une nouvelle clé : l’ancienne cesse aussitôt de fonctionner.