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

আপনি Apigee Edge-এর ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশন .info- তে যান।

কী

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

এই পলিসিটি আপনাকে 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 async="false" continueOnError="false" enabled="true" name="Basic-Authentication-1">

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

<DisplayName> উপাদান

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

<DisplayName>Policy Display Name</DisplayName>

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

পলিসিটি ক্রেডেনশিয়ালগুলিকে Base64 এনকোড করবে নাকি ডিকোড করবে, তা নির্ধারণ করে।

<Operation>Encode</Operation>

<IgnoreUnresolvedVariables> উপাদান

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

<IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>

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

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

<User ref="credentials.username" /> 

বৈশিষ্ট্য

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

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

<Password ref="credentials.password" />

বৈশিষ্ট্য

<AssignTo> উপাদান

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

নিম্নলিখিত উদাহরণটি নির্দেশ করে যে, পলিসিটি মেসেজের Authorization হেডারকে জেনারেট করা ভ্যালুটিতে সেট করবে:

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

বৈশিষ্ট্য

<উৎস> উপাদান

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

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

প্রবাহ পরিবর্তনশীল

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

• BasicAuthentication.{policy_name}.failed (যার মান true)

ত্রুটির রেফারেন্স

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

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

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

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

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

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

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

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

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

স্কিমা

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

মূল মান মানচিত্র কার্যক্রম নীতি