sunuid-sdk 1.0.52 → 1.0.54

package/examples/secure-usage.php

@@ -1,309 +0,0 @@
-<?php
-
-require_once __DIR__ . '/../vendor/autoload.php';
-
-use SunuID\SunuID;
-use SunuID\Exception\SunuIDException;
-
-/**
- * Exemple d'utilisation sécurisée du SDK PHP SunuID
- * 
- * Cet exemple montre comment utiliser le SDK de manière sécurisée
- * sans exposer les credentials dans le code.
- */
-
-// ========================================
-// CONFIGURATION SÉCURISÉE
-// ========================================
-
-// Option 1: Configuration avec initialisation sécurisée (RECOMMANDÉE)
-$secureConfig = [
-    'type' => 2, // 1=KYC, 2=AUTH, 3=SIGNATURE
-    'partner_name' => 'MonApplicationSécurisée',
-    'theme' => 'light',
-    'language' => 'fr',
-    
-    // Activer l'initialisation sécurisée
-    'secure_init' => true,
-    'secure_init_url' => __DIR__ . '/../secure-init.php', // Chemin vers votre endpoint sécurisé
-    
-    // Options de sécurité
-    'enable_security_logs' => true,
-    'validate_inputs' => true,
-    'max_retries' => 3,
-    'request_timeout' => 10,
-    'token_max_age' => 300, // 5 minutes
-    
-    // Logs
-    'enable_logs' => true,
-    'log_level' => \Monolog\Logger::INFO,
-    'log_file' => 'sunuid-secure.log'
-];
-
-// Option 2: Configuration traditionnelle (moins sécurisée)
-$traditionalConfig = [
-    'client_id' => '1754166754_221A57B46843D755',
-    'secret_id' => '56d40fe70507228b27f2640ae65894177c2fedbf246e2b30978fde1fc43953c5',
-    'type' => 2,
-    'partner_name' => 'MonApplication',
-    'enable_security_logs' => true,
-    'validate_inputs' => true
-];
-
-// ========================================
-// FONCTIONS UTILITAIRES
-// ========================================
-
-/**
- * Afficher les informations de sécurité
- */
-function displaySecurityInfo(SunuID $sunuid): void
-{
-    echo "🔒 Informations de Sécurité:\n";
-    echo "   - Initialisé: " . ($sunuid->isInitialized() ? '✅' : '❌') . "\n";
-    echo "   - Configuration sécurisée: " . ($sunuid->getConfig()['secure_init'] ? '✅' : '❌') . "\n";
-    echo "   - Logs de sécurité activés: " . ($sunuid->getConfig()['enable_security_logs'] ? '✅' : '❌') . "\n";
-    echo "   - Validation des entrées: " . ($sunuid->getConfig()['validate_inputs'] ? '✅' : '❌') . "\n";
-    
-    if ($sunuid->getConfig()['secure_init']) {
-        echo "   - Token: " . ($sunuid->getConfig()['token'] ? '***' . substr($sunuid->getConfig()['token'], -8) : 'null') . "\n";
-        echo "   - Expire dans: " . ($sunuid->getConfig()['expires_in'] ?? 'N/A') . " secondes\n";
-        echo "   - Requêtes: " . $sunuid->getConfig()['request_count'] . "/" . ($sunuid->getConfig()['max_requests'] ?? '∞') . "\n";
-    }
-    
-    echo "\n";
-}
-
-/**
- * Afficher les logs de sécurité
- */
-function displaySecurityLogs(SunuID $sunuid): void
-{
-    $logs = $sunuid->getSecurityLogs();
-    
-    if (empty($logs)) {
-        echo "📝 Aucun log de sécurité disponible\n\n";
-        return;
-    }
-    
-    echo "📝 Logs de Sécurité (" . count($logs) . " événements):\n";
-    foreach ($logs as $log) {
-        $level = str_contains($log['event'], 'ERROR') ? '❌' : 
-                (str_contains($log['event'], 'SUCCESS') ? '✅' : 'ℹ️');
-        
-        echo "   {$level} {$log['timestamp']} - {$log['event']}\n";
-        if (!empty($log['data'])) {
-            echo "      Données: " . json_encode($log['data']) . "\n";
-        }
-    }
-    echo "\n";
-}
-
-// ========================================
-// EXEMPLE 1: UTILISATION SÉCURISÉE
-// ========================================
-
-echo "🚀 EXEMPLE 1: Utilisation Sécurisée\n";
-echo "=====================================\n\n";
-
-try {
-    // Créer l'instance SDK avec configuration sécurisée
-    $sunuid = new SunuID($secureConfig);
-    
-    echo "✅ SDK créé avec configuration sécurisée\n";
-    
-    // Initialiser le SDK (les credentials seront récupérés automatiquement)
-    $sunuid->init();
-    
-    echo "✅ SDK initialisé de manière sécurisée\n";
-    
-    // Afficher les informations de sécurité
-    displaySecurityInfo($sunuid);
-    
-    // Récupérer les informations du partenaire
-    $partnerInfo = $sunuid->getPartnerInfo();
-    echo "📋 Informations partenaire: " . json_encode($partnerInfo, JSON_PRETTY_PRINT) . "\n\n";
-    
-    // Générer un QR code d'authentification
-    echo "🎯 Génération QR code d'authentification...\n";
-    $qrResult = $sunuid->generateQR();
-    
-    echo "✅ QR Code généré:\n";
-    echo "   - URL: " . $qrResult['qr_code_url'] . "\n";
-    echo "   - Contenu: " . $qrResult['content'] . "\n";
-    echo "   - Session ID: " . $qrResult['session_id'] . "\n";
-    echo "   - Label: " . $qrResult['label'] . "\n";
-    echo "   - Type: " . $qrResult['type'] . "\n";
-    echo "   - Partenaire: " . $qrResult['partner_name'] . "\n\n";
-    
-    // Vérifier le statut du QR code
-    echo "📊 Vérification du statut du QR code...\n";
-    $status = $sunuid->checkQRStatus($qrResult['session_id']);
-    echo "📊 Statut QR: " . json_encode($status, JSON_PRETTY_PRINT) . "\n\n";
-    
-    // Afficher les logs de sécurité
-    displaySecurityLogs($sunuid);
-    
-} catch (SunuIDException $e) {
-    echo "❌ Erreur SunuID: " . $e->getMessage() . "\n";
-    echo "📍 Code: " . $e->getErrorCode() . "\n";
-    echo "📍 Contexte: " . json_encode($e->getContext()) . "\n";
-} catch (Exception $e) {
-    echo "❌ Erreur: " . $e->getMessage() . "\n";
-    echo "📍 Fichier: " . $e->getFile() . ":" . $e->getLine() . "\n";
-}
-
-// ========================================
-// EXEMPLE 2: GÉNÉRATION DE DIFFÉRENTS TYPES
-// ========================================
-
-echo "\n🚀 EXEMPLE 2: Génération de Différents Types\n";
-echo "==============================================\n\n";
-
-try {
-    $sunuid = new SunuID($secureConfig);
-    $sunuid->init();
-    
-    // Générer un QR code KYC
-    echo "📋 Génération QR code KYC...\n";
-    $kycQR = $sunuid->generateCustomQR(1, null, ['label' => 'Vérification d\'identité']);
-    echo "✅ QR KYC généré: " . $kycQR['qr_code_url'] . "\n\n";
-    
-    // Générer un QR code de signature
-    echo "✍️ Génération QR code Signature...\n";
-    $signatureQR = $sunuid->generateCustomQR(3, null, ['label' => 'Signature électronique']);
-    echo "✅ QR Signature généré: " . $signatureQR['qr_code_url'] . "\n\n";
-    
-} catch (Exception $e) {
-    echo "❌ Erreur: " . $e->getMessage() . "\n";
-}
-
-// ========================================
-// EXEMPLE 3: GESTION DES CALLBACKS
-// ========================================
-
-echo "\n🚀 EXEMPLE 3: Gestion des Callbacks\n";
-echo "=====================================\n\n";
-
-try {
-    $sunuid = new SunuID($secureConfig);
-    $sunuid->init();
-    
-    // Générer un état de sécurité
-    $state = $sunuid->generateState();
-    echo "🔐 État de sécurité généré: " . $state . "\n";
-    
-    // Simuler un callback (en production, cela viendrait de l'API SunuID)
-    $callbackData = [
-        'token' => 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyX2lkIjoxMjMsInNlc3Npb25faWQiOiJzZXNzaW9uXzEyMyIsInBhcnRuZXJfaWQiOjIxLCJ0eXBlIjoyLCJpYXQiOjE2MzQ1Njc4OTAsImV4cCI6MTYzNDU3MTQ5MH0.signature',
-        'session_id' => 'session_123',
-        'user_id' => 123,
-        'partner_id' => 21,
-        'type' => 2,
-        'timestamp' => time(),
-        'state' => $state
-    ];
-    
-    echo "📨 Simulation d'un callback reçu...\n";
-    echo "📋 Données callback: " . json_encode($callbackData, JSON_PRETTY_PRINT) . "\n\n";
-    
-    // Valider le callback
-    $isValid = $sunuid->validateCallback($callbackData);
-    echo "🔍 Validation du callback: " . ($isValid ? '✅ Valide' : '❌ Invalide') . "\n";
-    
-    if ($isValid) {
-        // Traiter l'authentification
-        $authResult = $sunuid->processAuthentication($callbackData);
-        echo "✅ Authentification traitée:\n";
-        echo "   - User ID: " . $authResult['user_id'] . "\n";
-        echo "   - Session ID: " . $authResult['session_id'] . "\n";
-        echo "   - Partner ID: " . $authResult['partner_id'] . "\n";
-        echo "   - Type: " . $authResult['type'] . "\n";
-        echo "   - Timestamp: " . $authResult['timestamp'] . "\n\n";
-    }
-    
-} catch (Exception $e) {
-    echo "❌ Erreur: " . $e->getMessage() . "\n";
-}
-
-// ========================================
-// EXEMPLE 4: GESTION DES ERREURS
-// ========================================
-
-echo "\n🚀 EXEMPLE 4: Gestion des Erreurs\n";
-echo "===================================\n\n";
-
-try {
-    // Configuration invalide pour tester la gestion d'erreurs
-    $invalidConfig = [
-        'type' => 2,
-        'secure_init' => false, // Pas d'initialisation sécurisée
-        'client_id' => '', // Client ID vide
-        'secret_id' => 'trop_court', // Secret ID trop court
-        'enable_security_logs' => true
-    ];
-    
-    echo "🧪 Test avec configuration invalide...\n";
-    $sunuid = new SunuID($invalidConfig);
-    $sunuid->init(); // Cela devrait lever une exception
-    
-} catch (SunuIDException $e) {
-    echo "❌ Erreur SunuID capturée:\n";
-    echo "   - Message: " . $e->getMessage() . "\n";
-    echo "   - Code: " . $e->getErrorCode() . "\n";
-    echo "   - Contexte: " . json_encode($e->getContext()) . "\n\n";
-} catch (Exception $e) {
-    echo "❌ Erreur générale: " . $e->getMessage() . "\n\n";
-}
-
-// ========================================
-// EXEMPLE 5: UTILISATION AVEC VARIABLES D'ENVIRONNEMENT
-// ========================================
-
-echo "\n🚀 EXEMPLE 5: Utilisation avec Variables d'Environnement\n";
-echo "==========================================================\n\n";
-
-// En production, vous utiliseriez des variables d'environnement
-// $_ENV['SUNUID_CLIENT_ID'] = 'votre_client_id';
-// $_ENV['SUNUID_SECRET_ID'] = 'votre_secret_id';
-
-try {
-    $envConfig = [
-        'type' => 2,
-        'partner_name' => 'AppProduction',
-        'secure_init' => true,
-        'secure_init_url' => __DIR__ . '/../secure-init.php',
-        'enable_security_logs' => true,
-        'validate_inputs' => true,
-        'log_file' => 'sunuid-production.log'
-    ];
-    
-    echo "🏭 Configuration production avec variables d'environnement...\n";
-    $sunuid = new SunuID($envConfig);
-    $sunuid->init();
-    
-    echo "✅ SDK production initialisé\n";
-    displaySecurityInfo($sunuid);
-    
-} catch (Exception $e) {
-    echo "❌ Erreur production: " . $e->getMessage() . "\n";
-}
-
-// ========================================
-// RÉSUMÉ FINAL
-// ========================================
-
-echo "\n🎯 RÉSUMÉ DES BONNES PRATIQUES\n";
-echo "===============================\n";
-echo "✅ Utilisez l'initialisation sécurisée (secure_init: true)\n";
-echo "✅ Stockez les credentials côté serveur uniquement\n";
-echo "✅ Activez les logs de sécurité\n";
-echo "✅ Validez les entrées utilisateur\n";
-echo "✅ Gérez les erreurs avec SunuIDException\n";
-echo "✅ Utilisez des variables d'environnement en production\n";
-echo "✅ Surveillez les logs de sécurité régulièrement\n";
-echo "✅ Changez régulièrement vos credentials\n";
-echo "✅ Testez votre implémentation avant la mise en production\n\n";
-
-echo "🔒 Votre intégration SunuID est maintenant sécurisée !\n";
-

