كيفية استخدام وحدة المصادقة

توفر وحدة Auth المصادقة والتفويض لتطبيقك ، بما في ذلك إدارة المستخدم وإدارة المجموعة وتسجيل المستخدم وتسجيل الدخول والوظائف ذات الصلة. يتم تثبيته تلقائيًا عند إنشاء المشروع.

تسجيل الدخول الافتراضي للمستخدم وكلمة المرور كالتالي:

• Login : [email protected]
• Password : appmaster

يمكن تكوين إعدادات الوحدة النمطية بالطريقة التالية:

• SignUp Groups : تحدد قائمة المجموعات التي يمكن للمستخدم التسجيل فيها ؛
• SignUp : يسمح للمستخدمين بالتسجيل والحصول على حسابات في التطبيق ؛
• Session timeout (minutes) : تحدد الوقت الذي تنتهي بعده جلسة المستخدم الحالية إذا كان المستخدم في وضع الخمول ؛ الافتراضي 60 دقيقة ؛
• Failed login delay (in ms) : يحدد وقت التأخير للردود بعد محاولات تسجيل الدخول الفاشلة ؛ الافتراضي 0 مللي ثانية ؛
• Email confirmation required : يحدد ما إذا كان على المستخدم تأكيد التسجيل عبر البريد الإلكتروني ؛
• Signed-Up User Active : تعيين نشط = صحيح لكل كائن مستخدم تم إنشاؤه حديثًا إذا تم تمكينه ؛
• تسمح علامة التبويب " Groups " بإنشاء قائمة بمجموعات المستخدمين وتكوينها ؛

يتم إنشاء نماذج User Session User بمجرد تثبيت وحدة المصادقة . يمكنك العثور عليها في علامة التبويب Data Design . لا يمكن تكوين السمات الافتراضية لهذه النماذج ، ولكن من الممكن إضافة سمات جديدة.

User, User Session وجلسة المستخدم Auth Module ذات الصلة بعمليات BP

العمليات التجارية المثبتة مسبقًا المتعلقة بنماذج User Session User كما يلي:

• نموذج User

  • DB: Delete User: يحذف كائن User من قاعدة البيانات بناءً على ID الخاص به ؛

• DB: Update User : يعيد تعيين جميع الحقول الخاصة بكائن نموذج معين في قاعدة البيانات ويحدّثها بقيم معطاة (قاعدة البيانات DB: Patch User لتغيير الحقول المتوفرة فقط والاحتفاظ بالآخرين كما هي) ؛

• DB: Create User : إنشاء سجل في قاعدة البيانات وإرجاع كائن نموذج User (يتطلب استخدام كتلة تكوين Make User لإنشاء كائن نموذج User وفقًا لحقول الإدخال) ؛

• DB: Soft Delete User : تحديثات الحقل DeletedAt لكائن نموذج User المحدد بدلاً من إزالة السجل بالكامل كما يفعل DB: Delete User ؛

• DB: Bulk Delete User : يحذف بالجملة مجموعة سجلات كائن نموذج User مع IDs المحددة (صفيف ids ) ؛ failed_ids - مجموعة من IDs المستخدم التي لن يتم حذفها ؛

• DB: Patch User : تحديث الحقول المحددة لكائن نموذج User في قاعدة البيانات (قاعدة البيانات DB: Update User لإعادة تعيين جميع الحقول) ؛

• DB: Search User : يعثر على كائن أو أكثر من كائنات نموذج User في قاعدة البيانات بناءً على الحقول الخاصة بهم ويعيدها ؛

• DB: GetOne User : يجد كائن نموذج User بناءً على ID ويعيده ؛

• Expand User : إرجاع كافة الحقول الخاصة بكائن نموذج User المحدد ؛

• Make User : يجعل كائن نموذج User يعتمد على حقول الإدخال (مطلوب استخدام DB: Create User من أجل إنشاء السجل في قاعدة البيانات) ؛

• User Session

  • DB: Delete User Session : يحذف كائن User Session من قاعدة البيانات بناءً على ID ؛

• DB: Update User Session : إعادة تعيين جميع الحقول الخاصة بكائن نموذج معين في قاعدة البيانات ، وتحديثها بقيم معينة (قاعدة البيانات DB: Patch User Session لتغيير الحقول المتوفرة فقط) ؛

• DB: Create User Session سجل في قاعدة البيانات وإرجاع كائن نموذج User Session (يتطلب استخدام كتلة تكوين Make User Session User وفقًا لحقول الإدخال) ؛

• DB: Soft Delete User Session : تحديثات الحقل DeletedAt لكائن نموذج User Session المحدد ؛

