VerifyJWT নীতি

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

কী

ক্লায়েন্ট বা অন্যান্য সিস্টেমের থেকে পাওয়া JWT-তে থাকা স্বাক্ষর যাচাই করে। এছাড়াও, এই নীতি দাবিগুলিকে প্রসঙ্গ ভেরিয়েবলে এক্সট্র্যাক্ট করে যাতে পরবর্তী নীতি বা শর্তাবলী অনুমোদন বা রাউটিং সংক্রান্ত সিদ্ধান্ত নেওয়ার জন্য সেইসব ভ্যালু পরীক্ষা করতে পারে। বিস্তারিত ভূমিকা পেতে JWS ও JWT নীতি ওভারভিউ দেখুন।

এই নীতি কার্যকর হলে, Edge একটি JWT-এর স্বাক্ষর যাচাই করে এবং JWT-এর মেয়াদ শেষ হওয়ার সময় এবং এর আগে নয় এমন সময় অনুসারে JWT বৈধ কিনা তা যাচাই করে, যদি সেগুলি উপস্থিত থাকে। এছাড়াও, নীতিটি ঐচ্ছিকভাবে JWT-তে নির্দিষ্ট দাবিগুলির মান যাচাই করতে পারে, যেমন সাবজেক্ট, ইস্যুকারী, অডিয়েন্স বা অতিরিক্ত দাবির মান।

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

JWT-এর অংশ এবং সেগুলি কীভাবে এনক্রিপ্ট ও সাইন করা হয় সেই সম্পর্কে জানতে, RFC7519 দেখুন।

ভিডিও

JWT-তে কীভাবে স্বাক্ষর যাচাই করতে হয় তা জানতে একটি ছোট ভিডিও দেখুন।

নমুনা

• HS256 অ্যালগরিদম দিয়ে সই করা JWT যাচাই করা
• RS256 অ্যালগরিদম দিয়ে সই করা JWT যাচাই করুন

HS256 অ্যালগরিদম দিয়ে সই করা JWT যাচাই করা

এই উদাহরণ নীতিটি HS256 এনক্রিপশন অ্যালগরিদম, HMAC ব্যবহার করে সাইন করা একটি JWT যাচাই করে, যা SHA-256 চেকসাম ব্যবহার করে। JWT, jwt নামের একটি ফর্ম প্যারামিটার ব্যবহার করে প্রক্সি অনুরোধে পাস করা হয়। private.secretkey নামের ভেরিয়েবলে কী রয়েছে। নীতিতে কীভাবে অনুরোধ করতে হয় তা সহ সম্পূর্ণ উদাহরণের জন্য উপরের ভিডিওটি দেখুন।

নীতি কনফিগারেশনে JWT ডিকোড ও মূল্যায়ন করার জন্য Edge-এর প্রয়োজনীয় তথ্য থাকে, যেমন, JWT কোথায় পাওয়া যাবে (সোর্স এলিমেন্টে নির্দিষ্ট করা ফ্লো ভেরিয়েবলে), প্রয়োজনীয় সিগনিচার অ্যালগরিদম, সিক্রেট কী কোথায় পাওয়া যাবে (Edge ফ্লো ভেরিয়েবলে সেভ করা থাকে, যা Edge KVM থেকে পাওয়া যেতে পারে, যেমন) এবং প্রয়োজনীয় দাবি ও সেগুলির মান।

<VerifyJWT name="JWT-Verify-HS256">
    <DisplayName>JWT Verify HS256</DisplayName>
    <Algorithm>HS256</Algorithm>
    <Source>request.formparam.jwt</Source>
    <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
    <SecretKey encoding="base64">
        <Value ref="private.secretkey"/>
    </SecretKey>
    <Subject>monty-pythons-flying-circus</Subject>
    <Issuer>urn://apigee-edge-JWT-policy-test</Issuer>
    <Audience>fans</Audience>
    <AdditionalClaims>
        <Claim name="show">And now for something completely different.</Claim>
    </AdditionalClaims>
