OAuth-এর মাধ্যমে API সুরক্ষিত করা

এই টিউটোরিয়াল থেকে আপনি জানতে পারবেন যে কীভাবে OAuth 2.0-এর মাধ্যমে API সুরক্ষিত করতে হয়।

OAuth হল একটি অনুমোদন সংক্রান্ত প্রোটোকল যা ব্যবহারকারীদের ইউজারনেম ও পাসওয়ার্ড প্রকাশ করার প্রয়োজন ছাড়াই অ্যাপগুলিকে ব্যবহারকারীদের হয়ে তথ্য অ্যাক্সেস করার অনুমতি দেয়।

OAuth-এর মাধ্যমে, অ্যাক্সেস টোকেনের জন্য নিরাপত্তা ক্রেডেনশিয়াল (যেমন, ইউজারনেম/পাসওয়ার্ড বা কী/সিক্রেট) শেয়ার করা হয়। যেমন:

joe:joes_password (username:password) অথবা
Nf2moHOASMJeUmXVdDhlMbPaXm2U7eMc:unUOXYpPe74ZfLEb (key:secret)

এই ধরনের কিছু হয়ে যায়:

b0uiYwjRZLEo4lEu7ky2GGxHkanN

অ্যাক্সেস টোকেন হল অক্ষরের একটি র‍্যান্ডম স্ট্রিং এবং এটি সাময়িক (তুলনামূলকভাবে কম সময়ের পরে এর মেয়াদ শেষ হয়ে যাওয়া উচিত), তাই অ্যাপ ওয়ার্কফ্লোতে কোনও ব্যবহারকারীকে যাচাই করার জন্য এটি পাস করা, আসল ক্রেডেনশিয়াল পাস করার চেয়ে অনেক বেশি সুরক্ষিত।

OAuth 2.0 স্পেসিফিকেশন অ্যাপের জন্য অ্যাক্সেস টোকেন ডিস্ট্রিবিউট করার জন্য বিভিন্ন মেকানিজমকে সংজ্ঞায়িত করে, যাকে "গ্র্যান্টের ধরন" বলা হয়। OAuth 2.0-এর মাধ্যমে নির্ধারিত সবচেয়ে প্রাথমিক গ্র্যান্টের ধরনকে "ক্লায়েন্ট ক্রেডেনশিয়াল" বলা হয়। এই গ্র্যান্টের ধরনে, ক্লায়েন্ট ক্রেডেনশিয়ালের বিনিময়ে OAuth অ্যাক্সেস টোকেন তৈরি করা হয়, যা হল কনজিউমার কী/কনজিউমার সিক্রেট পেয়ার, যেমন উপরের উদাহরণে দেখানো হয়েছে।

Edge-এ ক্লায়েন্ট ক্রেডেনশিয়াল গ্রান্টের ধরন API প্রক্সিতে নীতি ব্যবহার করে প্রয়োগ করা হয়। A সাধারণ OAuth ফ্লোতে দুটি ধাপ থাকে:

• ক্লায়েন্ট ক্রেডেনশিয়াল থেকে OAuth অ্যাক্সেস টোকেন জেনারেট করতে API প্রক্সি ১ কল করুন। API প্রক্সি সার্ভারে OAuth v2.0 নীতি এটি ম্যানেজ করে।
• API কলে OAuth অ্যাক্সেস টোকেন পাঠানোর জন্য API প্রক্সি ২ কল করুন। API প্রক্সি OAuth v2.0 নীতি ব্যবহার করে অ্যাক্সেস টোকেন যাচাই করে।

আপনার কী প্রয়োজন হবে

• Apigee Edge অ্যাকাউন্ট। আপনার এখনও কোনও অ্যাকাউন্ট না থাকলে, Apigee Edge অ্যাকাউন্ট তৈরি করা লিঙ্কে গিয়ে নির্দেশাবলী অনুসরণ করে সাইন-আপ করতে পারেন।
• কমান্ড লাইন থেকে API কল করতে আপনার মেশিনে cURL ইনস্টল করা থাকতে হবে।

