اپنے سافٹ ویئر میں لائسنس شامل کریں

برآمد محفوظ کرنے کے لیے تقریباً ۱۵ منٹ رکھیں: ترتیب، نمونہ، ایپ میں انضمام اور اجازت مسترد ہونے کی جانچ۔ زبان کے ترقیاتی اوزار پہلے نصب ہوں۔

SDK درخواست، آلے کی شناخت، دستخط، اسناد، کیش اور ہارٹ بیٹ سنبھالتا ہے۔ صارف کی کلید اور کام کا فنکشن دیں؛ دستی HTTP یا activation_id محفوظ کرنا ضروری نہیں۔

1. انضمام کا پیکیج ڈاؤن لوڈ کریںکنسول میں مصنوعات کی ترتیب بنائیں
2. برآمد شدہ فائل بنائیںاجازت اور کارروائی کا نتیجہ جانچیں
3. ایپ میں شامل کریںآغاز، عملی داخلی حصہ، اختتام

1. کنسول میں پیکیج تیار کریں

کھولیں فوری آغاز، سافٹ ویئر کا نام دیں، آلے سے بندھا یا فلوٹنگ لائسنس منتخب کریں اور مصنوعات بنا کر آگے بڑھیں۔ نظام مصنوعات، پالیسی، آزمائشی لائسنس، عوامی key اور 1.0.0 ورژن تیار کرتا ہے۔ زبان منتخب کر کے پیکیج ڈاؤن لوڈ اور کھولیں۔

پیکیج میں دو ترتیبات ہیں:sdk-demo.json آپ کی آزمائش کے لیے لائسنس key ہے؛product.json میں صرف مصنوعات کی ترتیب اور عوامی key ہے، اسے سافٹ ویئر کے ساتھ تقسیم کیا جا سکتا ہے۔

پہلے انضمام میں آلے سے منسلک لائسنس لیں۔ ابتدائی مثال میں export بغیر گنتی ہے۔ موجودہ مصنوعات کی پالیسی اور لائسنس دونوں میں یہی خصوصیت ہونی چاہیے۔

۲۔ ماحول جانچیں اور فائل برآمد کریں

کھولی گئی ڈائریکٹری کی جڑ میں ٹرمینل کھولیں۔ product.json، sdk-demo.json، start.ps1، start.sh اور sdk ساتھ رکھیں۔ زبان اور نظام چن کر کمانڈ چلائیں۔ ماحول کی جانچ فعال سازی نہیں بھیجتی۔

کامیابی کی علامت:اختتامی کوڈ ۰، نیچے کا نتیجہ اور نئی licensed-report.txt۔ آزمائشی اختیار ہٹا کر چلائیں: SDK آلے کی سند بحال کرتا ہے، اضافی آلے کی جگہ نہیں لیتا۔

License OK: export is available
Export completed: licensed-report.txt

پہلے گم شدہ ترقیاتی اوزار نصب کریں۔ C/C++ کو libcurl کی ترقیاتی فائلیں بھی چاہئیں؛ MinGW میں -CurlRoot استعمال کریں۔ براؤزر کی تنبیہ قبول کرنے سے SDK سرٹیفکیٹ پر اعتماد نہیں کرتا؛ رن ٹائم کو آزمائشی سرور کا سرٹیفکیٹ معتبر لگنا چاہیے۔

3. صارف کی ایپ میں شامل کریں

پروجیکٹ میں ویب سائٹ کا انسٹالر چلائیں۔ نو زبانیں 0.10.0 استعمال کرتی ہیں۔ تنصیب یا extraction سے پہلے SHA-256 جانچا جاتا ہے۔ ایپ وسائل میں صرف product.json رکھیں۔

اس زبان کی قابل اجرا فائل:۔ اس کی عملی کارروائی کا داخلی حصہ اپنے منصوبے میں نقل کریں؛ مکمل کوڈ دیکھیں ←

۴۔ تصدیق کریں کہ اجازت نہ ہونے پر برآمد رکتی ہے

یقین کریں پالیسی میں licentivo_denied_probe نہیں، پھر کمانڈ چلائیں۔ غیر صفر اختتامی کوڈ آئے اور denied-report.txt نہ بنے۔ ایسا آؤٹ پٹ راستہ لیں جو پہلے موجود نہیں۔

۵۔ ضرورت ہو تو استعمال کی گنتی شامل کریں

RunMeteredFeature کو فنکشن اور مستقل کام کا ID دیں۔ SDK استعمال محفوظ کرتا، کامیابی کی تصدیق اور کارروائی کی ناکامی پر منسوخ کرتا ہے، اور زیر التوا تصدیق لکھتا ہے۔گنتی والے انضمام اور دوبارہ کوشش دیکھیں ←

یہ تین شناختیں سمجھیں

Heartbeat کا وقفہ اور آف لائن مدت الگ مقرر کریں لائسنس پالیسیاں۔ میعاد پہلی فعال کاری سے شروع ہے۔ بنیادی انضمام چلنے کے بعد خصوصیات کا کوٹا، فلوٹنگ نشستیں اور آف لائن فائل فعال کاری شامل کریں۔

رجسٹریشن کے بغیر بھی کھول سکتے ہیں ڈیمو آزمائیںدرخواست اور جواب دیکھنے کے لیے۔ خودکار لائسنس اجرا کے لیے پڑھیں انتظامی API key۔