</VerifyJWT>

নীতিটি তার আউটপুটকে কনটেক্সট ভেরিয়েবলে লেখে যাতে API প্রক্সিতে পরবর্তী নীতি বা শর্তাবলী সেইসব ভ্যালু পরীক্ষা করতে পারে। এই নীতি দ্বারা সেট করা ভেরিয়েবলের তালিকার জন্য ফ্লো ভেরিয়েবল দেখুন।

RS256 অ্যালগরিদম দিয়ে সই করা JWT যাচাই করা

এই উদাহরণ নীতি RS256 অ্যালগরিদম দিয়ে সাইন করা JWT যাচাই করে। যাচাই করতে, আপনাকে পাবলিক কী দিতে হবে। JWT, jwt নামের একটি ফর্ম প্যারামিটার ব্যবহার করে প্রক্সি অনুরোধে পাস করা হয়। public.publickey নামের ভেরিয়েবলে সর্বজনীন কী থাকে। নীতিতে কীভাবে অনুরোধ করতে হয় তা সহ সম্পূর্ণ উদাহরণের জন্য উপরের ভিডিওটি দেখুন।

এই নমুনা নীতির প্রতিটি এলিমেন্টের প্রয়োজনীয়তা ও বিকল্প সম্পর্কে বিস্তারিত জানতে এলিমেন্ট রেফারেন্স দেখুন।

<VerifyJWT name="JWT-Verify-RS256">
    <Algorithm>RS256</Algorithm>
    <Source>request.formparam.jwt</Source>
    <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
    <PublicKey>
        <Value ref="public.publickey"/>
    </PublicKey>
    <Subject>apigee-seattle-hatrack-montage</Subject>
    <Issuer>urn://apigee-edge-JWT-policy-test</Issuer>
    <Audience>urn://c60511c0-12a2-473c-80fd-42528eb65a6a</Audience>
    <AdditionalClaims>
        <Claim name="show">And now for something completely different.</Claim>    
    </AdditionalClaims>
</VerifyJWT>

উপরের কনফিগারেশনের জন্য, এই হেডার সহ JWT …

{
  "typ" : "JWT", 
  "alg" : "RS256"
}

এবং এই পেলোড …

{ 
  "sub" : "apigee-seattle-hatrack-montage",
  "iss" : "urn://apigee-edge-JWT-policy-test",
  "aud" : "urn://c60511c0-12a2-473c-80fd-42528eb65a6a",
  "show": "And now for something completely different."
}

… সঠিক বলে বিবেচিত হবে, যদি প্রদত্ত পাবলিক কী দিয়ে সিগনেচার যাচাই করা যায়।

একই হেডার সহ JWT কিন্তু এই পেলোড সহ …

{ 
  "sub" : "monty-pythons-flying-circus",
  "iss" : "urn://apigee-edge-JWT-policy-test",
  "aud" : "urn://c60511c0-12a2-473c-80fd-42528eb65a6a",
  "show": "And now for something completely different."
}

… অবৈধ হিসেবে বিবেচিত হবে, এমনকি সিগনেচার যাচাই করা গেলেও, কারণ JWT-তে অন্তর্ভুক্ত "sub" দাবিটি নীতি কনফিগারেশনে নির্দিষ্ট করা "Subject" এলিমেন্টের প্রয়োজনীয় ভ্যালুর সাথে ম্যাচ করে না।

নীতিটি তার আউটপুটকে কনটেক্সট ভেরিয়েবলে লেখে যাতে API প্রক্সিতে পরবর্তী নীতি বা শর্তাবলী সেইসব ভ্যালু পরীক্ষা করতে পারে। এই নীতি দ্বারা সেট করা ভেরিয়েবলের তালিকার জন্য ফ্লো ভেরিয়েবল দেখুন।

মূল এলিমেন্ট সেট করা

