डेविस के साथ रेल अनुप्रयोगों में प्रमाणीकरण। भाग 1: मूल सेटअप

मैं आपके ध्यान में सबसे अच्छा, मेरी राय में, रेल अनुप्रयोगों में प्रमाणीकरण के लिए रत्न ले आया। दुर्भाग्य से, इस रत्न पर बहुत कम रूसी-भाषा की जानकारी है, जिसमें हब भी शामिल है, इसलिए मैं इस विषय को कवर करना चाहता हूं। लेख मुख्य रूप से शुरुआती के लिए है और उल्लेखित मणि के आधार पर प्रमाणीकरण स्थापित करने के लिए एक विस्तृत ट्यूटोरियल है। पहले भाग में, मैं मूल सेटअप के चरणों को कवर करूँगा। मणि के बारे में और विस्तार से।

डेविस एक माणिक रत्न है जो रेल अनुप्रयोगों में प्रमाणीकरण क्षमता प्रदान करता है। डेविस वार्डन मणि के साथ मिलकर काम करता है, जो बदले में रैक-आधारित रूबी अनुप्रयोगों में प्रमाणीकरण के लिए तंत्र प्रदान करता है। डेविस की मुख्य विशेषताएं नीचे वर्णित हैं:

• रैक आधारित
• एक पूर्ण रेल-आधारित MVC समाधान है;
• एक साथ कई मॉडलों के लिए सिस्टम में प्रवेश करने की अनुमति देता है;
• प्रतिरूपकता के आधार पर: केवल वही उपयोग करता है जिसकी आपको वास्तव में आवश्यकता है।

तो, चलो स्थापित करने और अपने रेल आवेदन के लिए डेविस को कॉन्फ़िगर करना शुरू करें। पठनीयता के लिए आगे की प्रक्रिया अलग-अलग चरणों में टूट जाएगी।

नोट : मेरे द्वारा सभी इंस्टॉलेशन और कॉन्फ़िगरेशन रेल संस्करण 4.0.1 के लिए बनाया गया था।

चरण 1. मणि को मणि में जोड़ें

gem 'devise' 

या सटीक संस्करण का संकेत (अगला संस्करण मेरे लिए 4.0.1 रेल के साथ काम करता है)

 gem 'devise', '3.2.2' 

नए रत्न स्थापित करने के लिए बंडल चलाएँ

 bundle install 

निम्नलिखित रत्न निर्भरता के रूप में स्थापित किए जाएंगे:
वार्डन - मिडलवेयर जो रैक अनुप्रयोगों के लिए प्रमाणीकरण क्षमता प्रदान करता है;
orm_adapter - रूबी ORM के बुनियादी कार्यों का उपयोग करने के लिए एक एकल प्रवेश बिंदु प्रदान करता है;
bcrypt-ruby - पासवर्ड के साथ काम करने के लिए एक सरल आवरण प्रदान करता है। यह क्रिप्टोग्राफिक हैश फंक्शन bcrypt () पर आधारित है;
thread_safe - रूबी के लिए थ्रेड-सुरक्षित संग्रह और उपयोगिताओं प्रदान करता है;
रेलिंग आंतरिक लोड घटक हैं जैसे कि एप्लिकेशन लोडर, प्लगइन्स, जनरेटर, और रेक कार्य।

चरण 2. तो, मणि डाउनलोड किया गया है, लेकिन अभी भी हमारे आवेदन के साथ बातचीत नहीं करता है। डेविस के पास अपने शस्त्रागार में सुविधाजनक जनरेटर हैं, जिनमें से एक अब हम उपयोग करेंगे। निम्नलिखित जनरेटर चलाकर Devise स्थापित करें:

 rails generate devise:install 

यह जनरेटर इनिशलाइज़र स्थापित करेगा, जो ऑपरेशन के लिए आवश्यक सभी डेविस कॉन्फ़िगरेशन सेटिंग्स का वर्णन करता है, साथ ही साथ बेस लोकेल (अंग्रेजी) के साथ फाइल भी। इसके अलावा, इंस्टॉलर हमें बुनियादी कॉन्फ़िगरेशन प्रदर्शन करने की पेशकश करेगा।