کلائنٹ SDK

فنکشن SDK کو دیں: اجازت کے لیے RunFeature، گنتی کے لیے RunMeteredFeature۔ درخواست، دستخط، کیش اور ہارٹ بیٹ SDK سنبھالتا ہے۔

چلانے سے پہلے

کنسول میں، فوری آغازتیار پیکیج ڈاؤن لوڈ کریں۔ ڈیمو نجی فائل استعمال کرتا ہے sdk-demo.json؛ حقیقی ایپ میں استعمال کریں product.json، صارف کا key آغاز پر دیں۔ نیچے SDK ڈاؤن لوڈ میں عام source ہے، آپ کی مصنوعات کی ترتیب نہیں۔

{
  "base_url": "https://www.licentivo.com",
  "product_id": "PRODUCT_UUID",
  "license_key": "",
  "device_name": "Customer app",
  "app_version": "1.0.0",
  "trusted_keys": {
    "SIGNING_KEY_UUID": "BASE64URL_PUBLIC_KEY"
  },
  "timeout_seconds": 10,
  "allow_http": false
}

اپنی زبان منتخب کریں

یہ کوڈ تقسیم شدہ فائل سے ملتا ہے اور حقیقی برآمد بناتا ہے۔ ماحول کے متغیر فعال سازی کے ان پٹ کی جگہ ہیں؛ اپنا UI لیں اور ایپ کی زندگی تک client فعال رکھیں۔

SDK سے محفوظ کارروائی چلائیں اور اختتام پر client بند کریں۔

正在加载代码…

ایپ کی مثال چلائیں

مثالوں میں فعال سازی، حالت، فائل برآمد اور آلہ آزاد کرنا ہے۔ Java، Python، C# میں ونڈو؛ باقی میں ٹرمینل مینو ہے۔ کلید ایک بار دیں، پھر بحالی کے لیے خالی رکھیں۔

کامیاب برآمد licensed-report.txt بناتی ہے۔ شمار شدہ برآمد سے پہلے پالیسی میں export کی حد مقرر کریں۔

ونڈو اور مینو کے نمونے بنیادی بکنگ دکھاتے ہیں۔ نیچے RunMeteredFeature استعمال کریں؛ نووں زبانیں زیر التوا تصدیق محفوظ کرتی ہیں۔ کارروائی کے دوران کریش پر اپنا نتیجہ جانچیں۔

اجازت کی حالت کیسے دکھائیں؟

Status اور FeatureStatus مقامی حالت پڑھتے ہیں؛ درخواست یا پس منظر کی تصدیق کا انتظار نہیں۔ اطلاع سے انٹرفیس تازہ کریں۔

allowed مقامی اجازت کی درستگی ہے؛ شمار شدہ خصوصیت کو مقدار پھر بھی مانگنی ہوگی۔ lease_valid_until دستخط شدہ کیش کی مدت ہے، لائسنس کی نہیں۔ code، request_id، retryable خرابی، لاگ شناخت اور دوبارہ کوشش کا امکان بتاتے ہیں۔

طریقوں، callbacks اور پیکیج کے استعمال کے لیے sdk/README.md دیکھیں۔ ویب سائٹ ورژن کے پیکیج اور مشترک انسٹالر دیتی ہے؛ عوامی registry پر اشاعت ابھی مؤخر ہے۔

ایپ میں یہ کہاں رکھیں؟

جدول کے نام اعمال بتاتے ہیں؛ اپنی زبان کی مثال کے درست نام استعمال کریں۔ Heartbeat، آف لائن کیش اور آن لائن تازہ کاری کے لیے دیکھیں Heartbeat اور آف لائن رسائی۔

انتظامی API key

آرڈر سسٹم سے خودکار لائسنس جاری کرنے یا سرور سے لائسنس ڈیٹا پڑھنے کے لیے management API Key استعمال کریں۔ یہ آپ کے فروش workspace کی نمائندگی کرتی ہے۔

کلائنٹ کو کون سی key چاہیے؟

صارف کے سافٹ ویئر میں لائسنس جانچنے کے لیے license key کافی ہے۔ management API Key پورا workspace چلا سکتی ہے؛ اسے صارف کے سافٹ ویئر یا عوامی صفحے میں نہ رکھیں۔

ایک key بنائیں

1. workspace Owner سے داخل ہو کر کھولیں API Key اور API Key بنائیں دبائیں۔
2. استعمال کے مطابق نام دیں، مثلاً “آرڈر سسٹم”۔ معلومات کے لیے صرف پڑھنے اور لائسنس بنانے یا بدلنے کے لیے پڑھنے/لکھنے کا اختیار لیں۔ میعاد 1–365 دن۔
3. محفوظ کرتے ہی مکمل Key نقل کریں؛ یہ صرف ایک بار دکھتی ہے۔ اسے سرور کی نجی ترتیب یا environment variable میں رکھیں۔

پہلی انتظامی درخواست بھیجیں

یہ مثال پروڈکٹ فہرست پڑھتی ہے۔ دیں LICENTIVO_URL لائسنس سرور URL پر اور دیں LICENTIVO_API_KEY ابھی بنائی مکمل key پر، پھر چلائیں:

curl "$LICENTIVO_URL/api/v1/products?limit=25" \
  -H "Authorization: Bearer $LICENTIVO_API_KEY"

