HMAC নীতি

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

একটি হ্যাশ-ভিত্তিক মেসেজ যাচাইকরণ কোড (HMAC) গণনা ও যাচাই করে। কখনও কখনও 'কীড মেসেজ যাচাইকারী কোড' বা 'কীড হ্যাশ' নামে পরিচিত, HMAC একটি ক্রিপ্টোগ্রাফিক হ্যাশ ফাংশন ব্যবহার করে, যেমন SHA-1, SHA-224, SHA-256, SHA-384, SHA-512 বা MD-5, যা একটি "মেসেজে" প্রয়োগ করা হয়, সাথে একটি গোপন কী, যাতে সেই মেসেজে একটি সিগনেচার বা মেসেজ যাচাইকারী কোড তৈরি করা যায়। এখানে "মেসেজ" বলতে বাইট স্ট্রিমকে বোঝানো হয়েছে। মেসেজ প্রেরকও প্রাপককে HMAC পাঠাতে পারে, এবং প্রাপক মেসেজ যাচাই করার জন্য HMAC ব্যবহার করতে পারে।

HMAC সম্পর্কে আরও জানতে, মেসেজ যাচাইকরণের জন্য HMAC: কী-ভিত্তিক হ্যাশিং (rfc2104) দেখুন।

নমুনা

<HMAC name='HMAC-1'>

  <Algorithm>SHA256</Algorithm>

  <SecretKey ref='private.secretkey'/>

  <IgnoreUnresolvedVariables>true|false</IgnoreUnresolvedVariables> <!-- optional -->

  <!--
    The "message" can include fixed and multiple variable parts,
    including newlines and static functions.
    Whitespace is significant.
   -->
  <Message>Fixed Part
    {a_variable}
    {timeFormatUTCMs(timeFormatString1,system.timestamp)}
    {nonce}
  </Message>

  <!-- default encoding is base64 -->
  <Output encoding='base16'>name_of_variable</Output>

</HMAC>

<HMAC name='HMAC-1'>

  <Algorithm>SHA256</Algorithm>

  <SecretKey ref='private.secretkey'/>

  <IgnoreUnresolvedVariables>true|false</IgnoreUnresolvedVariables> <!-- optional -->

  <!--
    The "message" can include fixed and multiple variable parts,
    including newlines and static functions.
    Whitespace is significant.
   -->
  <Message>Fixed Part
    {a_variable}
    {timeFormatUTCMs(timeFormatString1,system.timestamp)}
    {nonce}
  </Message>

  <!--
    VerificationValue is optional.
    Include it to perform an HMAC check.
  -->
  <VerificationValue encoding='base16' ref='expected_hmac_value'/>

  <!-- default encoding is base64 -->
  <Output encoding='base16'>name_of_variable</Output>

</HMAC>

HMAC-এর জন্য এলিমেন্ট রেফারেন্স

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

টপ-লেভেল এলিমেন্টে প্রযোজ্য অ্যাট্রিবিউট

<HMAC name="HMAC" continueOnError="false" enabled="true" async="false">

সব নীতি সংক্রান্ত পেরেন্ট এলিমেন্টের ক্ষেত্রে নিম্নলিখিত অ্যাট্রিবিউট সাধারণ।

<Algorithm>

<Algorithm>algorithm-name</Algorithm>

HMAC গণনা করার জন্য হ্যাশ অ্যালগরিদম নির্দিষ্ট করে।

<DisplayName>

<DisplayName>Policy Display Name</DisplayName>

Apigee UI-এর প্রক্সি এডিটরে নীতিকে আলাদা, স্বাভাবিক-ভাষার নাম দিয়ে লেবেল করার জন্য নাম অ্যাট্রিবিউটের সাথে ব্যবহার করুন।

<Message>

<Message>message_template_here</Message>
or
<Message ref='variable_here'/>