चरण 3. चलो स्थापना के बाद मणि की मूल सेटिंग्स बनाते हैं
3.1। अब हमें प्रत्येक रनटम्स के लिए मेलर (प्रेषक) सेटिंग्स सेट करने की आवश्यकता है। एक विकास पर्यावरण के लिए, निम्नलिखित लाइन को विन्यास / वातावरण / विकास.ब्र फ़ाइल में जोड़ें:

 config.action_mailer.default_url_options = { :host => 'localhost:3000' } 

उत्पादन वातावरण के लिए, मुख्य मूल्य को प्रतिस्थापित करना आवश्यक है : वर्तमान के साथ होस्ट करें।

3.2। उपयोगकर्ता लॉग इन करने के बाद, खाते की पुष्टि करता है या पासवर्ड को अपडेट करता है, डेविस आगे पुनर्निर्देशन के लिए एक मार्ग की तलाश करेगा। डिफ़ॉल्ट रूप से, यह user_root_path पर पुनर्निर्देशित करेगा यदि कोई मौजूद है। अन्यथा, Devise root_path पर रीडायरेक्ट करेगा। इसलिए, इस पथ को एप्लिकेशन में परिभाषित किया जाना चाहिए। इस तरह दिखने वाली रेखा के लिए अपने कॉन्फ़िगर / मार्गों की जाँच करें।

 root 'home#index' 

मुझे लगता है कि आप मुझसे सहमत होंगे कि लॉग इन करने के बाद उपयोगकर्ता को एप्लिकेशन के मुख्य पृष्ठ पर पुनर्निर्देशित करना बहुत तर्कसंगत नहीं है। इस संबंध में, उपयोगकर्ता प्रोफाइल पेज में सफलतापूर्वक लॉग इन करने के बाद रीडायरेक्ट को कॉन्फ़िगर करते हैं। ऐसा करने के लिए, कॉन्फ़िगर / मार्गों के लिए निम्न मार्ग जोड़ें।

 get 'persons/profile', as: 'user_root' 

नोट :
1) सबसे पहले आपको एक नियंत्रक और कार्रवाई बनाने की आवश्यकता है। यह एक सुविधाजनक जनरेटर का उपयोग करके कंसोल के माध्यम से किया जा सकता है:

 rails generate controller persons profile 

2) नतीजतन, जनरेटर एक प्रोफ़ाइल विधि (कार्रवाई) के साथ एक व्यक्ति_कंट्रोलर कंट्रोलर बनाएगा, साथ ही इस कार्रवाई के लिए एक दृश्य भी बनाएगा।
मार्गों की सूची कंसोल के माध्यम से प्राप्त की जा सकती है। बस कमांड दर्ज करें:

 bundle exec rake routes 

हमारे मामले में, अगला राउटर उपलब्ध होना चाहिए

 user_root GET /persons/profile(.:format) persons#profile 

जिसके लिए user_root_path हेल्पर उपलब्ध होगा

एक और तरीका भी है जिसके द्वारा आप प्रवेश के बाद और बाहर निकलने के बाद अपने खुद के रीडायरेक्ट को सेट कर सकते हैं। ऐसा करने के लिए, आपको ApplicationController ( एप्लिकेशन / नियंत्रकों / application_controller.rb ) में after_sign_in_path_for और after_sign_out_path_for के बाद के मौजूदा तरीकों को ओवरराइड करना होगा। व्यक्तिगत रूप से, मुझे पुनर्निर्देश कॉन्फ़िगर करने का यह विकल्प पसंद आया:

 def after_sign_in_path_for(resource) current_user_path end 

लॉग इन करने के बाद, उपयोगकर्ता को वर्तमान_सुपर_पथ सहायक द्वारा वर्णित पृष्ठ पर पुनर्निर्देशित किया जाएगा

 def after_sign_out_path_for(resource_or_scope) request.referrer end 

लॉग आउट करने के बाद, उपयोगकर्ता उसी पृष्ठ पर रहेगा।

3.3। टेम्प्लेट में सूचनाओं और चेतावनियों के आउटपुट को जोड़ना आवश्यक है

 <p class="notice"><%= notice %></p> <p class="alert"><%= alert %></p> 