یہ Bash/macOS/Linux کی ترکیب ہے۔ Windows PowerShell میں استعمال کریں curl.exe؛ ماحول کا متغیر ہے $env:LICENTIVO_URL اور $env:LICENTIVO_API_KEY۔ نو زبانوں کے مکمل کوڈ یہاں بھی SDK صفحے کا سرور management API Key اختیار۔

کامیابی پر HTTP 200 اور data.items۔ Bearer Key درخواست میں login cookie/CSRF نہیں۔

حقوق اور غیر مؤثر ہونے کا انتظام

صرف پڑھنے کی Key وسائل دیکھتی ہے؛ پڑھنے/لکھنے کی Key مصنوعات، پالیسیاں اور لائسنس بناتی اور بدلتی ہے۔ اکاؤنٹ، ٹیم، نظام ترتیب اور ادائیگی کے لیے مجاز اکاؤنٹ کا login چاہیے، management Key نہیں۔

لیک یا غیر ضروری Key کو console میں منسوخ کریں۔ بدلنے کے لیے Rotate دبائیں؛ پرانی Key فوراً ناکارہ ہو جاتی ہے۔ پھر اپنے سرور کی ترتیب بدلیں۔

پیکیج کا API کوٹا activation، validation، heartbeat اور release گنتا ہے۔ یہاں کی management درخواستیں اس میں شمار نہیں ہوتیں۔

مصنوعات اور لائسنس API

آرڈر کے بعد اپنے سرور سے لائسنس جاری کریں: پہلے پروڈکٹ اور پالیسی، پھر ہر صارف کا لائسنس بنائیں۔ پہلے دو عموماً ایک بار ترتیب دینے ہوتے ہیں۔

پہلے console میں لکھنے کی اجازت والا انتظامی API key۔ نیچے کی مثالوں میں Authorization: Bearer 你的管理Key؛ یہ key فروش کے سرور پر رکھیں۔

activation سے پہلے محدود لائسنس میں،expires_at اور first_activated_at null ہیں۔ پہلی کامیاب activation سے آغاز؛ منتقلی نئی مدت نہیں دیتی۔

مزید انتظام

فہرست صفحات میں limit=25&offset=0، limit زیادہ سے زیادہ 100۔ دیگر ساخت اور دلائل یہاں OpenAPI فائل؛ لائسنس ماڈل کے لیے بائیں کا متعلقہ موضوع دیکھیں۔

SDK لائسنس کالز

زبان اور کارروائی منتخب کرکے SDK کال کریں۔ یہ ایکٹیویشن، ڈیوائس شناخت، دستخط کی تصدیق، کیش، ہارٹ بیٹ اور استعمال کی بکنگ، تصدیق و منسوخی سنبھالتا ہے۔

مثالوں میں client آغاز سے آتا ہے، path برآمد کا راستہ اور exportReport / export_report آپ کا فنکشن ہے۔ گنتی کا jobID ایپ میں محفوظ مستقل ID ہے۔

مکمل کوڈ دیکھیں ← · فوری آغاز · گنتی والے انضمام اور دوبارہ کوشش دیکھیں ←

Heartbeat اور آف لائن رسائی

دونوں لائسنس پالیسی میں ہیں مگر الگ باتیں ہیں: online سرور سے کتنی بار رابطہ، اور رابطہ نہ ہونے پر کتنی مدت استعمال۔

heartbeat وقفہ: تصدیق کتنی بار

heartbeat وقفہ (سیکنڈ) دیں 600, چلتے وقت SDK تقریباً ہر 10 منٹ بعد ہارٹ بیٹ بھیجتا ہے۔ ہر کامیابی پر تازہ قواعد حاصل ہوتے ہیں اور مقامی لائسنس کیش تازہ ہوتا ہے۔

600–86400 سیکنڈ دیں۔ دیں 0 مقررہ ہارٹ بیٹ بند کرتا ہے۔ ایپ دستی تصدیق یا تازہ کاری کر سکتی ہے۔ شیڈول میں 0–10% اتفاقی تاخیر شامل ہوتی ہے؛ وقفہ 600 سیکنڈ سے کم نہیں ہوتا۔

مشین سے منسلک لائسنس کا کیش درست ہو تو رسائی بحال ہوتی ہے اور پس منظر میں آن لائن تصدیق ہوتی ہے، ٹائمر بند ہو تب بھی۔ لازمی آن لائن اور مشترک نشستوں کے لیے سرور کی تصدیق ضروری ہے۔

آف لائن مدت: سرور نہ ملے تو کتنی دیر چلے

آف لائن وضع کے تین انتخاب؛ heartbeat وقفہ نہیں بدلتا۔

مقررہ مدت کی اجازت

24 گھنٹے رکھنے پر آخری کامیاب online validation سے cache زیادہ سے زیادہ 24 گھنٹے درست ہے۔ اس دوران نیٹ یا سرور عارضی بند ہو تو ایپ چلتی ہے۔ اس کے بعد کامیاب online validation چاہیے۔

آف لائن fallback ممنوع

شروع پر سرور سے کامیاب رابطہ چاہیے؛ ناکام درخواست کو disk cache اجازت نہیں دیتا۔ چلتے وقت مختصر دستخط زیادہ سے زیادہ درست ہیں max(10, 心跳间隔) سیکنڈ؛ ایپ تصدیق اور خصوصیت کی اجازت جانچتی رہے۔