স্বাক্ষর করার জন্য মেসেজ পেলোড নির্দিষ্ট করে। এই এলিমেন্টের ইনপুট মেসেজ টেমপ্লেট (ভেরিয়েবল সাবস্টিটিউশন) কাজ করে। এর ফলে রানটাইমে অতিরিক্ত আইটেম যোগ করা যায়, যেমন টাইমস্ট্যাম্প, ননস, হেডার বা অন্যান্য তথ্যের তালিকা। যেমন:

<Message>Fixed Part
    {a_variable}
    {timeFormatUTCMs(timeFormatString1,system.timestamp)}
    {nonce}
</Message>

মেসেজ টেমপ্লেটে নিউলাইন ও স্ট্যাটিক ফাংশন সহ ফিক্সড ও পরিবর্তনযোগ্য অংশ থাকতে পারে। হোয়াইটস্পেস গুরুত্বপূর্ণ।

<Output>

<Output encoding='encoding_name'>variable_name</Output>

কম্পিউট করা HMAC ভ্যালু সহ নীতিকে সেট করতে হবে এমন ভেরিয়েবলের নাম নির্দিষ্ট করে। এছাড়াও, আউটপুটের জন্য কোন এনকোডিং ব্যবহার করতে হবে তা নির্দিষ্ট করে।

<SecretKey>

<SecretKey encoding='encoding_name' ref='private.secretkey'/>

HMAC গণনা করার জন্য ব্যবহৃত সিক্রেট কী নির্দিষ্ট করে। নির্দিষ্ট এনকোডিং অনুযায়ী ডিকোড করা রেফারেন্সড ভেরিয়েবল থেকে কী পাওয়া যায়।

 <SecretKey encoding='hex' ref='private.encodedsecretkey'/>

<VerificationValue>

<VerificationValue encoding='encoding_name' ref='variable_name'/>
or
<VerificationValue encoding='encoding_name'>string_value</VerificationValue>

(ঐচ্ছিক) যাচাইকরণ মান এবং যাচাইকরণ মান এনকোড করার জন্য ব্যবহৃত এনকোডিং অ্যালগরিদম নির্দিষ্ট করে। নীতিটি ভ্যালু ডিকোড করার জন্য এই অ্যালগরিদম ব্যবহার করবে।

<IgnoreUnresolvedVariables>

<IgnoreUnresolvedVariables>true|false</IgnoreUnresolvedVariables>

নীতিতে উল্লেখ করা কোনও রেফারেন্স করা ভেরিয়েবল সমাধান করা না গেলে, আপনি যদি চান যে নীতিটি একটি সমস্যা দেখাক, তাহলে false হিসেবে সেট করুন। true-এ সেট করা থাকলে, সমাধান করা যায় না এমন যেকোনও ভেরিয়েবলকে খালি স্ট্রিং (নাল) হিসেবে বিবেচনা করা হবে।

IgnoreUnresolvedVariables বুলিয়ান শুধুমাত্র সেইসব ভেরিয়েবলকে প্রভাবিত করে যেগুলি মেসেজ টেমপ্লেট দ্বারা রেফারেন্স করা হয়। SecretKey ও VerificationValue ভেরিয়েবেল রেফারেন্স করতে পারলেও, দু'টিকেই সমাধানযোগ্য হতে হবে, তাই ignore সেটিং সেগুলির ক্ষেত্রে প্রযোজ্য হয় না।

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

নীতি এক্সিকিউশনের সময় এইসব ভেরিয়েবল সেট করতে পারে।

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

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

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

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

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

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

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

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

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

ত্রুটি পরিচালনার জন্য, সর্বোত্তম অনুশীলন হল ত্রুটি প্রতিক্রিয়ার errorcode অংশটি আটকে রাখা। faultstring -এ লেখার উপর নির্ভর করবেন না, কারণ এটি পরিবর্তন হতে পারে।

উদাহরণ দোষ নিয়ম

<FaultRules>
    <FaultRule name="HMAC Policy Errors">
        <Step>
            <Name>AM-Unauthorized</Name>
            <Condition>(fault.name Matches "HmacVerificationFailed")</Condition>
        </Step>
        <Condition>hmac.HMAC-1.failed = true</Condition>
    </FaultRule>
</FaultRules>