টোকেন-জেনারেটিং API প্রক্সি ডাউনলোড ও ডেপ্লয় করা

এই ধাপে, আপনি এমন API প্রক্সি তৈরি করবেন যা API কলে পাঠানো কনজিউমার কী ও কনজিউমার সিক্রেট থেকে OAuth অ্যাক্সেস টোকেন তৈরি করে। Apigee একটি নমুনা API প্রক্সি প্রদান করে যা এটি করে। আপনি এখন প্রক্সি ডাউনলোড ও ডেপ্লয় করবেন, তারপর টিউটোরিয়ালে এটি ব্যবহার করবেন। (আপনি সহজেই এই API প্রক্সি নিজে তৈরি করতে পারেন। এই ডাউনলোড ও ডেপ্লয় করার ধাপটি সুবিধার জন্য এবং আগে থেকেই তৈরি করা প্রক্সি শেয়ার করা কতটা সহজ তা দেখানোর জন্য।)

1. আপনার ফাইল সিস্টেমে যেকোনও ডিরেক্টরিতে 'oauth' স্যাম্পেল API প্রক্সি ZIP ফাইল ডাউনলোড করুন।
2. https://apigee.com/edge লিঙ্কে গিয়ে সাইন-ইন করুন।
3. বাঁদিকের নেভিগেশন বারে ডেভেলপ করুন > API প্রক্সি বিকল্প বেছে নিন।
4. + প্রক্সি বিকল্পে ক্লিক করুন।
   
5. প্রক্সি তৈরি করুন উইজার্ডে, প্রক্সি বান্ডেল আপলোড করুন বিকল্পে ক্লিক করুন।
6. আপনার ডাউনলোড করা oauth.zip ফাইলটি বেছে নিন এবং পরবর্তী বিকল্পে ক্লিক করুন।
7. তৈরি করুন বিকল্পে ক্লিক করুন।
8. বিল্ড সম্পূর্ণ হওয়ার পরে, API প্রক্সি এডিটরে নতুন প্রক্সি দেখতে প্রক্সি এডিট করুন বিকল্পে ক্লিক করুন।
9. API প্রক্সি এডিটরের 'এক নজরে' পৃষ্ঠায়, ডেপ্লয়মেন্ট ড্রপ-ডাউনে ক্লিক করুন এবং টেস্ট বিকল্প বেছে নিন। এটি আপনার সংস্থার টেস্ট এনভায়রনমেন্ট।
   
   কনফার্মেশন প্রম্পটে, ডেপ্লয় করুন বিকল্পে ক্লিক করুন।
   আপনি আবার ডিপ্লয়মেন্ট ড্রপ-ডাউনে ক্লিক করলে, সবুজ আইকন থেকে বোঝা যায় যে প্রক্সি টেস্ট এনভায়রনমেন্টে ডিপ্লয় করা হয়েছে।
   

আরও বাকি আছে! আপনি Edge সংস্থায় অ্যাক্সেস টোকেন জেনারেট করা API প্রক্সি সফলভাবে ডাউনলোড ও ডেপ্লয় করেছেন।

OAuth ফ্লো ও নীতি দেখুন

API প্রক্সিতে কী কী থাকে তা আরও ভালোভাবে দেখা যাক।

1. API প্রক্সি এডিটরে, ডেভেলপ করুন ট্যাবে ক্লিক করুন। বাঁদিকের Navigator প্যানেলে, আপনি দুটি নীতি দেখতে পাবেন। এছাড়াও, আপনি Proxy Endpoints বিভাগে দুটি POST ফ্লো দেখতে পাবেন।