3.4। यदि आप रेल्स वर्जन 3.2 का उपयोग करके हेरोकू पर एक एप्लिकेशन को तैनात कर रहे हैं, तो निम्न लाइन को कॉन्फ़िगर / एप्लिकेशन. rb में जोड़ें

 config.assets.initialize_on_precompile = false 

3.5। हम अपनी जरूरतों के लिए फाइल को कस्टमाइज़ कर सकते हैं। ऐसा करने के लिए, आपको निम्नलिखित कमांड चलाकर उन्हें मणि से अपने आवेदन में कॉपी करना होगा:

 rails generate devise:views 

ऐप / व्यू / डेविस डायरेक्टरी में आपको मणि द्वारा उपयोग की जाने वाली सभी व्यू फाइल्स मिलेंगी । आप अपनी इच्छानुसार उन्हें अपने आवेदन की समग्र शैली में अनुकूलित कर सकते हैं।

चरण 4. अब यह एक उपयोगकर्ता मॉडल बनाने का समय है जो प्रमाणित करेगा। हम एक उपयोगकर्ता मॉडल उत्पन्न करेंगे, इसलिए हम इसे उपयोगकर्ता कहेंगे। मॉडल को व्यवस्थापक भी कहा जा सकता है:

 rails generate devise User 

यह जनरेटर एक नया मॉडल बनाएगा यदि यह पहले मौजूद नहीं था और डिफ़ॉल्ट रूप से उपयोग किए गए मॉड्यूल को ध्यान में रखते हुए इसे कॉन्फ़िगर करता है। सबसे अधिक संभावना है, आपको एप्लिकेशन / मॉडल / user.rb में निम्नलिखित कोड मिलेगा (कोड कुछ स्वरूपित है):

 class User < ActiveRecord::Base # Include default devise modules. Others available are: # :confirmable, :lockable, :timeoutable and :omniauthable devise :database_authenticatable, :registerable, :recoverable, :rememberable, :trackable, :validatable end 

डेविस के शस्त्रागार में 10 मॉड्यूल हैं। डिफ़ॉल्ट रूप से, आपके पास 6 मॉड्यूल जुड़े होंगे। आप इस सूची को संपादित कर सकते हैं। मैं नीचे उपलब्ध सभी मॉड्यूल का विवरण देता हूं:

1. डेटाबेस ऑथेंटिकटेबल : डेटाबेस में एन्क्रिप्टेड और स्टोर किए गए पासवर्ड के आधार पर सिस्टम में प्रवेश करने की क्षमता प्रदान करता है। लॉगिन एक POST अनुरोध भेजकर या HTTP बेसिक प्रमाणीकरण का उपयोग करके किया जा सकता है।
2. ओम्नियुथल : ओमोनियाथ सपोर्ट ( https://github.com/intridea/omniauth ) को जोड़ता है।
3. पुष्टि : पंजीकरण के दौरान बनाए गए खाते की पुष्टि करने के लिए आपको निर्देश के साथ एक ईमेल भेजने की अनुमति देता है।
4. पुनर्प्राप्त करने योग्य : आपको एक भूल गए पासवर्ड को पुनर्प्राप्त करने की अनुमति देता है। मेल करने के लिए रिकवरी निर्देश भेजता है।
5. रजिस्टर करने योग्य : उपयोगकर्ता पंजीकरण का प्रबंधन करता है, आपको खातों को संपादित करने और हटाने की अनुमति देता है।
6. याद रखने योग्य : उपयोगकर्ताओं को कुकीज़ के आधार पर कुकीज़ को याद रखने की अनुमति देता है। टोकन के निर्माण और विलोपन को नियंत्रित करता है।
7. ट्रैक करने योग्य : इनपुट की संख्या के आंकड़े रखता है, खाते के समय और आईटी पते पर ध्यान देता है।
8. समयबाह्य : सिस्टम में उपयोगकर्ता गतिविधि सत्र की अवधि के लिए जिम्मेदार;
9. वैध : ईमेल और पासवर्ड के लिए सत्यापन उपकरण प्रदान करता है। मॉड्यूल को आसानी से कॉन्फ़िगर किया जा सकता है, आप अपने स्वयं के सत्यापनकर्ताओं को परिभाषित कर सकते हैं।
10. लॉक करने योग्य: सेटिंग में निर्दिष्ट विफल प्राधिकरण प्रयासों की संख्या के बाद खाते को लॉक करता है। खाते को ईमेल द्वारा या एक निश्चित अवधि के बाद अनलॉक किया जा सकता है।

साथ ही, ऊपर जो कमांड हमने चलाया है, वह एक डेटाबेस माइग्रेशन फ़ाइल और एक रूट बनाएगा। माइग्रेशन फ़ाइल निम्नानुसार है:

 class DeviseCreateUsers < ActiveRecord::Migration def change create_table(:users) do |t| ## Database authenticatable t.string :email, :null => false, :default => '' t.string :encrypted_password, :null => false, :default => '' ## Recoverable t.string :reset_password_token t.datetime :reset_password_sent_at ## Rememberable t.datetime :remember_created_at ## Trackable t.integer :sign_in_count, :default => 0, :null => false t.datetime :current_sign_in_at t.datetime :last_sign_in_at t.string :current_sign_in_ip t.string :last_sign_in_ip ## Confirmable # t.string :confirmation_token # t.datetime :confirmed_at # t.datetime :confirmation_sent_at # t.string :unconfirmed_email # Only if using reconfirmable ## Lockable # t.integer :failed_attempts, :default => 0, :null => false # Only if lock strategy is :failed_attempts # t.string :unlock_token # Only if unlock strategy is :email or :both # t.datetime :locked_at t.timestamps end add_index :users, :email, :unique => true add_index :users, :reset_password_token, :unique => true # add_index :users, :confirmation_token, :unique => true # add_index :users, :unlock_token, :unique => true end end 

यहां हम देखते हैं कि उपयोगकर्ता तालिका बनाई गई है (कोड की तीसरी पंक्ति)। चूंकि हमने अपने उपयोगकर्ता मॉडल का नाम दिया है, इसलिए तालिका का नाम समान है, लेकिन बहुवचन में ( ActiveRecord नामकरण सम्मेलन के अनुसार)। निम्नलिखित उन क्षेत्रों का वर्णन करता है जिन्हें निर्माण पर तालिका में जोड़ा जाएगा। जैसा कि हम कोड से देख सकते हैं, केवल 6 डेविस मॉड्यूल को काम करने के लिए तालिका में फ़ील्ड की आवश्यकता हो सकती है।

यदि आप किसी भी मॉड्यूल का उपयोग नहीं कर रहे हैं, तो माइग्रेशन में संबंधित फ़ील्ड्स पर टिप्पणी करना न भूलें। और, इसके विपरीत, जब आप किसी एक मॉड्यूल को सक्रिय करते हैं, तो संबंधित पंक्तियों को अनसुना करना भी न भूलें।

निम्न मार्ग को config / path.rb फ़ाइल में बनाया जाएगा:

 devise_for :users 

आपको याद दिला दूं कि मौजूदा मार्गों की सूची कमांड द्वारा देखी जा सकती है:

 bundle exec rake routes 

चरण 5. इसलिए, हमने मॉड्यूल का पता लगाया, आवश्यक लोगों को जोड़ा, माइग्रेशन फ़ाइल को देखा। अब आपको माइग्रेशन करने की आवश्यकता है, जो आवश्यक सेट फ़ील्ड के साथ एक उपयोगकर्ता तालिका बनाएगा। निम्न आदेश चलाएँ:

 bundle exec rake db:migrate 

चरण 6. इसके बाद, आपको सभी परिवर्तनों को प्रभावी करने के लिए एप्लिकेशन को पुनरारंभ करना होगा। यदि ऐसा नहीं किया जाता है, तो आप विभिन्न प्रकार की त्रुटियों का सामना कर सकते हैं।
चूंकि मेरा एप्लिकेशन एक यूनिकॉर्न सर्वर चला रहा है, इसलिए मैं इसे पुनः आरंभ करता हूं। यदि आप वीब्रिक सर्वर के तहत अपने एप्लिकेशन का परीक्षण कर रहे हैं, तो यह कुंजी संयोजन CTRL + C का उपयोग करके इसे रोकने के लिए पर्याप्त होगा, और इसे फिर से शुरू करें:

 rails server 

चरण 7. हमारा मॉड्यूल और हमारा एप्लिकेशन काम करने के लिए तैयार हैं। अगला चरण टेम्प्लेट में लॉगिन और पंजीकरण लिंक जोड़ना है। इसे निम्नानुसार किया जा सकता है:

 <% if user_signed_in? %> <span>, <%= current_user.email %></span> <%= link_to '', destroy_user_session_path, :method => :delete %> <% else %> <%= link_to '', new_user_session_path %>  <%= link_to '', new_user_registration_path %> <% end %> 

यदि उपयोगकर्ता ने साइट पर लॉग इन किया है, तो हम उसे "हैलो, [उपयोगकर्ता का मेल]" लिखते हैं और अगले से बाहर निकलने के लिए एक लिंक देते हैं। यदि उपयोगकर्ता ने अभी तक साइट में प्रवेश नहीं किया है, तो हमारे पास पास में दो "लॉगिन" और "रजिस्टर" लिंक हैं। हम मौजूदा सहायकों को लिंक के लिए पथ के रूप में उपयोग करते हैं। आपको याद दिलाता हूं कि मार्गों को चौथे चरण में स्थापित किया गया था और सूची को निम्न कमांड द्वारा देखा जा सकता है। हेल्पर में एक उपसर्ग होता है (सबसे बाएं स्तंभ + '_पथ')

 bundle exec rake routes 

चरण 8. यह अपने इच्छित उद्देश्य के लिए डेविस का उपयोग शुरू करने का समय है - साइट के कुछ वर्गों में अनधिकृत उपयोगकर्ता की पहुंच को प्रतिबंधित करने के लिए। मान लीजिए कि हम केवल एक अधिकृत उपयोगकर्ता को एक आदेश पूरा करने की अनुमति देना चाहते हैं। ऐसा करने के लिए, हमें उचित नियंत्रक के लिए एक फ़िल्टर जोड़ना होगा:

 class OrdersController < ApplicationController before_filter :authenticate_user!, except => [:show, :index] def index # do something end def show # do something end def create # do something end end 

यहां, कोड में, हम नियंत्रक विधियों की सूची पास करते हैं जिन्हें पहले_फिल्टर विधि के दूसरे पैरामीटर के रूप में फ़िल्टर नहीं किया जाना चाहिए। इस प्रकार, प्राधिकरण केवल ऑर्डर निष्पादन ( ऑर्डर पद्धति के संचालन तक पहुंच) के लिए आवश्यक है। यदि सभी नियंत्रक विधियों को फ़िल्टर करना आवश्यक है, तो दूसरे पैरामीटर को प्रेषित करने की आवश्यकता नहीं है। बस लिखें:

 before_filter :authenticate_user! 

उपयोगी सहायक विधियों की सूची

डेविस में उपयोगी सहायक होते हैं जिन्हें आप नियंत्रकों और विचारों के अंदर उपयोग कर सकते हैं। मैं उनमें से कुछ नीचे देता हूं।
आप निम्न सहायक का उपयोग करके सिस्टम में उपयोगकर्ता लॉगिन के तथ्य की जांच कर सकते हैं:

 user_signed_in? 

अगले सहायक का उपयोग करते हुए, हमें वर्तमान में साइट पर अधिकृत उपयोगकर्ता की वस्तु मिलती है

 current_user 

आप उपयोगकर्ता के ईमेल को निम्नानुसार प्रदर्शित कर सकते हैं

 current_user.email 

वर्तमान सत्र तक पहुँच निम्नानुसार प्राप्त की जा सकती है:

 user_session 

यह पहले भाग को समाप्त कर देगा, और अगले भाग में मैं प्रमाणीकरण के लिए इस अद्भुत मणि के लिए अन्य कोई कम महत्वपूर्ण और कोई कम दिलचस्प सेटिंग्स के बारे में लिखने की योजना नहीं बनाता।

प्रयुक्त साहित्य की सूची:

सामग्री के मुख्य स्रोत के रूप में, आधिकारिक रत्न प्रलेखन का उपयोग किया गया था - github.com/plataformatec/devise , हमारे कस्टम अनुकूलन अनुभव द्वारा पूरक।