মৌলিক প্রমাণীকরণ নীতি

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

কি

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

নীতিটি আপনাকে একটি বেস64 এনকোড করা স্ট্রিং-এ সংরক্ষিত শংসাপত্রগুলিকে একটি ব্যবহারকারীর নাম এবং পাসওয়ার্ডে ডিকোড করতে দেয়৷

নমুনা

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

<বেসিক প্রমাণীকরণ> বৈশিষ্ট্য

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

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

<DisplayName> উপাদান

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

<DisplayName>Policy Display Name</DisplayName>

<অপারেশন> উপাদান

নীতি বেস64 শংসাপত্রগুলি এনকোড বা ডিকোড করে কিনা তা নির্ধারণ করে৷

<Operation>Encode</Operation>

<অমীমাংসিত ভেরিয়েবল> এলিমেন্টকে উপেক্ষা করুন

true সেট করা হলে, যদি একটি পরিবর্তনশীল সমাধান করা না যায় তবে নীতিটি একটি ত্রুটি নিক্ষেপ করবে না৷ একটি মৌলিক প্রমাণীকরণ নীতির প্রেক্ষাপটে ব্যবহার করা হলে, এই সেটিংটি সাধারণত false সেট করা হয় কারণ নির্দিষ্ট ভেরিয়েবলগুলিতে ব্যবহারকারীর নাম বা পাসওয়ার্ড পাওয়া না গেলে এটি একটি ত্রুটি নিক্ষেপ করা সাধারণত উপকারী।

<IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>

<ব্যবহারকারী> উপাদান

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

<User ref="request.queryparam.username" /> 

গুণাবলী

<পাসওয়ার্ড> উপাদান

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

<Password ref="request.queryparam.password" />

গুণাবলী

<AssignTo> উপাদান

এই নীতি দ্বারা উত্পন্ন এনকোড করা বা ডিকোড করা মান সহ সেট করার লক্ষ্য পরিবর্তনশীল নির্দিষ্ট করে৷

নিম্নলিখিত উদাহরণটি নির্দেশ করে যে নীতিটি বার্তাটির Authorization শিরোনামকে জেনারেট করা মানতে সেট করতে হবে:

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

গুণাবলী

<উৎস> উপাদান

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

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

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

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

• BasicAuthentication.{policy_name}.failed (সত্যের মান সহ)

ত্রুটি উল্লেখ

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

রানটাইম ত্রুটি

নীতি কার্যকর করার সময় এই ত্রুটিগুলি ঘটতে পারে৷

স্থাপনার ত্রুটি

আপনি যখন এই নীতি সম্বলিত একটি প্রক্সি স্থাপন করেন তখন এই ত্রুটিগুলি ঘটতে পারে৷

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

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

উদাহরণ ত্রুটি প্রতিক্রিয়া

{  
   "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>

স্কিমাস

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

মূল মান মানচিত্র অপারেশন নীতি