مستقل آف لائن استعمال کی اجازت

مقامی دستخط طویل مدت اور نیٹ ناکامی میں بھی اجازت جانچ سکتے ہیں۔ 30 دن کا لائسنس 30 دن بعد ختم ہوگا؛ مستقل offline اسے دائمی لائسنس نہیں بناتا۔

API استعمال کرتا ہے offline_mode ان تین انتخابوں کی ترتیب ہے limited، none، permanent۔ مقرر آف لائن مدت میں،offline_seconds 1–31536000 سیکنڈ؛ دوسرے دونوں میں 0۔

یہ امتزاج کیسے چلتے ہیں؟

آف لائن مدت heartbeat وقفے سے زیادہ رکھیں۔ ہر گھنٹے heartbeat مگر صرف 1 منٹ offline میں دستخط اگلے heartbeat سے پہلے ختم ہوتے ہیں؛ ایپ کو الگ validation چاہیے۔

پالیسی بدلنے سے پرانے لائسنس بدلتے ہیں؟

ہاں۔ heartbeat یا offline ترتیب بدلنے پر متعلقہ پرانے اور نئے لائسنس اگلی کامیاب activation، validation یا heartbeat میں نئے قواعد لیتے ہیں۔ SDK دستخط شدہ cache بدلتا ہے۔ اسی Idempotency-Key کی retry اصل نتیجہ ہی دیتی ہے۔

آف لائن آلہ پہلے دستخط شدہ قواعد استعمال کرتا ہے۔ صرف نیٹ واپس آنے سے cache نہیں بدلتا؛ ایک درخواست کامیاب ہونی چاہیے۔ ایپ نیٹ واپسی پر خود refresh کر سکتی ہے۔

براہ راست آن لائن refresh

یہ طریقے ہمیشہ سرور کی کوشش کرتے ہیں، مستقل offline اور heartbeat بند ہونے پر بھی۔ کامیابی دستخط تازہ کرتی ہے؛ نیٹ ناکامی refresh error دیتی مگر درست cache رکھتی ہے۔ واضح منسوخی یا release پر cache مٹتا ہے۔

کامیاب refresh ایک activation API درخواست شمار ہوتا ہے۔ پالیسی پہلے بند heartbeat کو کھولے تو اپنی زبان کا StartHeartbeat بلائیں۔ آف لائن آلہ منسوخی یا release کی تازہ خبر نہیں لیتا۔

آلات کی پابندی

ایک آلے کے لائسنس میں ایپ اور cache دوسرے عام کمپیوٹر پر نقل کرنے سے اصل اجازت منتقل نہیں ہوتی۔

SDK کمپیوٹر کیسے پہچانتا ہے؟

ہر آغاز پر SDK نظام شناخت اور product ID سے device hash بناتا ہے۔ سرور کے دستخط میں hash شامل ہے اور مقامی جانچ بھی اسے ملاتی ہے۔

Windows سے MachineGuid، Linux سے machine-id، macOS سے IOPlatformUUID پڑھتا ہے۔ اصل شناخت نہیں، صرف حساب شدہ hash بھیجتا ہے۔ پرانی config کا device_id اصل مقامی شناخت نہیں بدلتا۔

آلے A کی فائلیں B میں نقل ہوں تو کیا ہوگا؟

1. A فعال ہو کر اپنی hash سے بندھا دستخط پاتا ہے۔
2. B اپنی شناخت سے الگ hash، A کا cache رد کرتا ہے۔
3. B کی online activation لازم ہے۔ حد 1 ہو اور A بندھا ہو تو سرور B کو رد کرتا ہے۔

گاہک کمپیوٹر کیسے بدلے؟

صارف پرانا کمپیوٹر کھولے پھر نیا فعال کرے۔ پرانا خراب ہو تو console کے Device activations میں بندھن چھوڑیں۔ کمپیوٹر بدلنے سے لائسنس میعاد دوبارہ شروع نہیں ہوتی۔

نظام دوبارہ نصب کرنے سے شناخت بدل سکتی ہے اور نئے آلے کی activation چاہیے۔ مکمل OS clone، جعلی شناخت یا بدلا client زیادہ مضبوط حملے ہیں؛ صرف device hash ان سے حفاظت کی ضمانت نہیں۔

طویل offline میں A کے پرانے دستخط release فوراً نہیں جانتے؛ کامیاب سرور درخواست حالت بدلتی ہے۔ offline مدت جتنی زیادہ، دور کی پابندی اتنی دیر سے لاگو۔

SHA256(UTF8(
  "LicenovaDevice/v2\n"
  + lower(product_id) + "\n"
  + lower(trim(OS_machine_identity))
))

کوٹا اور بلنگ

آلہ کوٹا استعمال شدہ آلات، API کوٹا کامیاب درخواست گنتا ہے۔ دونوں الگ؛ آلہ تعداد سے API استعمال نہیں نکلتا۔

کون سے عمل API کوٹے میں گنے جاتے ہیں؟

بار بار درخواست سے آلہ بار بار گنا جاتا ہے؟

نہیں۔ ایک دور میں اسی پروڈکٹ کا وہی آلہ ایک بار، مگر ہر کامیاب heartbeat ایک API استعمال ہے۔ release پچھلا استعمال نہیں مٹاتا۔

