توفر وحدة 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 للحصول على المستخدم الحالي من عملية أعمال تطبيق الويب.