Lisans API v2

Lisans sunucusu https://api.sorvia.dev adresinde çalışır. Tüm istekler POST ve JSON gövdelidir.

Etkinleştirme

POST /v1/license/activate

{
  "key": "SRV-XXXXX-XXXXX-XXXXX-XXXXX-XXXXX",
  "productCode": "srv-farmer",
  "instanceId": "kurulumun-kalici-kimligi",
  "nonce": "her-istekte-yeni-rastgele-deger",
  "protocolVersion": 2
}

Yanıt bir activationId ve imzalı entitlement belgesi döner. Aynı instanceId ile tekrar etkinleştirmek yeni kurulum açmaz.

Doğrulama

POST /v1/license/validate — etkinleştirme alanlarına ek olarak activationId gönderilir. Yanıttaki renewAt zamanında yeniden doğrulayın.

Bırakma

POST /v1/license/deactivate — key, activationId, instanceId. Kurulum yeri boşalır.

İmzalı belge

entitlement bir Ed25519 imzalı JWS'dir (typ: sorvia-entitlement+jwt). Açık anahtarlar GET /v1/keys adresindedir; eklentiye gömülü tutun, çalışırken indirmeyin.

Alan	Anlamı
prd	Ürün kodu
ins	Kurulum kimliği
exp	Bu onayın bitişi (varsayılan 24 saat)
off	Sunucuya ulaşılamazsa çalışabileceği son an (varsayılan 72 saat)
rnw	Yeniden doğrulama zamanı (varsayılan 6 saat)
ftr	Açık özellikler

Hata kodları

KEY_NOT_FOUND, PRODUCT_MISMATCH, LICENSE_SUSPENDED, LICENSE_REVOKED, LICENSE_EXPIRED, ACTIVATION_LIMIT_REACHED, ACTIVATION_NOT_FOUND, INSTANCE_MISMATCH, IP_LIMIT_REACHED, NONCE_REUSED, PROTOCOL_UNSUPPORTED, RATE_LIMITED, SERVICE_UNAVAILABLE.

Sunucu "hayır" dediğinde (lisans iptal, süre doldu vb.) eklenti durmalıdır. Ağ hatası ya da RATE_LIMITED durumunda son geçerli belgeyle off zamanına kadar çalışmaya devam edin.

License Shield

Eklenti her kurulumda kendi Ed25519 anahtar çiftini üretir. Etkinleştirmede açık anahtarı clientPublicKey alanında gönderir; sonraki her istekte şu metni özel anahtarıyla imzalar:

sorvia-proof-v1|<route>|<activationId>|<instanceId>|<nonce>|<timestamp>

timestamp (Unix saniye) ve imza (proof, base64url) gövdeye eklenir. Zaman damgası 5 dakikadan eskiyse ya da imza kayıtlı anahtarla doğrulanmazsa INSTANCE_PROOF_INVALID döner. Ürün ayarında "kurulum anahtarı zorunlu" açıksa anahtarsız etkinleştirme PROOF_REQUIRED ile reddedilir.

Sunucu şüpheli istekleri kaydeder: kısa sürede çok yeni kurulum lisansa geçici kurulum beklemesi (ACTIVATION_COOLDOWN) koyar, tekrar eden imza/nonce hataları lisansı incelemeye alır ve daha sık doğrulama ister. Lisans hiçbir zaman otomatik askıya alınmaz; karar Sorvia ekibindedir.