2. Proxy Endpoints-এর অধীনে AccessTokenClientCredential বিকল্পে ক্লিক করুন।
   

   XML কোড ভিউতে, আপনি Flow দেখতে পাবেন, যাকে AccessTokenClientCredential বলা হয়:

   <Flow name="AccessTokenClientCredential">
       <Description/>
       <Request>
           <Step>
               <Name>GenerateAccessTokenClient</Name>
           </Step>
       </Request>
       <Response/>
       <Condition>(proxy.pathsuffix MatchesPath "/accesstoken") and (request.verb = "POST")</Condition>
   </Flow>

   ফ্লো হল API প্রক্সির একটি প্রসেসিং ধাপ। এই ক্ষেত্রে, কোনও নির্দিষ্ট শর্ত পূরণ হলে ফ্লো ট্রিগার হয় (এটি শর্তসাপেক্ষ ফ্লো নামে পরিচিত)। <Condition> এলিমেন্টে সংজ্ঞায়িত কন্ডিশন থেকে জানা যায় যে API প্রক্সি কল যদি /accesstoken রিসোর্সে করা হয় এবং অনুরোধের ভার্ব যদি POST হয়, তাহলে GenerateAccessTokenClient নীতি প্রয়োগ করো, যা অ্যাক্সেস টোকেন তৈরি করে।

3. এবার, শর্তসাপেক্ষ ফ্লো যে নীতি ট্রিগার করবে সেটি দেখে নেওয়া যাক। ফ্লো ডায়াগ্রামে GenerateAccessTokenClient নীতি আইকনে ক্লিক করুন।
   
   নিচে উল্লেখ করা XML কনফিগারেশন কোড ভিউতে লোড করা হয়:

   <OAuthV2 name="GenerateAccessTokenClient">
       <!-- This policy generates an OAuth 2.0 access token using the client_credentials grant type -->
       <Operation>GenerateAccessToken</Operation>
       <!-- This is in millseconds, so expire in an hour -->
       <ExpiresIn>3600000</ExpiresIn>
       <SupportedGrantTypes>
           <!-- This part is very important: most real OAuth 2.0 apps will want to use other
            grant types. In this case it is important to NOT include the "client_credentials"
            type because it allows a client to get access to a token with no user authentication -->
           <GrantType>client_credentials</GrantType>
       </SupportedGrantTypes>
       <GrantType>request.queryparam.grant_type</GrantType>
       <GenerateResponse/>
   </OAuthV2>

   কনফিগারেশনের মধ্যে নিম্নলিখিত বিষয়গুলি অন্তর্ভুক্ত:

   • <Operation>, যা আগে থেকে সংজ্ঞায়িত করা একাধিক মানের মধ্যে একটি হতে পারে, নীতিটি কী করবে তা নির্ধারণ করে। এই ক্ষেত্রে, এটি একটি অ্যাক্সেস টোকেন তৈরি করতে চলেছে।
   • টোকেন তৈরি হওয়ার ১ ঘণ্টা (৩৬০০০০০ মিলিসেকেন্ড) পরে মেয়াদ শেষ হয়ে যাবে।
   • <SupportedGrantTypes>-এ, OAuth <GrantType> ব্যবহার করা হবে বলে আশা করা হচ্ছে client_credentials (OAuth টোকেনের জন্য গ্রাহকের কী ও সিক্রেট এক্সচেঞ্জ করা)।
   • দ্বিতীয় <GrantType> এলিমেন্টটি নীতিকে বলে যে OAuth 2.0 স্পেসিফিকেশন অনুযায়ী গ্র্যান্ট টাইপ প্যারামিটারের জন্য API কলে কোথায় খুঁজতে হবে। (আপনি এটি API কলে পরে দেখতে পাবেন)। এছাড়াও, HTTP হেডার (request.header.grant_type) বা ফর্ম প্যারামিটার (request.formparam.grant_type) হিসেবে গ্র্যান্টের ধরন পাঠানো যেতে পারে।

এই মুহূর্তে API প্রক্সি নিয়ে আপনাকে আর কিছু করতে হবে না। পরবর্তী ধাপে, OAuth অ্যাক্সেস টোকেন তৈরি করতে আপনি এই API প্রক্সি ব্যবহার করবেন। তবে তার আগে, আপনাকে আরও কয়েকটি কাজ করতে হবে:

• OAuth-এর মাধ্যমে আপনি যে API প্রক্সি সুরক্ষিত করতে চান সেটি তৈরি করুন।
• আরও কিছু আর্টিফ্যাক্ট তৈরি করুন যার ফলে কনজিউমার কী ও কনজিউমার সিক্রেট তৈরি হবে অ্যাক্সেস টোকেনের জন্য আপনাকে এগুলি এক্সচেঞ্জ করতে হবে।

