এইচএমএসি নীতি

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

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

HMAC সম্পর্কে আরও জানতে, HMAC: Keyed-Hashing for Message Authentication (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-name</Algorithm>

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

<ডিসপ্লে নাম>

<DisplayName>Policy Display Name</DisplayName>

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

বার্তা

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

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

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

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

আউটপুট

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

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

<গোপন চাবি>

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

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

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

<যাচাইকরণ মান>

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

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

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

<IgnoreUnresolvedVariables>true|false</IgnoreUnresolvedVariables>

যদি আপনি চান যে পলিসিতে উল্লেখিত কোনো রেফারেন্সকৃত ভেরিয়েবল সমাধানযোগ্য না হলে পলিসিটি একটি ত্রুটি (error) দেখাবে, তাহলে এটিকে false সেট করুন। যেকোনো সমাধানযোগ্য নয় এমন ভেরিয়েবলকে একটি খালি স্ট্রিং (null) হিসেবে গণ্য করতে এটিকে 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>