JWT যাচাই করার জন্য ব্যবহৃত কী নির্দিষ্ট করতে আপনি যেসব এলিমেন্ট ব্যবহার করেন তা বেছে নেওয়া অ্যালগরিদমের উপর নির্ভর করে, নিচের টেবিলে যেমন দেখানো হয়েছে:

<SecretKey encoding="base16|hex|base64|base64url">
  <Value ref="private.secretkey"/>
</SecretKey>

<PublicKey>
  <Value ref="rsa_public_key_or_value"/>
</PublicKey>

<PublicKey>
  <Certificate ref="signed_cert_val_ref"/>
</PublicKey>

<PublicKey>
  <JWKS ref="jwks_val_or_ref"/>
</PublicKey>

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

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

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

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

<VerifyJWT name="JWT" continueOnError="false" enabled="true" async="false">

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

<DisplayName>

<DisplayName>Policy Display Name</DisplayName>

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

<Algorithm>

<Algorithm>HS256</Algorithm>

টোকেনে সই করার জন্য এনক্রিপশন অ্যালগরিদম নির্দিষ্ট করে। RS*/PS*/ES* অ্যালগরিদম পাবলিক/সিক্রেট কী পেয়ার ব্যবহার করে, অন্যদিকে HS* অ্যালগরিদম শেয়ার করা সিক্রেট ব্যবহার করে। এছাড়াও সিগনেচার এনক্রিপশন অ্যালগরিদম সম্পর্কে দেখুন।

আপনি কমা দিয়ে আলাদা করা একাধিক মান নির্দিষ্ট করতে পারবেন। যেমন, "HS256, HS512" অথবা "RS256, PS256"। তবে, আপনি HS* অ্যালগরিদমকে অন্য কোনও অ্যালগরিদমের সাথে বা ES* অ্যালগরিদমকে অন্য কোনও অ্যালগরিদমের সাথে একত্রিত করতে পারবেন না কারণ সেগুলির জন্য নির্দিষ্ট কী ধরনের প্রয়োজন। আপনি RS* ও PS* অ্যালগরিদম একসাথে ব্যবহার করতে পারবেন।

<Audience>

<Audience>audience-here</Audience>

or:

<Audience ref='variable-name-here'/>

নীতিটি যাচাই করে যে JWT-তে থাকা অডিয়েন্স দাবিটি কনফিগারেশনে উল্লেখ করা ভ্যালুর সাথে মিলছে কিনা। কোনও ম্যাচ না থাকলে, নীতিটি একটি সমস্যা দেখায়। এই দাবিটি সেইসব প্রাপকদের শনাক্ত করে যাদের জন্য JWT তৈরি করা হয়েছে। এটি RFC7519-এ উল্লেখ করা রেজিস্টার করা দাবিগুলির মধ্যে একটি।

<AdditionalClaims/Claim>

<AdditionalClaims>
    <Claim name='claim1'>explicit-value-of-claim-here</Claim>
    <Claim name='claim2' ref='variable-name-here'/>
    <Claim name='claim3' ref='variable-name-here' type='boolean'/>
 </AdditionalClaims>

or:

<AdditionalClaims ref='claim_payload'/>

JWT পেলোডে নির্দিষ্ট অতিরিক্ত দাবি আছে কিনা এবং দাবি করা ভ্যালু ম্যাচ করছে কিনা তা যাচাই করে।

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

<Claim> এলিমেন্ট এই অ্যাট্রিবিউটগুলি নেয়:

