🔐 Diciwall Lisans Sistemi - Hibrit Lisans Entegrasyonu

📋 Genel Bakış: Bu sayfa Diciwall Lisans Sistemi'nin hibrit lisans teknolojisi ile müşteri projelerine entegrasyonu için gerekli tüm dokümanları ve araçları içerir. Sistem hem online hem offline lisans doğrulama imkanı sunar.

🎯 Diciwall Lisans Sistemi Özellikleri

Hibrit Doğrulama: Hem online API hem offline private key desteği
Dinamik Durum Kontrolü: API erişilebilirliğine göre otomatik geçiş
Güvenli Şifreleme: RSA 2048-bit şifreleme teknolojisi
IP/Domain Kontrolü: Lisanslı IP adresi ve domain doğrulaması
Expiry Management: Otomatik lisans süresi kontrolü
Anti-Tampering: Lisans manipülasyonuna karşı koruma

🔄 Hibrit Lisans Sistemi Nasıl Çalışır?

📊 Dinamik Durum Kontrolü:

🟢 API ERİŞİLEBİLİR + Private Key Var = "Private Key Available"

🟡 API ERİŞİLEMEZ + Private Key Var = "Private Key Activated"

🔵 API ERİŞİLEBİLİR + Private Key Yok = "Online Only"

🔴 API ERİŞİLEMEZ + Private Key Yok = "Offline Mode"

🛡️ Güvenlik Katmanları:

✅ RSA 2048-bit şifreleme
✅ Base64 encoding
✅ Digital Signature doğrulama
✅ Timestamp kontrolü
✅ Checksum doğrulama

⚠️ ÖNEMLİ: Entegrasyon Öncesi Kontroller

✅ Sistem Gereksinimleri:

PHP 7.0 veya üzeri
OpenSSL extension (RSA şifreleme için)
cURL extension (API çağrıları için)
JSON extension
Dosya yazma izinleri (private key dosyaları için)

🔧 Ön Hazırlık:

Lisans Oluşturma: Diciwall Admin Panelinden lisans oluşturun
Private Key Oluşturma: Lisans için private key oluşturun
API Key Alma: Entegrasyon için API key alın
Test Ortamı: Önce test ortamında deneyin

🚀 API Endpoint'leri

🔗 Diciwall Lisans Sistemi API'leri

Tüm API çağrıları için base URL: https://license.diciwall.com/api_external/

⚠️ Gerekli Header'lar: Tüm API çağrılarında aşağıdaki header'lar zorunludur:

LB-API-KEY: Admin panelinden aldığınız API anahtarı
LB-URL: Lisansı kullanacak domain (https:// ile başlamalı)
LB-IP: Sunucu IP adresi
Content-Type: application/json: JSON veri formatı

📋 Temel Lisans İşlemleri:

# Lisans Doğrulama (Online)
POST /api_external/verify_license
Headers: 
  LB-API-KEY: your_api_key
  LB-URL: https://your-domain.com
  LB-IP: your_server_ip
  Content-Type: application/json
Body: {
  "product_id": "YOUR_PRODUCT_ID",
  "license_code": "LICENSE_CODE", 
  "client_name": "your-domain.com"
}

# Lisans Aktivasyonu
POST /api_external/activate_license
Headers: 
  LB-API-KEY: your_api_key
  LB-URL: https://your-domain.com
  LB-IP: your_server_ip
  Content-Type: application/json
Body: {
  "product_id": "YOUR_PRODUCT_ID",
  "license_code": "LICENSE_CODE",
  "client_name": "your-domain.com"
}

# Lisans Deaktivasyonu
POST /api_external/deactivate_license
Headers: 
  LB-API-KEY: your_api_key
  LB-URL: https://your-domain.com
  LB-IP: your_server_ip
  Content-Type: application/json
Body: {
  "product_id": "YOUR_PRODUCT_ID",
  "license_code": "LICENSE_CODE",
  "client_name": "your-domain.com"
}
            

🔐 Hibrit Lisans İşlemleri:

# Private Key Kontrolü
GET /api_external/hybrid/check_private_key/{LICENSE_CODE}
Headers: LB-API-KEY: your_api_key

# Private Key İndirme
GET /api_external/hybrid/download_private_key/{LICENSE_CODE}
Headers: LB-API-KEY: your_api_key

# Offline Doğrulama
POST /api_external/hybrid/verify_offline
Headers: LB-API-KEY: your_api_key
Body: {"private_key_data": "BASE64_DATA", "client_ip": "IP", "client_domain": "DOMAIN"}

# Tam Hibrit Doğrulama (Online + Offline)
POST /api_external/hybrid/verify_full
Headers: LB-API-KEY: your_api_key
Body: {"license_code": "LICENSE_CODE", "private_key_data": "BASE64_DATA", "domain": "DOMAIN"}
            

📚 Entegrasyon Dokümanları

📖 Ana Entegrasyon Rehberi

Diciwall Lisans Sistemi'nin projenize nasıl entegre edileceğini detaylı olarak açıklayan kapsamlı rehber.

Adım adım kurulum talimatları
PHP, JavaScript ve diğer diller için kod örnekleri
Güvenlik önerileri ve best practices
Test senaryoları ve debugging
Hata yönetimi ve troubleshooting
Performans optimizasyonu

📖 Entegrasyon Rehberini Görüntüle

💻 Hazır Entegrasyon Örneği

Diciwall Lisans Sistemi için hazırlanmış, kullanıma hazır PHP sınıfları ve entegrasyon örnekleri.

DiciLicenseManager sınıfı (Genel kullanım)
DiciHybridLicense sınıfı (Hibrit sistem)
Otomatik API/Offline geçiş sistemi
Cache yönetimi ve performans optimizasyonu
Hata yönetimi ve logging sistemi
Test ve debug araçları

💻 Kod Örneklerini Görüntüle

⚙️ Otomatik Kurulum Aracı

Diciwall Lisans Sistemi'nin projenize otomatik kurulumunu yapan web tabanlı araç.

Otomatik dizin yapısı oluşturma
Gerekli dosyaların indirme ve kurulumu
Güvenlik ayarları ve .htaccess oluşturma
Test dosyası ve örnek kodlar oluşturma
Kurulum raporu ve doğrulama
Sistem uyumluluğu kontrolü

⚙️ Kurulum Aracını Çalıştır

🎯 Hızlı Başlangıç Kılavuzu

⚠️ Önemli: Entegrasyona başlamadan önce Diciwall Admin Panelinden lisansınızı oluşturup private key oluşturduğunuzdan emin olun.

🚀 3 Adımda Hızlı Kurulum:

1️⃣ API Testi:

# Lisansınızın durumunu kontrol edin
curl -X POST https://license.diciwall.com/api_external/verify_license \
  -H "LB-API-KEY: YOUR_API_KEY" \
  -H "LB-URL: https://your-domain.com" \
  -H "LB-IP: YOUR_SERVER_IP" \
  -H "Content-Type: application/json" \
  -d '{
    "product_id": "YOUR_PRODUCT_ID",
    "license_code": "YOUR_LICENSE_CODE",
    "client_name": "your-domain.com"
  }'
            

2️⃣ Private Key Kontrolü:

# Private key varlığını kontrol edin
curl -X GET https://license.diciwall.com/api_external/hybrid/check_private_key/YOUR_LICENSE_CODE \
  -H "LB-API-KEY: YOUR_API_KEY"

# Private key'i indirin
curl -X GET https://license.diciwall.com/api_external/hybrid/download_private_key/YOUR_LICENSE_CODE \
  -H "LB-API-KEY: YOUR_API_KEY"
            

3️⃣ Entegrasyon:

# PHP Entegrasyon Örneği
 $product_id,
    'license_code' => $license_code,
    'client_name' => $domain
]);

$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => 'https://license.diciwall.com/api_external/verify_license',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => $post_data,
    CURLOPT_HTTPHEADER => [
        'LB-API-KEY: ' . $api_key,
        'LB-URL: https://' . $domain,
        'LB-IP: ' . $server_ip,
        'Content-Type: application/json'
    ],
    CURLOPT_TIMEOUT => 30
]);

$response = curl_exec($ch);
$result = json_decode($response, true);
curl_close($ch);

if ($result && $result['status']) {
    echo "✅ Lisans geçerli!";
} else {
    echo "❌ Lisans hatası: " . ($result['message'] ?? 'Bilinmeyen hata');
}
?>
            

🔧 Entegrasyon Senaryoları

🌐 Web Uygulamaları

