حالات استخدام فعلية: توسيع نظام المصادقة الخاص بك باستخدام الويب هوكس

مع ويب هوك من Logto، يمكنك تلقي تحديثات في الوقت الفعلي حول أحداث معينة، مثل تسجيل المستخدم، تسجيل الدخول، أو إعادة تعيين كلمة المرور، دون التحقق المستمر من التحديثات. عند حدوث حدث، يقوم Logto بإرسال طلب HTTP يحتوي على معلومات حول الحدث إلى عنوان نهاية تحدده. يمكن لتطبيقك تلقي الطلب واتخاذ إجراءات مخصصة بناءً على البيانات، مثل إرسال بريد إلكتروني أو تحديث قاعدة بيانات.\n\nهناك بعض القدرات التي قد لا تجدها مباشرة في لوحة تحكم Logto، ولكن يمكنك النظر فيما إذا كان يمكنك استخدام الويب هوك لمراقبة سلوك المستخدم لتحقيقها.\n\n## سيناريوهات استخدام ويب هوكس من Logto\n\nيوفر ويب هوك إمكانيات غير محدودة لأنظمة Auth. إليك بعض حالات الاستخدام الواقعية التي سأقدم لك أمثلة عنها:\n\n### 1. إرسال البريد الإلكتروني أو الإشعارات\n\n> "هل يمكنني استخدام Logto Email لإرسال رسالة ترحيب مخصصة للمستخدمين مع رابط تسجيل الدخول؟ نحن نستخدم تسجيل الدخول برمز التحقق فقط، دون كلمات مرور."\n> \n\nعلى الرغم من أن خدمة البريد الإلكتروني من Logto لا تدعم حاليًا إرسال رسائل الترحيب مباشرة، إلا أن هذا سيناريو كلاسيكي للويب هوكس. استخدم حدث User.Created، وعندما يتلقى عنوان نهاية البيانات تسجيل المستخدم، قم بإرسال رسالة ترحيب إلى بريد المستخدم الإلكتروني فورًا. \n\nبالمثل، اتخذ إجراءات لإخطار المستخدمين بعد تحديث الأدوار، أطلع المدراء على الأعضاء الجدد، أو أرسل رسائل بوت إلى Slack أو Discord للحفاظ على تحديث فريقك.\n\n### 2. مزامنة البيانات\n\n> "إذا حذفت مستخدمًا في لوحة الإدارة، كيف يمكنني مزامنة ذلك مع الأنظمة الأخرى؟"\n> \n\nاستخدم حدث User.Deleted للحصول على تغيير الحالة للمستخدم المحذوف ومزامنته مع الأنظمة الأخرى. يمكنك أيضًا مسح جلسة تسجيل دخول المستخدم فورًا، مما سيكون مفيدًا لإدارة المستخدمين عبر التطبيقات.\n\n> "لدي عدة تطبيقات تحت مستأجر Logto الخاص بي. أحتاج إلى ويب هوك لاكتشاف إنشاء المستخدم، لضمان معالجته بواسطة تطبيق معين."\n> \n\nاستخدم الحدث PostRegister، وسيحتوي الحمولة على معلومات AppId، مما سيساعدك في تصميم تجربة شخصية لخدمات التطبيقات المتعددة.\n\n### 3. تنفيذ نداءات API إضافية\n\n> "عند تغيير أذونات المستخدم، عليهم تسجيل الخروج ثم تسجيل الدخول مرة أخرى لتأخذ التحديثات مفعولها. هل يمكن أن يحدث ذلك تلقائيًا؟"\n\nإذا قام المدير بتغيير دور المستخدم أو إضافة أذونات جديدة للمستخدم، فإن المستخدم يحتاج افتراضيًا إلى تسجيل الدخول مرة أخرى أو الموافقة على تحديث الرمز الوصول. إذا كنت ترغب في أن يؤخذ تغيير التفويض بشكل فوري، يمكنك استخدام ويب هوك User.Data.Updated للإشعار، وتمكين إعادة الموافقة أو إصدار رموز وصول جديدة وفقًا لذلك.\n\nبالإضافة إلى ذلك، يمكنك استخدام أوقات انتهاء صلاحية قصيرة لرمز الوصول أو استدعاء نقاط نهاية Management API دوريًا للحصول على أدوار المستخدم والأذونات، ولكن فقط من خلال الويب هوكس يمكنك الحصول على التحديثات الأكثر توقيتًا.\n\n> "أريد إضافة كل مستخدم جديد إلى قاعدة البيانات الخاصة بي، إرساله إلى صفحة 'إعداد مؤسستك'، والسماح بدعوات المؤسسة فقط للمستخدمين الأوليين. هل يمكن أن يدعم Logto هذا؟"\n\nأولاً، يتطلب مزامنة البيانات، لاستخدام ويب هوك Post.Register لإضافة المستخدم الجديد إلى قاعدة البيانات الخاصة بك. ثم، استخدم Logto management API لتصميم صفحة الإعداد لمؤسسة ودعوة.\n\n### 4. تحليل البيانات\n\n> "هل يمكنني توصيل Logto بأداة تحليلات (Google Analytics, Umami, Plausible, إلخ) لتتبع تسجيلات دخول المستخدمين؟"\n\nإذا كنت بحاجة إلى تحليل البيانات المرتبطة بتسجيلات دخول المستخدم أو الأذونات، يمكنك استخدام وظيفة ويب هوكس من Logto. يمكنك الاستماع إلى الويب هوكس المرسلة من قبل Logto ثم دمج البيانات في أدوات تحليلات الطرف الثالث.\n\n## تأكيد ما إذا كنت بحاجة إلى ويب هوكس\n\nالخطوة 1: تأكيد ما إذا كانت هناك أحداث ويب هوك تحتاجها\n\nتم تقسيم ويب هوك إلى فئتين، مستوى الحساب ومستوى المؤسسة، جميع الأحداث معروضة أدناه:\n\n\n\nلتمكين سيناريوهات التقسيم الخاصة بك والحصول على البيانات المطابقة، تم تقسيمها بالتفصيل. ومع ذلك، إذا كنت بحاجة إلى معلومات من أحداث متعددة في نفس الوقت، يمكنك اختيار أحداث متعددة لواحد ويب هوك.\n\nملحوظة: تلتقط أحداث نوع "تفاعل المستخدم" الإجراءات التي يقوم بها المستخدم داخل واجهة المستخدم، باستثناء التغييرات التي بدأها المديرين. تشمل أحداث نوع "المستخدم" جميع الإجراءات التي يقوم بها المستخدم، بما في ذلك تلك التي يقوم بها المدراء والمستخدمين النهائيين. على سبيل المثال، يشير الحدث PostRegister إلى تسجيل المستخدم في تجربة تسجيل الدخول، بينما User.Created يشمل جميع المستخدمين الجدد المسجلين بواسطة المستخدم في واجهة المستخدم والمضافة من قبل المدير.\n\nالخطوة 2: تأكيد ما إذا كانت حمولة الطلب تحتوي على المعلومات التي تحتاج إلى الحصول عليها\n\nتحمل الأحداث المختلفة معلومات مختلفة، يمكنك تأكيد ما إذا كانت المعلومات الحالية يمكن أن تلبي احتياجات حالة الاستخدام الخاصة بك مباشرة. على سبيل المثال، id, username, primary email, profile, customData, identities, lastSignInAt, createdAt, applicationId, isSuspended, OrganizationId, OrganizationRoleId, OrganizationScopeId, إلخ. للحصول على تفاصيل، يرجى الرجوع إلى طلب ويب هوك. إذا لم يكن كذلك، يمكنك أيضًا استخدام Management API لمواصلة الحصول على معلومات المستخدم ذات الصلة. \n\nالخطوة 3: الجمع مع Management API لتوسيع القدرات المتقدمة\n\nيمكنك أيضًا استخدام Logto Management API لتنفيذ الإدارة والتكوين الوظيفي المتقدم.\n\n## الخاتمة\n\nليست أحداث ويب هوك في Logto تشمل فقط مجموعة كبيرة من السيناريوهات، بل تضمن أيضًا إرسالًا آمنًا من خلال تحقق مفتاح التوقيع والرأس المخصص. ويمكنك عرض لوحة تحكم الويب هوك Logto لـ مراقبة الإرسال لكل ويب هوك في الـ 24 ساعة الأخيرة.\n\n