• name - (আবশ্যক) দাবির নাম।
• ref - (ঐচ্ছিক) ফ্লো ভেরিয়েবলের নাম। উপস্থিত থাকলে, নীতিটি এই ভেরিয়েবলের ভ্যালুকে দাবি হিসেবে ব্যবহার করবে। ref অ্যাট্রিবিউট ও স্পষ্ট দাবি ভ্যালু, দু'টিই উল্লেখ করা থাকলে, স্পষ্ট ভ্যালু ডিফল্ট হিসেবে ধরে নেওয়া হয় এবং রেফারেন্স করা ফ্লো ভেরিয়েবল সমাধান না করা গেলে এটি ব্যবহার করা হয়।
• type - (ঐচ্ছিক) এগুলির মধ্যে একটি: string (ডিফল্ট), number, boolean বা map
• array - (ঐচ্ছিক) ভ্যালু যদি কোনও ধরনের অ্যারে হয়, তাহলে তা বোঝাতে true হিসেবে সেট করুন। ডিফল্ট: false.

আপনি <Claim> এলিমেন্ট যোগ করলে, নীতি কনফিগার করার সময় দাবিগুলির নাম স্ট্যাটিক হিসেবে সেট করা হয়। বিকল্প হিসেবে, আপনি দাবিগুলির নাম নির্দিষ্ট করতে একটি JSON অবজেক্ট পাস করতে পারেন। JSON অবজেক্টটি ভেরিয়েবল হিসেবে পাস করা হয় বলে, রানটাইমে দাবিগুলির নাম নির্ধারণ করা হয়।

যেমন:

<AdditionalClaims ref='json_claims'/>

যেখানে ভেরিয়েবল json_claims-এ এই ফর্মের JSON অবজেক্ট আছে:

{
  "sub" : "person@example.com",
  "iss" : "urn://secure-issuer@example.com",
  "non-registered-claim" : {
    "This-is-a-thing" : 817,
    "https://example.com/foobar" : { "p": 42, "q": false }
  }
}

<AdditionalHeaders/Claim>

<AdditionalHeaders>
    <Claim name='claim1'>explicit-value-of-claim-here</Claim>
    <Claim name='claim2' ref='variable-name-here'/>
    <Claim name='claim3' ref='variable-name-here' type='boolean'/>
    <Claim name='claim4' ref='variable-name' type='string' array='true'/>
 </AdditionalHeaders>

JWT হেডারে নির্দিষ্ট অতিরিক্ত দাবি সংক্রান্ত নাম/ভ্যালু পেয়ার আছে কিনা এবং দাবি করা ভ্যালু ম্যাচ করছে কিনা তা যাচাই করে।

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

<Claim> এলিমেন্ট এই অ্যাট্রিবিউটগুলি নেয়:

• name - (আবশ্যক) দাবির নাম।
• ref - (ঐচ্ছিক) ফ্লো ভেরিয়েবলের নাম। উপস্থিত থাকলে, নীতিটি এই ভেরিয়েবলের ভ্যালুকে দাবি হিসেবে ব্যবহার করবে। ref অ্যাট্রিবিউট ও স্পষ্ট দাবি ভ্যালু, দু'টিই উল্লেখ করা থাকলে, স্পষ্ট ভ্যালু ডিফল্ট হিসেবে ধরে নেওয়া হয় এবং রেফারেন্স করা ফ্লো ভেরিয়েবল সমাধান না করা গেলে এটি ব্যবহার করা হয়।
• type - (ঐচ্ছিক) এগুলির মধ্যে একটি: string (ডিফল্ট), number, boolean বা map
• array - (ঐচ্ছিক) ভ্যালু যদি কোনও ধরনের অ্যারে হয়, তাহলে তা বোঝাতে true হিসেবে সেট করুন। ডিফল্ট: false.

<CustomClaims>

মনে রাখবেন: বর্তমানে, আপনি UI-এর মাধ্যমে নতুন GenerateJWT নীতি যোগ করলে, একটি CustomClaims এলিমেন্ট যোগ করা হয়। এই এলিমেন্ট কাজ করে না এবং এটি উপেক্ষা করা হয়। এর পরিবর্তে ব্যবহার করার জন্য সঠিক এলিমেন্ট হল <AdditionalClaims>। UI পরে সঠিক এলিমেন্ট যোগ করার জন্য আপডেট করা হবে।