مثلاً 100 آلات، روز 8 گھنٹے، ماہ 22 دن، ہر 10 منٹ heartbeat۔ صرف heartbeat کی تعداد 105,600 کالز۔ 100 activation اور ہر آلے کی روز ایک زائد تصدیق سے کل 107,900 کالز۔

زائد تصدیق مثال کا مفروضہ؛ اصل تعداد ایپ کے مطابق۔ یہاں آن لائن استعمال کا اندازہ آلات، اجرا مدت اور وقفہ بدلیں۔

پیکیج سے زائد کا خرچ کیسے؟

100,000 API شامل اور اضافی 0.0001 USD ہو: 120,000 کامیاب کال میں 20,000 اضافی، API فیس 2 USD۔

اضافی استعمال admin قیمت پر balance سے کٹتا ہے۔ مجموعی رقم cents میں round، صرف نئی بڑھت کٹتی ہے؛ چھوٹی فی کال قیمت کی بار بار rounding فیس نہیں۔

اضافی آلہ فیس الگ: اضافی تعداد × فی آلہ قیمت۔ سخت حد کے بعد متعلقہ اضافی درخواست رد؛ رقم کم ہو تو اگلی قابل ادائیگی درخواست بھی رد۔ رد درخواست استعمال نہیں بڑھاتی۔

لامحدود API میں اضافی فیس نہیں۔ صفر میں مفت کال نہیں، پہلی کامیاب درخواست سے اضافی قاعدہ۔ کوٹا، قیمت اور حد دیکھیں موجودہ پیکیج، یہ اعداد صرف مثال ہیں۔

پیکیج کی مدت اور کوٹہ کب شروع ہوتے ہیں؟

1، 3، 6 یا 12 ماہ خریدیں۔ کل رقم ایک بار ادا کریں؛ کامیاب ادائیگی پر پیکیج شروع ہو گا۔

فعالیت سے ماہانہ کوٹہ تجدید ہوتا ہے۔ 31 جنوری سے آغاز ہو تو فروری کے آخری دن، پھر 31 مارچ۔ باقی کوٹہ جمع نہیں ہوتا۔

خرید نہ ہو تو administrator اصول UTC ماہ میں۔ آلہ فیس ماہانہ بل، API اضافی فوراً balance سے۔ خرید کے بعد اپنی مدت کا کوٹا، default ساتھ جمع نہیں۔

کوٹا یا رقم کم سے درخواست رد ہو تو پرانے offline دستخط اصل قاعدے پر درست رہتے ہیں۔ فروش console سے آلہ چھوڑ سکتا ہے، runtime API کوٹا نہیں لگتا۔

فلوٹنگ نشستیں

floating لائسنس بیک وقت چلنے والے پروگرام محدود کرتا ہے۔ باری باری استعمال کے لیے موزوں، ہر کمپیوٹر کا الگ لائسنس لازم نہیں۔

مثال

100 کمپیوٹر اور 10 نشست ہوں تو پہلے 10 پروگرام چلتے، 11واں “نشست بھر گئی” لیتا ہے۔ پروگرام اور SDK معمول سے بند ہوں تو دوسری ایپ نشست لے سکتی ہے۔ ایک کمپیوٹر کے دو پروگرام بھی دو نشست لیتے ہیں۔

پالیسی میں دیں

فلوٹنگ نشستیں اور حد 10 چنیں۔ ہارٹ بیٹ وقفہ کم از کم 600 سیکنڈ؛ لیز زیادہ، مثلاً 1200 سیکنڈ۔ ہارٹ بیٹ تجدید کرتا ہے؛ کریش یا رابطہ ٹوٹنے پر لیز ختم ہو تو نشست آزاد ہوتی ہے۔

floating لائسنس lease میں مختصر رابطہ بندش دیتا ہے۔ offline وقت بھی lease تک؛ مستقل offline یا فائل سے مکمل offline پہلی activation نہیں۔

ایپ کوڈ میں مزید کیا سنبھالیں؟

Open/Start اور معمول کا close لیں۔ SDK ہر client کے لیے الگ session ID بناتا ہے۔ ہر export کا نیا client نہیں؛ پروگرام بند ہونے تک ایک رکھیں۔

پرانا floating cache اگلے آغاز پر نشست خود بحال نہیں کرتا۔ lease ختم ہو تو دوبارہ activation اور نشست لینے کے بعد کام کریں۔

آف لائن فعالیت

مکمل offline کمپیوٹر کی پہلی activation کے لیے درخواست فائل اور دستخط شدہ جواب لیں۔ USB سے درخواست online کمپیوٹر تک لے جائیں۔

مراحل

1. ہدف کمپیوٹر میں SDK ترتیب لیں، OfflineRequest("activate") بلائیں اور فائل رکھیں۔ بنانے کے لیے سرور نہیں چاہیے۔
2. online کمپیوٹر کے console میں Offline file activation کھولیں، درخواست upload اور جواب download کریں۔ آخری صارف اپنے portal میں بھی کر سکتا ہے۔
3. جواب واپس لا کر ImportOffline میں اصل درخواست اور جواب دیں۔ SDK دستخط، request ID، ورژن اور آلہ شناخت جانچ کر cache رکھتا ہے۔
4. CheckFeature سے اجازت دیکھیں۔ offline کمپیوٹر کو online heartbeat نہیں؛ مدت لائسنس پالیسی طے کرتی ہے۔