OAuth-সুরক্ষিত API প্রক্সি তৈরি করা

এখন আপনি সেই API প্রক্সি তৈরি করতে চলেছেন যেটি সুরক্ষিত রাখতে চান। এটি হল সেই API কল যা আপনার প্রয়োজনীয় কিছু রিটার্ন করে। এই ক্ষেত্রে, API প্রক্সি আপনার IP অ্যাড্রেস রিটার্ন করার জন্য Apigee-এর মকটার্গেট পরিষেবাকে কল করবে। তবে, আপনার API কলের সাথে একটি বৈধ OAuth অ্যাক্সেস টোকেন পাস করলেই আপনি এটি দেখতে পাবেন।

আপনি এখানে যে API প্রক্সি তৈরি করবেন তাতে এমন একটি নীতি অন্তর্ভুক্ত থাকবে যা অনুরোধে OAuth টোকেন আছে কিনা তা চেক করে।

1. বাঁদিকের নেভিগেশন বারে ডেভেলপ করুন > API প্রক্সি বিকল্প বেছে নিন।
2. + প্রক্সি বিকল্পে ক্লিক করুন।
   
3. প্রক্সি তৈরি করুন উইজার্ডে, রিভার্স প্রক্সি (সবচেয়ে সাধারণ) বিকল্প বেছে নিন, এবং পরবর্তী বিকল্পে ক্লিক করুন।
4. নিম্নলিখিত বিষয়গুলি দিয়ে প্রক্সি কনফিগার করুন:
   

   এই ফিল্ডে	এটি করুন
   প্রক্সির নাম	এন্টার করুন: helloworld_oauth2
   প্রোজেক্ট বেস পাথ	পরিবর্তন করে: /hellooauth2 প্রোজেক্ট বেস পাথ হল URL-এর অংশ যা API প্রক্সি সার্ভারে অনুরোধ করার জন্য ব্যবহার করা হয়।
   আগে থেকে থাকা API	এন্টার করুন: https://mocktarget.apigee.net/ip এটি সেই টার্গেট URL নির্ধারণ করে যা API প্রক্সি করার অনুরোধে Apigee Edge আহ্বান করে।
   বিবরণ	এন্টার করুন: hello world protected by OAuth

5. পরবর্তী বিকল্পে ক্লিক করুন।
6. সাধারণ নীতি পৃষ্ঠায়:

   এই ফিল্ডে	এটি করুন
   নিরাপত্তা: অনুমোদন	বেছে নিন: OAuth 2.0

7. পরবর্তী বিকল্পে ক্লিক করুন।
8. ভার্চুয়াল হোস্ট পৃষ্ঠায়, পরবর্তী বিকল্পে ক্লিক করুন।
9. বিল্ড পৃষ্ঠায়, টেস্ট এনভায়রনমেন্ট বেছে নেওয়া হয়েছে কিনা তা নিশ্চিত করুন এবং তৈরি ও ডেপ্লয় করুন বিকল্পে ক্লিক করুন।
10. সারসংক্ষেপ পৃষ্ঠায়, আপনি একটি স্বীকৃতি দেখতে পাবেন যে আপনার নতুন API প্রক্সি সফলভাবে তৈরি করা হয়েছে এবং API প্রক্সিটি আপনার টেস্ট এনভায়রনমেন্টে ডেপ্লয় করা হয়েছে।
11. API প্রক্সির ওভারভিউ পৃষ্ঠা দেখতে প্রক্সি এডিট করুন বিকল্পে ক্লিক করুন।
    মনে রাখবেন, এইবার API প্রক্সি অটোমেটিক ডেপ্লয় করা হয়েছে। "টেস্ট" এনভায়রনমেন্টের পাশে সবুজ রঙের ডিপ্লয়মেন্ট ডট আছে কিনা তা নিশ্চিত করতে, ডিপ্লয়মেন্ট ড্রপ-ডাউনে ক্লিক করুন।