خادم إدارة المستخدم سهل الاستخدام للمسؤول (مع مفاتيح المرور وJWTs) - للتكامل السلس والآمن لمصادقة المستخدم.
روابط مفيدة: التوثيق | سجل التغيير | الموقع التجريبي | متابعة على مستودون
يهدف AuthCompanion إلى تلبية احتياجات المصادقة وإدارة المستخدم الأكثر شيوعًا لتطبيق الويب الخاص بك.
مع AuthC يمكنك:
شاشة تسجيل الدخول | شاشة التسجيل |
---|---|
ستؤدي الإرشادات الواردة أدناه إلى تشغيل الخادم الافتراضي لاستكشاف الميزات.
المتطلبات المسبقة:
انسخ الريبو إذا لم تقم بذلك، ثم قم بتثبيت التبعيات باستخدام هذا الأمر:
$ npm install
عندما تكون جاهزًا، قم بتشغيل الخادم بالإعدادات الافتراضية!
$ npm start
ابدأ تشغيل الخادم (بالتكوين الافتراضي):
$ docker run -it -p 3002:3002 --name AuthCompanion ghcr.io/authcompanion/authcompanion2:main
يتوفر أيضًا ملف docker-compose.yml
إذا كنت تحاول استخدام AuthC لأول مرة، فسيعمل التكوين الافتراضي. راجع دليل التكوين لإلقاء نظرة فاحصة على كيفية تكوين الخادم للبيئات الأخرى.
عندما تصبح جاهزًا، اقرأ دليل التشغيل لمزيد من المعلومات حول إعداد AuthC في الإنتاج.
نماذج الويب لمصادقة المستخدم: استخدم نماذج الويب المعدة مسبقًا والقابلة للتخصيص لمستخدمي تطبيقك من أجل: تسجيل الدخول باستخدام بيانات الاعتماد الخاصة بهم، وتسجيل حساب، وتحديث ملفاتهم الشخصية، وإصدار كلمات المرور المنسية.
لوحة تحكم المشرف لإدارة ملفات تعريف المستخدمين: قم بتعديل معلومات الملفات الشخصية لمستخدميك عبر لوحة معلومات الخدمة الذاتية - يتم تخزين جميع معلومات الحساب في قاعدة بيانات SQLite.
استرداد حساب المستخدم: استعادة وصول المستخدم إلى حسابه باستخدام تدفق "نسيت كلمة المرور" الذي يرسل رابطًا خاصًا عبر البريد الإلكتروني لمساعدة المستخدمين على استعادة حساباتهم بسرعة.
التدفق بدون كلمة مرور: قم بتبسيط عملية تسجيل دخول المستخدم وتسجيله باستخدام مفتاح المرور، ومصادقة المستخدمين باستخدام جهاز محمول أو مفتاح أمان USB أو جهاز كمبيوتر.
النظام الأساسي القابل للتوسيع: يدعم AuthC نظام المكونات الإضافية لإضافة وظائف جديدة بسهولة لتغطية المزيد من احتياجات المصادقة الخاصة بك.
يوفر Authcompanion نماذج ويب مدمجة لمصادقة المستخدم بما في ذلك صفحات تسجيل الدخول والتسجيل.
بعد مصادقة المستخدم باستخدام نماذج الويب الخاصة بـ AuthC، نقوم بتمريرها إلى تطبيق الويب الخاص بك.
للحصول على قائمة كاملة بنماذج الويب الخاصة بـ AuthC، راجع دليل نماذج الويب.
لوحة تحكم المسؤول هي أداة تسمح للمسؤولين أو مالكي التطبيقات بإدارة مستخدمي تطبيق الويب الخاص بهم. فهو يوفر مجموعة من الوظائف التي يمكن للمسؤولين استخدامها لإنشاء حسابات المستخدمين وتحريرها وحذفها؛ كل ذلك عبر واجهة سهلة الاستخدام وبديهية.
راجع لوحة تحكم المسؤول في الوثائق لمعرفة كيفية الوصول إليها: الإدارة.
أفضل طريقة للتعلم هي بالممارسة؛ إليك طريقتان للبدء.
يمكنك إما استخدام العرض التوضيحي المتاح للعامة على موقع demo.authcompanion.com أو بدء تشغيل الخادم محليًا.
يأتي AuthC مزودًا بنماذج ويب مُعدة مسبقًا لمساعدتك على دمج مصادقة المستخدم بسرعة إلى جانب تطبيق الويب الخاص بك.
مع تشغيل خادم AuthC (في الخطوات السابقة)، ابدأ أولاً بتسجيل حساب باستخدام نموذج الويب هذا: http://localhost:3002/v1/web/register
بعد ذلك، قم بتسجيل الدخول باستخدام الحساب الذي أنشأته للتو باستخدام بريدك الإلكتروني وكلمة المرور في نموذج الويب هذا: http://localhost:3002/v1/web/login. تتضمن استجابة الخادم رمز وصول لاستخدامه عند المصادقة على واجهات برمجة التطبيقات الخلفية وإعادة توجيه المستخدم إلى الصفحة الرئيسية لتطبيقك.
قم بتسجيل الدخول إلى لوحة تحكم المسؤول باستخدام بيانات الاعتماد الموجودة عبر دليل الإدارة وقم بتحديث ملف تعريف المستخدم الذي قمت بإنشائه في الخطوة السابقة عن طريق تغيير بريده الإلكتروني (أو حقل مشابه).
قم بإلقاء نظرة على دليل التكامل لفهم كيفية تفاعل تطبيقات الواجهة الأمامية وخدمات الويب الخلفية مع AuthC.
تعمل واجهة RESTful Authentication API على تشغيل نماذج الويب التي يقوم المستخدمون من خلالها بالمصادقة في تطبيق الويب الخاص بك. من المهم ملاحظة أن نماذج الويب وحدها لا تغطي كل تدفقات المصادقة للمستخدمين. على سبيل المثال: يتطلب تحديث رمز وصول منتهي الصلاحية التفاعل مع واجهات برمجة التطبيقات الخاصة بـ AuthC بالإضافة إلى استخدام Web Froms.
لمزيد من المعلومات حول Authentication API، راجع المستندات هنا: Auth API
تساعد Admin API المسؤول على إدارة مستخدمي تطبيق الويب الخاص به. فهو يوفر مجموعة من الوظائف التي يمكن للمسؤولين من خلالها إنشاء حسابات المستخدمين وتحريرها وحذفها برمجيًا. يتم أيضًا استخدام Admin API بشكل أصلي بواسطة لوحة تحكم المشرف.
لمزيد من المعلومات حول Admin API، راجع المستندات هنا: Admin API
AuthCompanion مرخص بموجب الترخيص العام Big Time. تتيح لك هذه الشروط استخدام هذا البرنامج ومشاركته لأغراض غير تجارية وفي الأعمال التجارية الصغيرة مجانًا، مع ضمان أيضًا توفر التراخيص المدفوعة للشركات الكبيرة بشروط عادلة ومعقولة وغير تمييزية.
تحياتي لتصميم الشعار - تيموثي ريدر (Github)
رفع ثقيل على النموذج الأولي والإلهام المستمر - تيدي شميتز (Github)
خذ AuthCompanion، الصاحب المفيد، إلى مشروع الويب التالي الخاص بك! ؟