BasicAuthentication নীতি

আপনি Apigee Edge ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশন দেখুন। তথ্য

কী

এটি আপনাকে শেষ-মাইল নিরাপত্তার জন্য লাইটওয়েট সাধারণ যাচাইকরণ ব্যবহার করতে দেয়। নীতিটি একটি ইউজারনেম ও পাসওয়ার্ড নেয়, সেগুলিকে Base64 এনকোড করে এবং ফলাফল পাওয়া ভ্যালু একটি ভেরিয়েবলে লেখে। ফলাফল Basic Base64EncodedString ফর্ম্যাটে দেখানো হয়। আপনি সাধারণত এই ভ্যালু HTTP হেডারে লেখেন, যেমন অনুমোদন হেডার।

এছাড়াও, এই নীতি আপনাকে Base64 এনকোড করা স্ট্রিংয়ে সেভ করা ক্রেডেনশিয়ালকে ইউজারনেম ও পাসওয়ার্ডে ডিকোড করতে দেয়।

নমুনা

<BasicAuthentication name="ApplyBasicAuthHeader">
   <DisplayName>ApplyBasicAuthHeader</DisplayName>
   <Operation>Encode</Operation>
   <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
   <User ref="credentials.username" />
   <Password ref="credentials.password" />
   <AssignTo createNew="false">request.header.Authorization</AssignTo>
</BasicAuthentication>

{
  "encrypted" : true,
  "entry" : [ {
    "name" : "username",
    "value" : "MyUsername"
  }, {
    "name" : "password",
    "value" : "MyPassword"
  } ],
  "name" : "BasicAuthCredentials"
}
      

<KeyValueMapOperations name="getCredentials" mapIdentifier="BasicAuthCredentials">
  <Scope>apiproxy</Scope>
  <Get assignTo="credentials.username" index='1'>
    <Key>
      <Parameter>username</Parameter>
    </Key>
  </Get>
  <Get assignTo="credentials.password" index='1'>
    <Key>
      <Parameter>password</Parameter>
    </Key>
  </Get>
</KeyValueMapOperations>
      

<BasicAuthentication name="DecodeBaseAuthHeaders">
   <DisplayName>Decode Basic Authentication Header</DisplayName>
   <Operation>Decode</Operation>
   <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
   <User ref="request.header.username" />
   <Password ref="request.header.password" />
   <Source>request.header.Authorization</Source>
</BasicAuthentication>

সাধারণ যাচাইকরণ নীতি সম্পর্কে

এই নীতির দুটি অপারেশন মোড আছে:

• এনকোড করা: Base64 এনকোড করা একটি ইউজারনেম ও পাসওয়ার্ড যা ভেরিয়েবলে সেভ করা থাকে
• ডিকোড করা: Base64 এনকোড করা স্ট্রিং থেকে ইউজারনেম ও পাসওয়ার্ড ডিকোড করে

ইউজারনেম ও পাসওয়ার্ড সাধারণত কী/ভ্যালু স্টোরে সেভ করা হয় এবং তারপরে রানটাইমে কী/ভ্যালু স্টোর থেকে পড়া হয়। কী/ভ্যালু স্টোর ব্যবহার করা সংক্রান্ত বিবরণের জন্য, কী ভ্যালু ম্যাপ অপারেশন নীতি দেখুন।

এলিমেন্ট রেফারেন্স

এলিমেন্ট রেফারেন্সে BasicAuthentication নীতির এলিমেন্ট ও অ্যাট্রিবিউট বর্ণনা করা আছে।

<BasicAuthentication async="false" continueOnError="false" enabled="true" name="Basic-Authentication-1">
   <DisplayName>Basic Authentication 1</DisplayName>
   <Operation>Encode</Operation>
   <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
   <User ref="credentials.username" />
   <Password ref="credentials.password" />
   <AssignTo createNew="false">request.header.Authorization</AssignTo>
   <Source>request.header.Authorization</Source> 
</BasicAuthentication>

<BasicAuthentication> অ্যাট্রিবিউট

<BasicAuthentication async="false" continueOnError="false" enabled="true" name="Basic-Authentication-1">

নিম্নলিখিত সারণী সমস্ত নীতির মূল উপাদানগুলির জন্য সাধারণ বৈশিষ্ট্যগুলি বর্ণনা করে:

<DisplayName> উপাদান

ম্যানেজমেন্ট UI প্রক্সি এডিটরে নীতিটিকে একটি ভিন্ন, প্রাকৃতিক-ভাষা নামের সাথে লেবেল করতে name বৈশিষ্ট্য ছাড়াও ব্যবহার করুন।

<DisplayName>Policy Display Name</DisplayName>

<Operation> এলিমেন্ট

নীতিটি Base64 এনকোড বা ডিকোড করে কিনা তা নির্ধারণ করে।

<Operation>Encode</Operation>

<IgnoreUnresolvedVariables> এলিমেন্ট