فائل activation صرف offline کی اجازت والی device-bound لائسنس میں ہے۔ درخواست 30 دن درست۔ عارضی لائسنس سرور منظوری سے شروع ہوتا ہے، کیونکہ جواب import کا وقت سرور نہیں جانتا۔

آف لائن علیحدگی کیسے؟

اصل کمپیوٹر میں OfflineRequest("deactivate") بنائیں۔ SDK پہلے cache مٹاتا؛ پھر فروش یا portal کو دیں۔ مٹانا پرانی نقل نہ ہونے کا ثبوت نہیں۔ فوری روک کے لیے باقاعدہ online جانچ کی پالیسی لیں۔

ہر زبان کے نام

C میں واپس متن ln_free_string سے آزاد کریں۔ جواب فائل کا اپنا مواد دیں، web API کا بیرونی data wrapper نہیں۔

خصوصیات کے استعمال کی حد

برآمد کی اجازت اور ماہانہ ۵۰۰ برآمد الگ اصول ہیں۔ RunFeature اجازت جانچتا ہے؛ RunMeteredFeature کامیابی کے بعد استعمال کی تصدیق کرتا ہے۔

ماہ میں 500 export دیں

پالیسی میں export اور کوٹا دیں: export، 500، ماہانہ۔ ختم پر اصل قاعدہ رد کرتا ہے۔ اضافی اجازت کی زیادہ حد دیں؛ نظام اضافی استعمال آپ کے آرڈر سسٹم کے لیے گنتا ہے۔

روزانہ اور ماہانہ کوٹا UTC نصف شب reset؛ مجموعی نہیں۔ حد بدلنے سے پچھلا استعمال نہیں مٹتا۔

کامیاب برآمد کے بعد استعمال کی تصدیق

اپنی کارروائی SDK کو دیں۔ نئے کام کے لیے نیا ID؛ دوبارہ کوشش میں وہی ID، خصوصیت اور مقدار رکھیں۔ مختلف پراسیس ایک ID بیک وقت نہ چلائیں۔

پہلے export کوٹا مقرر کریں۔ Windows میں -Metered -OperationID export-job-001 یا Linux/macOS میں --metered --operation-id export-job-001 شامل کریں۔

جواب کے فیلڈ کیسے سمجھیں؟

درخواست، جواب اور فیلڈ کی اقسام کے لیے رن ٹائم API میں Reserve، Commit اور Cancel دیکھیں۔

Consume فوراً استعمال شمار کرتا ہے۔ ناکام کام نہ کٹے تو محفوظ مقدار لیں۔ خصوصیت کے تمام شمار آن لائن ہیں اور پلیٹ فارم کے چار قابل بل API عمل میں شامل نہیں۔

ورژن اور دیکھ بھال

دائمی خرید استعمال جاری رکھتی ہے، لازماً ہمیشہ مفت upgrade نہیں۔ maintenance مدت اشاعت کی تاریخ سے قابل استعمال ورژن طے کرتی ہے۔

موجودہ نسخہ خریدیں، سال بھر تازہ نسخے شامل

پالیسی دائمی اور maintenance 365 دن، پہلی activation سے آغاز۔ Software versions میں 1.0.0، 1.1.0 وغیرہ اصل اشاعت تاریخ سے دیں۔

maintenance میں شائع ورژن چلتے رہتے ہیں۔ بعد کے نئے ورژن رد، پرانے چلتے ہیں۔ تجدید پر لائسنس کے Rights and customer میں مدت بڑھائیں۔

ایپ اپنا نسخہ کیسے بھیجتی ہے؟

sdk-demo.json میں app_version مثلاً 1.1.0 دیں۔ maintenance ہو تو پہلے console میں شائع کریں۔ صرف تین نمبروں جیسے 1.2.3 کی شکل ہے۔ فروخت شدہ حقوق بچانے کو اشاعت تاریخ نہیں بدل سکتی۔

صرف 1.x کے لیے 1.0.0–1.999.999 دیں، maintenance کے بغیر۔ update کے بعد online نئے ورژن کا دستخط لیں؛ پرانا cache نئے ورژن کو اجازت نہیں دیتا۔

ڈاؤن لوڈ دیں

ورژن ریکارڈ میں HTTPS download اور SHA-256 دیں۔ portal صرف اہل ورژن دکھاتا ہے۔ یہ link دیتا ہے، installer upload یا خودکار update نصب نہیں کرتا۔

صارف پورٹل

صارف فروش console کے بغیر لائسنس اور آلات دیکھ سکتا اور بندھن کھول سکتا ہے۔

فروش پہلے گاہک کا ای میل جوڑتا ہے

اجرا پر ای میل یا حقوق اور گاہک میں دیں۔ بھیجیں صارف پورٹل صارف کو دیں۔ اس email پر ایک بار کا login link ملتا ہے، 15 منٹ درست۔ login session 24 گھنٹے رہتا ہے۔

صارف صرف اسی email کے لائسنس دیکھتا ہے، پروڈکٹ انتظام، بل یا دوسرے صارف کا ڈیٹا نہیں۔ پہلے administrator ترتیب میں email خدمت لگائیں۔

کمپیوٹر بدلتے وقت اصل key گم ہو تو؟

