تنزيل demo twilio backend nodejs - تنزيل كود المصدر demo twilio backend nodejs

demo twilio backend nodejs

كود الذكاء الاصطناعي

1.0.0

تنزيل

نموذج Twilio للواجهة الخلفية لـ Node.js

يحتوي هذا المستودع على نموذج للتعليمات البرمجية الخلفية التي توضح كيفية الجمع بين توليد Virgil وTwilio JWT، والتي يتم استخدامها للمصادقة مع خدمات Virgil وTwilio.

لا تستخدم هذه المصادقة في الإنتاج. يجب السماح بالطلبات المقدمة إلى نقطتي النهاية /virgil-jwt و/twilio-jwt للمستخدمين المصادق عليهم. استخدم استراتيجية ترخيص التطبيق الخاص بك.

المتطلبات الأساسية

NodeJS من 10 إلى 13

إعداد وتشغيل العرض التوضيحي

استنساخ

استنساخ المستودع من جيثب.

 $ git clone https://github.com/VirgilSecurity/twilio-sample-backend-nodejs.git

احصل على أوراق اعتماد فيرجيل

إذا لم يكن لديك حساب بعد، قم بالتسجيل للحصول على واحد باستخدام البريد الإلكتروني الخاص بك.

يمكنك تنزيل ملف .env جاهز للاستخدام

انتقل إلى لوحة معلومات Virgil -> تطبيقك -> قسم E3Kit.
قم بإنشاء .env في قسم ملف .env .
قم بتنزيل الملف الذي تم إنشاؤه، والصقه في المجلد الجذر للمشروع وأعد تسميته إلى .env .

أو يمكنك إضافة المعلمات يدويًا:

لإنشاء Virgil JWT، القيم التالية مطلوبة:

اسم متغير	وصف
APP_ID	معرف تطبيق فيرجيل الخاص بك.
APP_KEY	المفتاح الخاص لتطبيقك المستخدم لتوقيع JWTs.
APP_KEY_ID	معرف مفتاح التطبيق الخاص بك. قيمة سلسلة فريدة تحدد حسابك في Virgil Cloud.

انسخ وأعد تسمية .env.example إلى .env .
قم بإنشاء تطبيق في لوحة معلومات Virgil، وانسخ APP_ID الخاص به إلى ملف .env ؛
أنشئ مفتاح التطبيق واحفظ قيمة المفتاح الخاص به في سطر APP_KEY في ملف .env ؛
انسخ معرف المفتاح الذي تم إنشاؤه إلى سطر APP_KEY_ID في ملف .env ؛

احصل على بيانات اعتماد Twilio

لإنشاء Twilio JWT، تكون القيم التالية مطلوبة:

اسم متغير	وصف
TWILIO_ACCOUNT_SID	معرف حساب Twilio الأساسي الخاص بك - ابحث عنه في وحدة التحكم هنا.
TWILIO_API_KEY_SID	SID لمفتاح Twilio Api. يستخدم للمصادقة على خدمات Twilio. تم إنشاؤها باستخدام TWILIO_API_SECRET
TWILIO_API_SECRET	سر مفتاح Twilio API: قم بإنشاء واحد هنا
TWILIO_SERVICE_SID	مثيل خدمة حيث يتم تخزين جميع البيانات الخاصة بتطبيقنا وتحديد نطاقها. قم بإنشاء واحد في وحدة التحكم هنا.

أضف هذه المعلمات إلى ملف .env الخاص بك.

تثبيت التبعيات وتشغيل الخادم

 $ npm install
$ npm run start

الآن، استخدم رمز العميل الخاص بك لتقديم طلب للحصول على JWT من نموذج الواجهة الخلفية الذي يعمل على http://localhost:3000.

إلى جانب الواجهة الخلفية، نقدم عرضًا توضيحيًا لدردشة عميل بسيطة تتفاعل مع Virgil API، والتي يمكنك رؤيتها إذا انتقلت إلى http://localhost:3000 في متصفحك. يوجد نموذج رمز الدردشة في الدليل public .

لقطة شاشة تجريبية

مواصفة

/ مصادقة نقطة النهاية

تعتبر نقطة النهاية هذه مثالاً على مصادقة المستخدمين. يأخذ identity المستخدم ويستجيب برمز فريد.

 POST https://localhost:3000/authenticate HTTP/1.1
Content-type: application/json;

{
    "identity" : " string "
}

Response:

{
    "authToken" : " string "
}

/virgil-jwt نقطة النهاية

تتحقق نقطة النهاية هذه مما إذا كان الطلب قد تمت مصادقته بواسطة رأس التفويض. فهو يأخذ authToken الخاص بالمستخدم، ويبحث عن هوية المستخدم ذات الصلة وينشئ virgilToken (وهو JSON Web Token) بهذه identity في حمولة. استخدم هذا الرمز المميز لإجراء مكالمات API معتمدة إلى Virgil Cloud.

 GET https://localhost:3000/virgil-jwt HTTP/1.1
Content-type: application/json;
Authorization: Bearer <authToken>

Response:

{
    "virgilToken" : " string "
}

/twilio-jwt نقطة النهاية

تمامًا مثل نقطة نهاية الرمز المميز لـ Virgil، يجب حماية نقطة نهاية Twilio والاستجابة باستخدام twilioToken .

 GET https://localhost:3000/twilio-jwt HTTP/1.1
Content-type: application/json;
Authorization: Bearer <authToken>

Response:

{
    "twilioToken" : " string "
}

جيل فيرجيل JWT

لإنشاء Virgil JWT، تحتاج إلى استخدام فئة JwtGenerator من Virgil SDK.

 const virgilCrypto = new VirgilCrypto ( ) ;

const generator = new JwtGenerator ( {
  appId : process . env . APP_ID ,
  apiKeyId : process . env . API_KEY_ID ,
  apiKey : virgilCrypto . importPrivateKey ( process . env . API_PRIVATE_KEY ) ,
  accessTokenSigner : new VirgilAccessTokenSigner ( virgilCrypto )
} ) ;