true হিসেবে সেট করা থাকলে, কোনও ভেরিয়েবেল সমাধান করা না গেলে নীতিটি কোনও সমস্যা দেখাবে না। BasicAuthentication নীতির প্রসঙ্গে ব্যবহার করা হলে, এই সেটিং সাধারণত false হিসেবে সেট করা হয়, কারণ নির্দিষ্ট ভেরিয়েবলে কোনও ইউজারনেম বা পাসওয়ার্ড খুঁজে না পেলে একটি সমস্যা দেখানো সাধারণত ভাল।

<IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>

<User> এলিমেন্ট

• এনকোডিংয়ের জন্য, ব্যবহারকারীর নাম থাকা ভেরিয়েবল নির্দিষ্ট করতে <User> এলিমেন্ট ব্যবহার করুন। Base64 এনকোডিংয়ের আগে ইউজারনেম ও পাসওয়ার্ডের ভ্যালু কোলন দিয়ে কনক্যাটেনেট করা হয়।
• ডিকোড করার জন্য, ডিকোড করা ইউজারনেম যেখানে লেখা আছে সেই ভেরিয়েবল নির্দিষ্ট করুন।

<User ref="credentials.username" /> 

অ্যাট্রিবিউট

<Password> এলিমেন্ট

• এনকোডিংয়ের জন্য, পাসওয়ার্ড থাকা ভেরিয়েবল নির্দিষ্ট করতে <Password> এলিমেন্ট ব্যবহার করুন ।
• ডিকোড করার জন্য, ডিকোড করা পাসওয়ার্ড যেখানে লেখা আছে সেই ভেরিয়েবল নির্দিষ্ট করুন।

<Password ref="credentials.password" />

অ্যাট্রিবিউট

<AssignTo> এলিমেন্ট

Encode অপারেশনের জন্য, এই নীতি দ্বারা তৈরি এনকোড করা ভ্যালু দিয়ে সেট করার জন্য টার্গেট ভেরিয়েবল নির্দিষ্ট করে।

নিম্নলিখিত উদাহরণ থেকে বোঝা যায় যে নীতিতে মেসেজের Authorization হেডারকে জেনারেট করা ভ্যালু হিসেবে সেট করতে হবে:

<AssignTo createNew="false">request.header.Authorization</AssignTo>

অ্যাট্রিবিউট

<Source> এলিমেন্ট

ডিকোড করার জন্য, Base64 এনকোড করা স্ট্রিং সহ ভেরিয়েবলটি Basic Base64EncodedString ফর্ম্যাটে থাকতে হবে। যেমন, অনুমোদন হেডারের সাথে সম্পর্কিত request.header.Authorization নির্দিষ্ট করুন।

<Source>request.header.Authorization</Source>

ফ্লো ভেরিয়েবল

নীতি কাজ না করলে, নিম্নলিখিত ফ্লো ভেরিয়েবল সেট করা হয়:

• BasicAuthentication.{policy_name}.failed (যার ভ্যালু true)

সমস্যার রেফারেন্স

এই নীতি কোনও সমস্যার কারণে ট্রিগার হলে, Edge-এর মাধ্যমে ফেরত আসা ফল্ট কোড ও সমস্যার মেসেজ এবং সেট করা ফল্ট ভেরিয়েবল সম্পর্কে এই বিভাগে বর্ণনা করা হয়েছে। সমস্যা সমাধানের জন্য আপনি যদি ফল্ট রুল তৈরি করেন, তাহলে এই তথ্য আপনার জানা প্রয়োজন। আরও জানতে, নীতি সংক্রান্ত সমস্যা সম্পর্কে আপনার যা জানা প্রয়োজন এবং ত্রুটি মোকাবেলা করা দেখুন।

রানটাইম সমস্যা

নীতি এক্সিকিউট করার সময় এই সমস্যা হতে পারে।

ডিপ্লয়মেন্ট সংক্রান্ত সমস্যা

এই নীতি থাকা কোনও প্রক্সি আপনি প্রয়োগ করলে, এই সমস্যা হতে পারে।

ফল্ট ভেরিয়েবল

রানটাইম এরর হলে এই ভেরিয়েবল সেট করা হয়। আরও তথ্যের জন্য, নীতি সংক্রান্ত সমস্যার ব্যাপারে আপনার কী জানা প্রয়োজন দেখুন।

সমস্যার উত্তরের উদাহরণ

{  
   "fault":{  
      "detail":{  
         "errorcode":"steps.basicauthentication.UnresolvedVariable"
      },
      "faultstring":"Unresolved variable : request.queryparam.password"
   }
}

ভুল নিয়মের উদাহরণ

<FaultRule name="Basic Authentication Faults">
    <Step>
        <Name>AM-UnresolvedVariable</Name>
        <Condition>(fault.name Matches "UnresolvedVariable") </Condition>
    </Step>
    <Step>
        <Name>AM-AuthFailedResponse</Name>
        <Condition>(fault.name = "InvalidBasicAuthenticationSource")</Condition>
    </Step>
    <Condition>(BasicAuthentication.BA-Authentication.failed = true) </Condition>
</FaultRule>

স্কিমা

সম্পর্কিত বিষয়

কী ভ্যালু ম্যাপ অপারেশন নীতি