BJSecureID

Introduction

BJSecureID est une plateforme de détection et prévention de fraude identitaire. Elle identifie chaque visiteur par son empreinte numérique (fingerprint), calcule un score de confiance, et permet aux plateformes partenaires de sécuriser leurs services.

Modes du SDK

Le SDK fonctionne en deux modes selon votre besoin :

1. Intégration rapide

Ajoutez le SDK dans votre page HTML avec votre clé publique :

<script src="https://bjsecureid.com/sdk/bjsecure.js"></script>
<script>
  BJSecure.init({
    publicKey: 'pk_VOTRE_CLE_PUBLIQUE',
    endpoint: 'https://bjsecureid.com/api/v1',
    mode: 'passive', // ou 'active'
    debug: false,
    onReady: function(data) {
      console.log('Visiteur:', data.visitor_uuid);
      console.log('Score:', data.trust_score);
    },
    onError: function(err) {
      console.error('Erreur:', err);
    }
  });
</script>

2. Options de configuration

3. API REST

Tous les endpoints requièrent le header X-API-Key (clé privée, côté serveur uniquement).

Response: { "success": true, "data": { "visitor_uuid", "trust_score", "is_new" } }

Body: { "visitor_uuid": "...", "session_id": "...", "events": [ { "type": "pageview", "url": "..." } ] }

Body: { "visitor_uuid": "...", "first_name": "...", "email": "...", "npi": "..." }

Analytics & suivi d'événements SDK v1.2+

À partir de la v1.2, le SDK journalise automatiquement l'activité du visiteur (pages vues, clics, défilement, soumissions de formulaire, fin de session) et l'envoie par lots à /api/v1/events. Aucune configuration n'est requise : le suivi est actif par défaut.

Événements custom

// Journaliser une action métier
BJSecure.track('inscription_terminee', { plan: 'premium', montant: 15000 });

Capture de formulaires & profil visiteur

Le SDK détecte les champs d'identité remplis (nom, prénom, email, téléphone, NPI) pour construire le profil du visiteur. Garde-fous appliqués automatiquement : les mots de passe, codes OTP et données de paiement ne sont jamais capturés (exclusion côté SDK et serveur).

• • Forcer la capture d'un champ : data-bjs-capture="ville"
• • Exclure un champ : data-bjs-ignore
• • Désactiver toute la capture : captureFields: false

Options de tracking

4. Pousser des profils (mode actif)

BJSecure.pushProfile({
  first_name: 'Koffi',
  last_name: 'Agossou',
  email: 'koffi@example.com',
  npi: 'NPI-123456789',
  id_card_type: 'CNI',
  id_card_number: 'AB1234567',
  authenticated: true,
  custom_data: { role: 'client' }
}).then(res => console.log('OK', res));

5. Webhooks (mode actif)

Chaque webhook est signé avec HMAC-SHA256 pour garantir l'authenticité.

Headers envoyés :

X-BJSecure-Signature: hmac_sha256(payload, webhook_secret)
X-BJSecure-Event: visitor.profile.request
X-BJSecure-Timestamp: 1234567890
X-BJSecure-Platform: platform_uuid

Vérification côté serveur (PHP) :

$payload = file_get_contents('php://input');
$signature = $_SERVER['HTTP_X_BJSECURE_SIGNATURE'];
$expected = hash_hmac('sha256', $payload, $webhookSecret);

if (hash_equals($expected, $signature)) {
    $data = json_decode($payload, true);
    // Traiter les données...
}

6. Trust Score

Le Trust Score (0-100) est calculé automatiquement :

7. Sécurité et domaines

8. Association de devices (QR Code)

// Générer un code d'association
const result = await BJSecure.generateLinkCode();
if (result.success) {
  const code = result.data.code;        // "ABCD-EF12"
  const qrData = result.data.qr_content; // JSON pour QR code
  const expiresIn = result.data.expires_in_seconds; // 300

  // Afficher le QR code (avec une lib comme qrcode.js)
  QRCode.toCanvas(document.getElementById('qr'), qrData);

  // Ou afficher le code texte comme alternative
  document.getElementById('code').textContent = code;

  // Polling optionnel pour détecter quand le code est utilisé
  const interval = setInterval(async () => {
    const status = await BJSecure.checkLinkStatus(code);
    if (status.data?.status === 'used') {
      clearInterval(interval);
      alert('Nouvel appareil associé !');
    }
  }, 3000);
}

// Confirmer l'association avec le code saisi ou scanné
const result = await BJSecure.confirmLinkCode('ABCD-EF12');
if (result.success) {
  console.log('Associé au visiteur:', result.data.visitor_uuid);
  // Le SDK est maintenant lié au même visiteur
}

9. Entités et plateformes