async). في .NET Framework، استخدم C# 11 أو إصدارًا أحدث. راجع نظرة عامة على حزم SDK للخادم لمعرفة ما تشترك فيه جميع حزم SDK.
التثبيت
Didit.Extensions.DependencyInjection وسجّل العميل باستخدام services.AddDidit().
الحزمتان هما Didit وDidit.Extensions.DependencyInjection على NuGet. مصدرهما وسجل التغييرات موجودان في didit-protocol/sdk-dotnet على GitHub.
إعداد العميل
يقرأnew DiditClient() القيمة DIDIT_API_KEY من متغيرات البيئة. مرّر DiditClientOptions لتجاوز هذه القيمة، أو لتعيين معرّفات المؤسسة والتطبيق التي تحتاجها الاستدعاءات الخاصة بنطاق التطبيق (الحالات والشبكات والتقارير التنظيمية). أنشئ عميلًا واحدًا وأعد استخدامه.
required، لذلك يفشل التجميع إذا غابت إحداها. الخصائص الاختيارية التي تتركها دون تعيين لا تُرسل.
إنشاء جلسة
أنشئ جلسة تحقق لسير عمل، ثم أرسل المستخدم إلى عنوان URL الخاص بها.قراءة القرار
عندما ينتهي المستخدم (أو عندما يصل الـ webhook)، اقرأ القرار. نتيجة كل ميزة هي قائمة تحتوي على إدخال واحد لكل عقدة في سير العمل.التحقق من webhook
مرّر الجسم الخام كما وصل تمامًا، ومرّر طريقة لقراءة رؤوس الطلب. تُطلقDiditWebhooks.Verify الاستثناء WebhookVerificationException لأي إرسال غير صالح أو قديم، وتعيد حدثًا مُحددَ النوع في الحالات الأخرى.
StreamReader ومرّر name => request.Headers[name].FirstOrDefault(). أثناء تدوير السر، مرّر الاثنين معًا: new[] { newSecret, oldSecret }. راجع Webhooks للاطلاع على الأحداث ومخطط التوقيع.
فحص المعاملة
أرسل الدفعة أو السحب أو التحويل بالعملات الرقمية إلى مراقبة المعاملات؛ تتضمن الاستجابة حالتها ودرجة المخاطر.التحقق من رموز token الخاصة بـ Authentication
تتحققAuthentication من رموز token للوصول التي يوقّعها مُصدر Authentication الخاص بك، داخل الخادم الخلفي، دون استدعاء Didit في كل طلب. كما تستبدل الرموز، وتحدّث رموز token، وتتحقق من الجلسات وتلغيها، وتشغّل عمليات رفع مستوى التحقق.
يُجري التحقق من token الفحوصات الواردة في التحقق من token على الخادم، مقابل مُصدر تطبيقك ومفاتيح التوقيع الخاصة به.