1. صارف لائسنس سے متعلق email دیتا اور login link کھولتا ہے۔ یہ صرف login ہے، آلے کا بندھن نہیں کھولتا۔
2. میرے آلات/سیشن میں پرانا چن کر علیحدگی/منتقلی تصدیق۔
3. صفحے پر عارضی کوڈ ہے، زیادہ سے زیادہ 15 منٹ اور ایک کامیاب activation کے لیے۔ صارف نقل یا اپنے email پر ارسال منتخب کر سکتا ہے۔
4. نئے کمپیوٹر میں ایپ کھول کر activation پر عارضی کوڈ دیں۔ SDK کمپیوٹر پہچان کر اصل لائسنس باندھتا اور سند رکھتا ہے۔ restart اور heartbeat سند لیتے ہیں؛ کوڈ ختم ہونے سے فعال کمپیوٹر متاثر نہیں۔

صرف آلہ بندھن بدلتا ہے۔ لائسنس ID، اصل میعاد، خصوصیات، صارف اور استعمال برقرار؛ نیا لائسنس نہیں۔ نئے آلے کو اصل پالیسی اور خالی آلہ جگہ چاہیے۔

سافٹ ویئر فروش کیا بدلے؟

موجودہ SDK لیں۔ license key والا فیلڈ یہ بھی لیتا ہے lv_tmp_ عارضی کوڈ؛ config میں دیں license_key کافی ہے؛ Start، تصدیق اور ہارٹ بیٹ معمول کے مطابق کام کرتے ہیں۔ SDK نجی کیش میں آلے کی سند رکھتا ہے؛cache_path خالی ہو سکتا ہے۔ فائل موجودہ صارف کے ایپ ڈیٹا میں رکھیں؛ انسٹالر کے ساتھ نہ دیں۔

کامیاب تبادلے کے بعد ایپ صاف کر سکتی ہے license_key خالی؛ وہی پروڈکٹ، public keys اور cache_path، restart پر SDK آلے کی سند بحال کرتا ہے۔ صارف کو عارضی کوڈ رکھنا یا دوبارہ لکھنا نہیں۔ تبادلے کی کامیابی تک input رکھیں تاکہ رابطہ ٹوٹنے پر retry ہو سکے۔

کوڈ ختم یا صفحہ بند ہو

portal میں دوبارہ غیر استعمال شدہ کوڈ دیکھیں۔ ختم ہو تو چھوڑے آلے کے پاس View/get activation code سے پھر لیں؛ نئی منتقلی شمار نہیں۔ استعمال شدہ کوڈ دوبارہ یا پرانے ریکارڈ سے بار بار لے کر حد نہیں ٹلتی۔ اگلی منتقلی کے لیے موجودہ فعال آلہ کھولیں۔

نیا کمپیوٹر مکمل آف لائن ہو تو

نئے کمپیوٹر میں عارضی کوڈ دے کر SDK درخواست نکالیں۔ کوڈ ختم ہونے سے پہلے online کمپیوٹر کے portal سے جواب لیں اور نئے میں import کریں۔ پالیسی offline device-bound activation دے۔ اصل مدت برقرار؛ جواب میں آلے کی اجازت اور سند ہے، محفوظ رکھیں۔

علیحدگی کی حد اور پرانا کمپیوٹر

پالیسی میں ہر لائسنس فی UTC ماہ self-release حد دیں۔ صفر نیا portal unbind بند کرتا ہے۔ بار بار click، کوڈ دیکھنا یا ختم غیر استعمال کوڈ دوبارہ لینا اضافی شمار نہیں۔ حد portal اور صارف offline release پر ہے، فروش manual یا اصل license key کی software release پر نہیں۔

دور سے بندھن کھولنا اگلی online جانچ روکتا ہے۔ پرانا offline cache رابطے یا میعاد تک رہتا ہے۔ مستقل cache فوراً دور سے بند نہیں ہو سکتا؛ جلد منسوخی کے لیے online وقفے رکھیں۔ دوسرے کمپیوٹر پر عام config، سند اور cache نقل مختلف شناخت سے رد ہوتی ہے۔

customer portal لائسنس استعمال سنبھالتا ہے۔ سافٹ ویئر آرڈر اور فروخت کی وصولی فروش کے اپنے نظام میں رہتی ہے۔

واقعات کی اطلاعات

activation، تجدید یا منسوخی پر Licentivo آپ کے سرور کو خبر دے کر آرڈر، صارف اور support نظام ملا سکتا ہے۔

اطلاع کا پتہ شامل کریں

لائسنس event notifications میں HTTPS پتہ اور event دیں۔ دستخط secret محفوظ کرنے پر ایک بار دکھتا ہے، وصول سرور میں رکھیں۔ production میں مقامی یا نجی نیٹ پتہ نہیں۔

وصولی کے بعد دستخط جانچیں

X-Licentivo-Timestamp، X-Licentivo-Event اور اصل body پڑھیں۔ timestamp + '.' + event ID + '.' + body پر secret سے HMAC-SHA256 بنائیں۔ sha256= لگا کر X-Licentivo-Signature سے مستقل وقت میں ملائیں۔ موجودہ وقت سے 5 منٹ زیادہ فرق رد کریں۔

event ID سے نقل الگ کریں۔ دستخط جانچ کر transaction یا queue میں مستقل رکھیں پھر 2xx دیں۔ دوبارہ event پر 2xx دیں، آرڈر کارروائی پھر نہیں۔

ناکامی پر کیا ہوتا ہے؟