package/examples/web-integration.php

@@ -1,138 +0,0 @@
-<?php
-
-require_once __DIR__ . '/../vendor/autoload.php';
-
-use SunuID\SunuID;
-
-// Configuration
-$config = [
-    'client_id' => '1754166754_221A57B46843D755',
-    'secret_id' => '56d40fe70507228b27f2640ae65894177c2fedbf246e2b30978fde1fc43953c5',
-    'type' => 2,
-    'enable_logs' => true
-];
-
-$error = null;
-$qrData = null;
-
-try {
-    $sunuid = new SunuID($config);
-    $sunuid->init();
-    
-    // Générer un QR code
-    $qrData = $sunuid->generateQR();
-    
-} catch (Exception $e) {
-    $error = $e->getMessage();
-}
-?>
-
-<!DOCTYPE html>
-<html lang="fr">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>SunuID PHP SDK - Intégration Web</title>
-    <style>
-        body {
-            font-family: Arial, sans-serif;
-            max-width: 600px;
-            margin: 50px auto;
-            padding: 20px;
-            text-align: center;
-        }
-        
-        .qr-container {
-            margin: 30px 0;
-            padding: 20px;
-            border: 2px dashed #ddd;
-            border-radius: 10px;
-            min-height: 300px;
-            display: flex;
-            align-items: center;
-            justify-content: center;
-        }
-        
-        .qr-container img {
-            max-width: 250px;
-            border: 1px solid #ddd;
-            border-radius: 5px;
-        }
-        
-        .error {
-            background: #ffebee;
-            color: #c62828;
-            padding: 15px;
-            border-radius: 5px;
-            margin: 20px 0;
-        }
-        
-        .info {
-            background: #e3f2fd;
-            color: #1976d2;
-            padding: 15px;
-            border-radius: 5px;
-            margin: 20px 0;
-            text-align: left;
-        }
-        
-        .success {
-            background: #e8f5e8;
-            color: #2e7d32;
-            padding: 15px;
-            border-radius: 5px;
-            margin: 20px 0;
-        }
-    </style>
-</head>
-<body>
-    <h1>🔐 SunuID PHP SDK</h1>
-    <p>Exemple d'intégration web</p>
-    
-    <?php if ($error): ?>
-        <div class="error">
-            <h3>❌ Erreur</h3>
-            <p><?php echo htmlspecialchars($error); ?></p>
-        </div>
-    <?php elseif ($qrData): ?>
-        <div class="success">
-            <h3>✅ QR Code généré avec succès</h3>
-            <p>Scannez le QR code avec l'application SunuID</p>
-        </div>
-        
-        <div class="qr-container">
-            <img src="<?php echo htmlspecialchars($qrData['qr_code_url']); ?>" 
-                 alt="QR Code SunuID" />
-        </div>
-        
-        <div class="info">
-            <h4>📋 Informations du QR Code</h4>
-            <ul>
-                <li><strong>Type:</strong> <?php echo htmlspecialchars($qrData['type']); ?></li>
-                <li><strong>Partenaire:</strong> <?php echo htmlspecialchars($qrData['partner_name']); ?></li>
-                <li><strong>Session ID:</strong> <?php echo htmlspecialchars($qrData['session_id']); ?></li>
-                <li><strong>Label:</strong> <?php echo htmlspecialchars($qrData['label']); ?></li>
-                <li><strong>Contenu:</strong> <code><?php echo htmlspecialchars($qrData['content']); ?></code></li>
-            </ul>
-        </div>
-        
-        <div class="info">
-            <h4>🔄 Vérifier le statut</h4>
-            <p>Session ID: <code><?php echo htmlspecialchars($qrData['session_id']); ?></code></p>
-            <p>Utilisez cette session ID pour vérifier le statut du scan.</p>
-        </div>
-        
-    <?php else: ?>
-        <div class="error">
-            <h3>⚠️ Aucune donnée</h3>
-            <p>Aucun QR code n'a pu être généré.</p>
-        </div>
-    <?php endif; ?>
-    
-    <div style="margin-top: 40px; padding: 20px; background: #f5f5f5; border-radius: 5px;">
-        <h4>📚 Documentation</h4>
-        <p>Pour plus d'informations, consultez la documentation du SDK PHP SunuID.</p>
-        <p><strong>Version:</strong> 1.0.0</p>
-    </div>
-</body>
-</html>