<Id>

<Id>explicit-jti-value-here</Id>
 -or-
<Id ref='variable-name-here'/>
 -or-
<Id/>

JWT-তে নির্দিষ্ট jti দাবি আছে কিনা তা যাচাই করে। টেক্সট ভ্যালু এবং ref অ্যাট্রিবিউট, দুটিই খালি থাকলে, নীতিটি একটি র‍্যান্ডম UUID সহ jti জেনারেট করবে। JWT ID (jti) দাবি হল JWT-এর জন্য অনন্য শনাক্তকারী। jti সম্পর্কে আরও তথ্যের জন্য, RFC7519 দেখুন।

<IgnoreCriticalHeaders>

<IgnoreCriticalHeaders>true|false</IgnoreCriticalHeaders>

JWT-এর crit হেডারে তালিকাভুক্ত কোনও হেডার <KnownHeaders> এলিমেন্টে তালিকাভুক্ত না থাকলে, আপনি যদি চান যে নীতিটি একটি সমস্যা দেখাক, তাহলে এটিকে false হিসেবে সেট করুন। VerifyJWT নীতিকে crit হেডার উপেক্ষা করতে বাধ্য করার জন্য true হিসেবে সেট করা হয়।

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

<IgnoreIssuedAt>

<IgnoreIssuedAt>true|false</IgnoreIssuedAt>

JWT-তে যদি ভবিষ্যতের কোনও সময় উল্লেখ করা iat (ইস্যু করা হয়েছে) দাবি থাকে, তাহলে আপনি যদি চান যে নীতিটি একটি সমস্যা দেখাক, তাহলে এটিকে false (ডিফল্ট) হিসেবে সেট করুন। যাচাইকরণের সময় নীতি যাতে iat উপেক্ষা করে চলে সেই জন্য 'সত্য' হিসেবে সেট করা হয়।

<IgnoreUnresolvedVariables>

<IgnoreUnresolvedVariables>true|false</IgnoreUnresolvedVariables>

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

<Issuer>

<Issuer ref='variable-name-here'/>
<Issuer>issuer-string-here</Issuer>

JWT-এর ইস্যুকারী কনফিগারেশন এলিমেন্টে উল্লেখ করা স্ট্রিংয়ের সাথে মিলছে কিনা তা নীতি যাচাই করে। JWT-এর ইস্যুকারীকে শনাক্ত করে এমন দাবি। এটি RFC7519-এ উল্লেখ করা রেজিস্টার করা দাবিগুলির সেটের মধ্যে একটি।

<KnownHeaders>

<KnownHeaders>a,b,c</KnownHeaders>

or:

<KnownHeaders ref=’variable_containing_headers’/>

GenerateJWT নীতি, JWT-তে crit হেডার পূরণ করতে <CriticalHeaders> এলিমেন্ট ব্যবহার করে। যেমন:

{
  “typ: “...”,
  “alg” : “...”,
  “crit” : [ “a”, “b”, “c” ],
}

VerifyJWT নীতি JWT-তে crit হেডার আছে কিনা তা পরীক্ষা করে দেখে এবং থাকলে, তালিকাভুক্ত প্রতিটি হেডারের জন্য <KnownHeaders> এলিমেন্টেও সেই হেডার তালিকাভুক্ত আছে কিনা তা চেক করে দেখে। <KnownHeaders> এলিমেন্টে crit-এ তালিকাভুক্ত আইটেমের সুপারসেট থাকতে পারে। crit-এ তালিকাভুক্ত সবকটি হেডারকে <KnownHeaders> এলিমেন্টে তালিকাভুক্ত হতে হবে। নীতি crit বিভাগে খুঁজে পেয়েছে এমন কোনও হেডার যা <KnownHeaders>-এও তালিকাভুক্ত নেই, VerifyJWT নীতি ব্যর্থ হওয়ার কারণ হয়।