WordPress Plugin'leri
Laravel/CodeIgniter Projeleri
Custom PHP Uygulamaları
E-ticaret Sistemleri

🖥️ Desktop Uygulamaları

Electron Uygulamaları
C# .NET Uygulamaları
Java Desktop Apps
Python Desktop Apps

📱 Mobil Uygulamalar

React Native Apps
Flutter Applications
Hybrid Mobile Apps
Progressive Web Apps

🛡️ Güvenlik ve Best Practices

🔒 Güvenlik Önerileri

API key'leri güvenli yerlerde saklayın
Private key dosyalarını web erişiminden koruyun
HTTPS kullanın
Cache verilerini şifreleyin
Log dosyalarını düzenli temizleyin
IP whitelist kullanın

⚡ Performans Optimizasyonu

Cache mekanizması kullanın
API çağrılarını minimize edin
Offline mode'u aktif kullanın
Background verification yapın
Timeout değerlerini optimize edin

🔍 Sorun Giderme

❌ Yaygın Sorunlar ve Çözümleri

🚫 API Bağlantı Sorunları:

"Required request headers are invalid or missing": LB-API-KEY, LB-URL ve LB-IP header'larının doğru gönderildiğini kontrol edin
"Method not allowed or is invalid": Doğru endpoint kullandığınızdan emin olun (verify_license, activate_license, deactivate_license)
"API key not found": API key'inizin aktif olduğunu ve doğru controller'a (/api_external) atandığını kontrol edin
"License not found": Lisans kodunun doğru ve sistemde kayıtlı olduğunu kontrol edin
"Domain/IP mismatch": Lisanslı domain ve IP adreslerini kontrol edin
Timeout Hatası: İnternet bağlantısını ve firewall ayarlarını kontrol edin

🔐 Private Key Sorunları:

Dosya Bulunamadı: Dosya yolunu ve izinlerini kontrol edin
Geçersiz Format: Base64 encoding'i kontrol edin
Signature Hatası: Dosya bütünlüğünü kontrol edin
Expired Key: Lisans süresini kontrol edin

🌐 Domain/IP Sorunları:

Domain Mismatch: Lisanslı domain'leri kontrol edin
IP Restriction: Lisanslı IP adreslerini kontrol edin
Subdomain Issues: Wildcard domain ayarlarını kontrol edin

🔧 Debug Araçları

# API Key Kontrolü
curl -X POST https://license.diciwall.com/api_external/check_connection_ext \
  -H "LB-API-KEY: YOUR_API_KEY" \
  -H "LB-URL: https://your-domain.com" \
  -H "LB-IP: YOUR_SERVER_IP" \
  -H "Content-Type: application/json"

# Lisans Detay Kontrolü
curl -X POST https://license.diciwall.com/api_external/verify_license \
  -H "LB-API-KEY: YOUR_API_KEY" \
  -H "LB-URL: https://your-domain.com" \
  -H "LB-IP: YOUR_SERVER_IP" \
  -H "Content-Type: application/json" \
  -d '{"product_id": "YOUR_PRODUCT_ID", "license_code": "YOUR_LICENSE", "client_name": "your-domain.com"}' \
  -v

# Private Key Kontrolü
curl -X GET https://license.diciwall.com/api_external/hybrid/check_private_key/YOUR_LICENSE \
  -H "LB-API-KEY: YOUR_API_KEY" \
  -v
            

💡 Debug İpuçları:

-v parametresi ile detaylı HTTP bilgilerini görebilirsiniz
API yanıtlarında status ve message alanlarını kontrol edin
HTTP status kodları: 200 (başarılı), 403 (header hatası), 404 (endpoint bulunamadı)
Admin panelinden API key'inizin aktif olduğunu kontrol edin

📞 Destek ve İletişim

🆘 Teknik Destek

E-posta: support@diciwall.com
Admin Panel: https://license.diciwall.com
Dokümantasyon: Bu sayfadaki rehberleri takip edin
API Status: https://status.diciwall.com

📚 Ek Kaynaklar

📅 Son Güncelleme: 3 Ekim 2025 - Diciwall Lisans Sistemi v2.0
🔖 Versiyon: 2.0.0 - Hibrit API Sistemi
👨‍💻 Geliştirici: DiciWall Development Team
🌐 Website: https://diciwall.com