• قاعدة DB: Bulk Delete User Session بالجملة: يحذف المجمع مجموعة سجلات كائن نموذج User Session مع IDs المحددة (صفيف ids ) ؛ تحدد مصفوفة failed_ids مجموعة IDs التي سيتم تجاهلها من عملية الحذف ؛

• DB: Patch User Session : تحديث الحقول المحددة لكائن نموذج User Session في قاعدة البيانات (قاعدة البيانات DB: Update User Session المستخدم لإعادة تعيين جميع الحقول) ؛

• DB: Search User Session : يعثر على كائن واحد أو أكثر من كائنات نموذج User Session في قاعدة البيانات بناءً على الحقول الخاصة بهم ويعيدهم ؛

• DB: GetOne User Session : يجد كائن نموذج User Session بناءً على ID الخاص به ويعيده ؛

• Expand User Session : تُرجع كافة الحقول الخاصة بكائن نموذج User Session المحدد ؛

• Make User Session : يجعل كائن نموذج User Session يعتمد على حقول الإدخال (مطلوب استخدام قاعدة البيانات DB: Create User Session من أجل إنشاء السجل في قاعدة البيانات) ؛

• Auth Module

  • Auth: Generate Auth Token : يقوم بإنشاء رمز ترخيص (رمز Auth Token ) من الطول المحدد ؛

• Auth: Registration : يسجل مستخدم جديد.

• Auth: Authorization : يتحقق مما إذا كان هناك Auth Token معين ويعيد المستخدم المرتبط به ؛

• Auth: Authentification : يتحقق من تسجيل دخول المستخدم وكلمة المرور ويعيد " Auth Token " ؛

• Auth: Logout : إنهاء جلسة المستخدم الحالية بناءً على Auth Token ؛

• Auth: Get current user : إرجاع كائن نموذج User الحالي ؛

• Auth: Remove user from group : يزيل مستخدمًا من المجموعة المحددة بناءً على ID ؛

• Auth: Add user to group : يضيف مستخدمًا إلى المجموعة المختارة بناءً على ID ؛

• Auth: Hash Password : يحول سلسلة كلمة المرور إلى تجزئة ؛

• Auth: Restore Password : يستعيد كلمة المرور بناءً على تسجيل دخول المستخدم ؛

• Auth: Change Password : تغيير كلمة مرور المستخدم ؛

• Auth: Probe Password : يتحقق من الارتباط بين كلمة المرور والتجزئة ؛

Auth Module, User ونقاط User Session endpoints

يتم إنشاء Endpoints المثبتة مسبقًا Auth Module ونماذج User Session User بمجرد إنشاء المشروع.

Auth Module

نوع الطلبEndpointعملية الأعمال المرتبطة_/logout/Auth: Logout/auth/Auth: Authentification/register/Auth: Registration/confirm/Auth: Get Current User/user/change-password/Auth: Change Password/user/restore-password/Auth: Restore Password/user/profile/_Auth: Get Current User

المستعمل

نوع الطلبEndpointعملية الأعمال المرتبطة_/user/:id/DB: Update User/user/:id/DB: Delete User/user/:id/DB: GetOne User/user/DB: Search User/user/:id/DB: Patch User/user/_DB: Create User

User Session

نوع الطلبEndpointعملية الأعمال المرتبطة_/user-session/:id/DB: Delete User Session/user-session/:id/DB: GetOne User Session/user-session/DB: Search User Session/user-session/:id/DB: Patch User Session/user-session/DB: Create User Session/user-session/:id/_DB: Update User Session

Auth Token

يتم استخدام Auth Token كرمز مميز لجلسة المستخدم. من الممكن التفاعل مع Auth Token, في عمليات أعمال تطبيقات الويب:

• Get Auth Token يعيد Auth Token لجلسة المستخدم الحالية ؛

• Set Auth Token Auth Token لجلسة المستخدم الحالي ؛

• Remove Auth Token Auth Token لجلسة المستخدم الحالية ؛

كيف تحصل على المستخدم الحالي

1. انتقل إلى علامة التبويب Business logic واسحب Auth: Get current user .

2. انتقل إلى علامة التبويب " Endpoints " وقم بتوسيع قسم " User ". بعد ذلك ، قم بإنشاء طريقة نوع GET لعملية الأعمال التي تم إنشاؤها في الخطوة 1. سيكون عنوان URL endpoint /user_current .

3. انتقل إلى علامة التبويب Web Apps وأنشئ عملية تجارية جديدة باستخدام Server request GET /user_current للحصول على المستخدم الحالي من عملية أعمال تطبيق الويب.