আপনি ঐচ্ছিকভাবে VerifyJWT নীতি কনফিগার করে crit হেডার উপেক্ষা করতে পারেন, এর জন্য <IgnoreCriticalHeaders> এলিমেন্টকে true হিসেবে সেট করুন।

<PublicKey/Certificate>

<PublicKey>
   <Certificate ref="signed_public.cert"/>
</PublicKey>
-or-
<PublicKey>
    <Certificate>
    -----BEGIN CERTIFICATE-----
    cert data
    -----END CERTIFICATE-----
    </Certificate>
</PublicKey>

JWT-তে স্বাক্ষর যাচাই করার জন্য ব্যবহৃত স্বাক্ষরিত সার্টিফিকেট নির্দিষ্ট করে। ফ্লো ভেরিয়েবলে সাইন করা সার্টিফিকেট পাস করতে অথবা সরাসরি PEM-এনকোড করা সার্টিফিকেট নির্দিষ্ট করতে, ref অ্যাট্রিবিউট ব্যবহার করুন। অ্যালগরিদম RS256/RS384/RS512, PS256/PS384/PS512 অথবা ES256/ES384/ES512 হলে তবেই ব্যবহার করুন।

<PublicKey/JWKS>

<!-- Specify the JWKS. -->
<PublicKey>
   <JWKS>jwks-value-here</JWKS>
</PublicKey>

or:

<!-- Specify a variable containing the JWKS. -->
<PublicKey>
   <JWKS ref="public.jwks"/>
</PublicKey>

or:

<!-- Specify a public URL that returns the JWKS.
The URL is static, meaning you cannot set it using a variable. -->
<PublicKey>
   <JWKS uri="jwks-url"/>
</PublicKey>

JWKS ফর্ম্যাটে (RFC 7517) একটি মান নির্দিষ্ট করে যাতে সর্বজনীন কীয়ের একটি সেট থাকে। অ্যালগরিদম RS256/RS384/RS512, PS256/PS384/PS512 অথবা ES256/ES384/ES512 হলে তবেই ব্যবহার করুন।

ইনবাউন্ড JWT-তে যদি এমন কোনও কী আইডি থাকে যা JWKS-এর সেটে উপস্থিত থাকে, তাহলে JWT স্বাক্ষর যাচাই করার জন্য নীতিটি সঠিক পাবলিক কী ব্যবহার করবে। এই ফিচার সম্পর্কে বিস্তারিত জানতে, JWT যাচাই করার জন্য JSON ওয়েব কী সেট (JWKS) ব্যবহার করা দেখুন।

আপনি কোনও পাবলিক URL থেকে ভ্যালু ফেচ করলে, Edge ৩০০ সেকেন্ডের জন্য JWKS ক্যাশে করে। ক্যাশের মেয়াদ শেষ হয়ে গেলে, Edge আবার JWKS নিয়ে আসে।

<PublicKey/Value>

<PublicKey>
   <Value ref="public.publickeyorcert"/>
</PublicKey>
-or-
<PublicKey>
    <Value>
    -----BEGIN PUBLIC KEY-----
    MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAw2kPrRzcufvUNHvTH/WW
    Q0UrCw5c0+Y707KX3PpXkZGbtTT4nvU1jC0d1lHV8MfUyRXmpmnNxJHAC2F73IyN
    C5TBtXMORc+us7A2cTtC4gZV256bT4h3sIEMsDl0Joz9K9MPzVPFxa1i0RgNt06n
    Xn/Bs2UbbLlKP5Q1HPxewUDEh0gVMqz9wdIGwH1pPxKvd3NltYGfPsUQovlof3l2
    ALvO7i5Yrm96kknfFEWf1EjmCCKvz2vjVbBb6mp1ZpYfc9MOTZVpQcXSbzb/BWUo
    ZmkDb/DRW5onclGzxQITBFP3S6JXd4LNESJcTp705ec1cQ9Wp2Kl+nKrKyv1E5Xx
    DQIDAQAB
    -----END PUBLIC KEY-----
    </Value>
