Auth মডিউল ব্যবহারকারী ব্যবস্থাপনা, গোষ্ঠী ব্যবস্থাপনা, ব্যবহারকারী নিবন্ধন, লগইন এবং সম্পর্কিত ফাংশন সহ আপনার অ্যাপ্লিকেশনের জন্য প্রমাণীকরণ এবং অনুমোদন প্রদান করে। প্রকল্প তৈরি হলে এটি স্বয়ংক্রিয়ভাবে ইনস্টল করা হয়।
ডিফল্ট অ্যাডমিন ব্যবহারকারী লগইন এবং পাসওয়ার্ড নিম্নরূপ:
- Login করুন: [email protected]
- Password : appmaster
মডিউল সেটিংস নিম্নলিখিত উপায়ে কনফিগার করা যেতে পারে:
- SignUp Groups : গ্রুপের তালিকা নির্ধারণ করে যেখানে ব্যবহারকারী নিবন্ধন করতে পারে;
- SignUp : ব্যবহারকারীদের সাইন আপ করতে এবং অ্যাপ্লিকেশনটিতে অ্যাকাউন্ট পেতে অনুমতি দেয়;
- Session timeout (minutes) : ব্যবহারকারী নিষ্ক্রিয় থাকলে বর্তমান ব্যবহারকারীর অধিবেশন শেষ হওয়ার সময় নির্ধারণ করে; ডিফল্ট 60 মিনিট;
- Failed login delay (in ms) : ব্যর্থ লগইন প্রচেষ্টার পরে প্রতিক্রিয়াগুলির জন্য বিলম্বের সময় নির্ধারণ করে; ডিফল্ট 0ms;
- Email confirmation required : ব্যবহারকারীকে ইমেলের মাধ্যমে নিবন্ধন নিশ্চিত করতে হবে কিনা তা নির্ধারণ করে;
- Signed-Up User Active : সক্রিয় থাকলে প্রতিটি সদ্য-নির্মিত ইউজার অবজেক্টের জন্য active=true সেট করুন;
- Groups ট্যাব ব্যবহারকারী গ্রুপের একটি তালিকা তৈরি এবং কনফিগার করার অনুমতি দেয়;
Auth মডিউল ইনস্টল হয়ে গেলে User এবং User Session মডেলগুলি স্বয়ংক্রিয়ভাবে তৈরি হয়। আপনি তাদের Data Design ট্যাবে খুঁজে পেতে পারেন। এই মডেলগুলির ডিফল্ট বৈশিষ্ট্যগুলি কনফিগার করা সম্ভব নয়, তবে নতুনগুলি যুক্ত করা সম্ভব।
User, User Session এবং Auth Module সম্পর্কিত বিপি
User এবং User Session মডেল সম্পর্কিত পূর্ব-ইনস্টল করা ব্যবসায়িক প্রক্রিয়াগুলি নিম্নরূপ:
User মডেল
- DB: Delete User: ডাটাবেস থেকে User অবজেক্ট ডিলিট করে তার ID উপর ভিত্তি করে;
- DB: Update User : ডাটাবেসের একটি প্রদত্ত মডেল অবজেক্টের সমস্ত ক্ষেত্র পুনরায় সেট করে এবং প্রদত্ত মানগুলির সাথে তাদের আপডেট করে ( DB: Patch User শুধুমাত্র প্রদত্ত ক্ষেত্রগুলি পরিবর্তন করতে এবং অন্যকে যেমন আছে তেমন রাখতে ব্যবহার করতে হবে);
- DB: Create User : ডাটাবেসে একটি রেকর্ড তৈরি করে এবং User মডেল অবজেক্ট ফেরত দেয় (ইনপুট ক্ষেত্র অনুসারে User মডেল অবজেক্ট তৈরি করতে Make User ব্লক ব্যবহার করতে হয়);
- DB: Soft Delete User : DB: Delete User করে পুরো রেকর্ড মুছে ফেলার পরিবর্তে নির্বাচিত User মডেল অবজেক্টের মুছে DeletedAt ফিল্ড আপডেট করে;
- DB: Bulk Delete User : বাল্ক প্রদত্ত IDs ( ids অ্যারে) সহ User মডেল অবজেক্ট রেকর্ডের সেট মুছে দেয়; 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 মডেল অবজেক্ট ফেরত দেয় (ইনপুট ক্ষেত্র অনুসারে User মডেল অবজেক্ট তৈরি করতে Make User Session ব্লক ব্যবহার করতে হবে);
- DB: Soft Delete User Session : নির্বাচিত User Session মডেল অবজেক্টের মুছে DeletedAt ক্ষেত্রে আপডেট;
- DB: Bulk Delete User Session : বাল্ক প্রদত্ত IDs ( ids অ্যারে) সহ User Session মডেল অবজেক্ট রেকর্ডের সেট মুছে দেয়; failed_ids অ্যারে IDs সেটকে সংজ্ঞায়িত করে যা মুছে ফেলার প্রক্রিয়া থেকে উপেক্ষা করা হবে;
- DB: Patch User Session : ডাটাবেসে User Session মডেল অবজেক্টের নির্বাচিত ক্ষেত্র আপডেট করে ( DB: Update User Session সব ফিল্ড রিসেট করতে ব্যবহার করতে হবে);
- DB: Search User Session : ডাটাবেসে এক বা একাধিক User Session মডেল অবজেক্ট খুঁজে বের করে তাদের ফিল্ডের উপর ভিত্তি করে এবং রিটার্ন করে;
- DB: GetOne User Session : এর ID এর উপর ভিত্তি করে User Session মডেল অবজেক্ট খুঁজে বের করে এবং ফেরত দেয়;
- 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
Auth Module Endpoints -ইনস্টল করা শেষ পয়েন্ট এবং User এবং User Session মডেলগুলি প্রোজেক্ট তৈরি হয়ে গেলে স্বয়ংক্রিয়ভাবে তৈরি হয়।
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 টোকেন পুনর্লিখন করে;
- Auth Token Remove Auth Token বর্তমান ব্যবহারকারীর সেশন প্রমাণ টোকেন সরিয়ে দেয়;
কিভাবে বর্তমান ব্যবহারকারী পেতে
1. Business logic ট্যাবে যান এবং প্রমাণটি টেনে আনুন Auth: Get current user ।
2. Endpoints ট্যাবে যান এবং User বিভাগটি প্রসারিত করুন। তারপর, ধাপ 1 এ তৈরি করা ব্যবসায়িক প্রক্রিয়ার জন্য একটি GET টাইপ পদ্ধতি তৈরি করুন। endpoint URL হবে /user_current ।
3. Web Apps ট্যাবে যান এবং ওয়েব অ্যাপ্লিকেশন ব্যবসায়িক প্রক্রিয়া থেকে বর্তমান ব্যবহারকারীকে পেতে Server request GET /user_current সহ একটি নতুন ব্যবসায়িক প্রক্রিয়া তৈরি করুন।