خودکار 8 کوشش تک، وقفہ بڑھتا ہے۔ console میں HTTP حالت، وقت، خرابی اور دستی re-delivery۔ event اور لائسنس ایک transaction میں؛ restart کے بعد ارسال جاری۔

بنانا، update، تجدید، منسوخی، activation، release، خصوصیت استعمال، جلد میعاد، میعاد اور maintenance بدلنے کے event۔ اطلاع صرف لائسنس prefix، مکمل کلید نہیں۔

اجتماعی کارروائیاں اور پالیسی کی تبدیلی

ایک گروہ کے لائسنس اکٹھے جاری، تجدید یا منسوخ کریں۔ پرانے حقوق بدلنے سے پہلے اثر دیکھیں۔

اجتماعی اجرا یا درآمد

Licenses میں Batch issue/import، پروڈکٹ اور پالیسی لیں۔ ہر سطر نام اور email یا customer,customer_email والا CSV دیں۔ زیادہ سے زیادہ 100 سطر۔ نتیجہ download اور مکمل کوڈ رکھیں۔

ایک شے ناکام تو پوری batch نافذ نہیں۔ timeout پر اسی مواد سے retry؛ request ID اصل نتیجہ دیتا ہے، دوبارہ جاری نہیں۔

اجتماعی تجدید یا منسوخی

بائیں لائسنس منتخب پھر Batch renew یا revoke۔ header کا خانہ موجودہ صفحہ، صفحے بدلنے پر انتخاب رہتا، حد 100۔ filter بدلنا، صفحہ چھوڑنا یا refresh انتخاب مٹاتا ہے۔

تجدید کے اضافی دن دیں۔ غیر فعال کی مدت، فعال کی اصل آخری تاریخ، ختم کی اب سے بڑھتی ہے۔ منسوخی سے پہلے انتخاب کھول کر صارف دیکھیں؛ واپس نہیں ہو سکتی۔ read-only رکن نہیں کر سکتا۔

پرانے لائسنس پر نئی پالیسی لگائیں

1. لائسنس پالیسی میں نئے قواعد محفوظ کریں۔
2. ایک پروڈکٹ کے پرانے لائسنس چنیں، پالیسی لگائیں اور نئی پالیسی دیں۔
3. مدت، آلہ/نشست، خصوصیات، استعمال اور maintenance تبدیلی دیکھیں۔ نشست نئی حد سے زیادہ یا mode بدلنے پر فعال آلہ ہو تو پہلے آلات حل کریں۔
4. تصدیق پر نافذ کریں۔ اگلی online جانچ نیا دستخط دیتی ہے؛ مکمل offline cache دور سے نہیں بدلتا۔

preview 10 منٹ درست۔ لائسنس یا پالیسی بدلے تو پھر دیکھیں۔ نئے دن اصل پہلی activation سے میعاد گنتے ہیں؛ پہلے تاریخ جانچیں۔

عام سوالات

پہلے خرابی کوڈ، پھر متعلقہ ترتیب دیکھیں۔ جواب کا request_id logs میں عمل تلاش؛ مکمل key logs یا تصویر میں نہیں۔

activation ناکام ہو تو کیا جانچیں؟

سرور تک رسائی، درست product ID، مکمل کوڈ اور اسی پروڈکٹ کا لائسنس دیکھیں۔ سرور نصب ہونے سے پہلے صارف کا کمپیوٹر آپ کا 127.0.0.1 پتہ؛ یہ صارف کا اپنا کمپیوٹر ظاہر کرتا ہے۔

آف لائن بھی کیوں چلتا ہے؟

offline بھی SDK مقامی دستخط، پروڈکٹ، آلہ، خصوصیات اور میعاد جانچتا ہے؛ صرف سرور درخواست نہیں کرتا۔ cache ختم یا online منسوخی/release کی واضح تردید مزید استعمال روکتی ہے۔

دستخط یا آلے کی تصدیق کیوں ناکام ہے؟

public key کا نہ ملنا، دوسرے پروڈکٹ کا cache یا دوسرے کمپیوٹر پر نقل کردہ cache ناکامی کا سبب بن سکتے ہیں۔ دیکھیں trusted_keys کا key ID اور public key موجودہ پروڈکٹ کے ہیں؛ پھر دیکھیں نظام بدلا یا دوبارہ نصب ہوا ہے۔

SDK بتاتا ہے clock rollback : گھڑی پیچھے تو نہیں؛ درست کر کے آن لائن refresh۔

مکمل خرابی جواب

{
  "error": {
    "code": "LICENSE_REVOKED",
    "message": "License was revoked"
  },
  "request_id": "99999999-9999-4999-8999-999999999999"
}

400/415: فیلڈ یا Content-Type درست کریں؛ 401: management Key دیکھیں؛ 403: متعلقہ لائسنس خرابی حل کریں؛ 409: کوٹا، session یا idempotency تضاد دیکھیں؛ 429: Retry-After کے مطابق رکیں۔ timeout یا 5xx کو وقفے سے دہرائیں۔ لکھنے میں اصل ID اور body رکھیں تاکہ دو بار شمار نہ ہو۔

JSON جواب کیسے پڑھیں؟

کامیاب جواب data اور request_id؛ ناکامی پر error.code، error.message اور request_id۔ خرابی کوڈ اور request_id سے اکثر مسئلے ملتے ہیں۔

ای میل، ادائیگی، deployment کے لیے دیکھیں مدد اور مسئلے کی تشخیص۔