</PublicKey>

JWT-তে স্বাক্ষর যাচাই করার জন্য ব্যবহৃত পাবলিক কী বা পাবলিক সার্টিফিকেট নির্দিষ্ট করে। ফ্লো ভেরিয়েবলে কী/সার্টিফিকেট পাস করতে অথবা সরাসরি PEM-এনকোডেড কী উল্লেখ করতে, ref অ্যাট্রিবিউট ব্যবহার করুন। শুধুমাত্র তখনই ব্যবহার করুন যখন অ্যালগরিদম RS256/RS384/RS512, PS256/PS384/PS512 অথবা ES256/ES384/ES512-এর মধ্যে কোনও একটি হয়।

<SecretKey/Value>

<SecretKey encoding="base16|hex|base64|base64url">
  <Value ref="private.your-variable-name"/>
</SecretKey>

HMAC অ্যালগরিদম ব্যবহার করে টোকেন যাচাই বা সাইন করার জন্য ব্যবহৃত সিক্রেট কী প্রদান করে। অ্যালগরিদম HS256, HS384, HS512-এর মধ্যে একটি হলে, শুধুমাত্র ব্যবহার করুন।.

<Source>

<Source>jwt-variable</Source>

উপস্থিত থাকলে, এটি সেই ফ্লো ভেরিয়েবল নির্দিষ্ট করে যেখানে নীতিটি যাচাই করার জন্য JWT খুঁজে পাওয়ার প্রত্যাশা করে।

<Subject>

<Subject>subject-string-here</Subject>

JWT-তে থাকা সাবজেক্ট, নীতি কনফিগারেশনে উল্লেখ করা স্ট্রিংয়ের সাথে ম্যাচ করছে কিনা তা নীতি যাচাই করে। এই দাবি JWT-এর বিষয়কে শনাক্ত করে বা সেটির ব্যাপারে বিবৃতি দেয়। এটি RFC7519-এ উল্লেখ করা স্ট্যান্ডার্ড দাবিগুলির মধ্যে একটি।

<TimeAllowance>

<TimeAllowance>120s</TimeAllowance>

times-এর জন্য "গ্রেস পিরিয়ড"। যেমন, সময়সীমা ৬০ সেকেন্ড হিসেবে কনফিগার করা থাকলে, JWT-এর মেয়াদ শেষ হয়ে গেলেও, দাবি করা মেয়াদ শেষ হওয়ার পরে ৬০ সেকেন্ড পর্যন্ত সেটি বৈধ হিসেবেই গণ্য করা হবে। not-before-time-এর ক্ষেত্রেও একই মূল্যায়ন করা হবে। ডিফল্ট মান হল ০ সেকেন্ড (কোনও গ্রেস পিরিয়ড নেই)।

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

সাফল্যের পরে, JWT যাচাই করুন এবং JWT ডিকোড নীতিগুলি এই প্যাটার্ন অনুসারে প্রসঙ্গ ভেরিয়েবল সেট করে:

jwt.{policy_name}.{variable_name}

উদাহরণ স্বরূপ, যদি পলিসির নাম jwt-parse-token হয়, তাহলে পলিসি JWT-এ উল্লেখিত বিষয়কে jwt.jwt-parse-token.decoded.claim.sub নামের কনটেক্সট ভেরিয়েবলে সংরক্ষণ করবে। (পশ্চাদগামী সামঞ্জস্যের জন্য, এটি jwt.jwt-parse-token.claim.subject এও উপলব্ধ হবে)

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

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

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

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

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

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

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

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

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

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

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

    <FaultRules>
        <FaultRule name="JWT Policy Errors">
            <Step>
                <Name>JavaScript-1</Name>
                <Condition>(fault.name Matches "TokenExpired")</Condition>
            </Step>
            <Condition>JWT.failed=true</Condition>
        </FaultRule>
    </FaultRules>