জেডাব্লুটি নীতি তৈরি করুন

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

কী

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

ভিডিও

কীভাবে একটি স্বাক্ষরিত JWT তৈরি করতে হয় তা শিখতে একটি সংক্ষিপ্ত ভিডিও দেখুন।

নমুনা

• HS256 অ্যালগরিদম ব্যবহার করে স্বাক্ষরিত একটি JWT তৈরি করুন।
• RS256 অ্যালগরিদম দ্বারা স্বাক্ষরিত একটি JWT তৈরি করুন।

HS256 অ্যালগরিদম ব্যবহার করে স্বাক্ষরিত একটি JWT তৈরি করুন।

এই উদাহরণ পলিসিটি একটি নতুন JWT তৈরি করে এবং HS256 অ্যালগরিদম ব্যবহার করে তাতে স্বাক্ষর করে। স্বাক্ষর করা এবং যাচাই করা, উভয় কাজের জন্যই HS256 একটি শেয়ার্ড সিক্রেটের উপর নির্ভর করে।

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

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

<GenerateJWT name="JWT-Generate-HS256">
    <DisplayName>JWT Generate HS256</DisplayName>
    <Algorithm>HS256</Algorithm>
    <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
    <SecretKey>
        <Value ref="private.secretkey"/>
        <Id>1918290</Id>
    </SecretKey>
    <ExpiresIn>1h</ExpiresIn>
    <Subject>monty-pythons-flying-circus</Subject>
    <Issuer>urn://apigee-edge-JWT-policy-test</Issuer>
    <Audience>fans</Audience>
    <Id/>
    <AdditionalClaims>
        <Claim name="show">And now for something completely different.</Claim>
    </AdditionalClaims>
    <OutputVariable>jwt-variable</OutputVariable>
</GenerateJWT>

ফলস্বরূপ JWT-টির এই হেডারটি থাকবে …

{
  "typ" : "JWT", 
  "alg" : "HS256",
  "kid" : "1918290"
}

… এবং এর পেলোডে এইরকম বিষয়বস্তু থাকবে:

{ 
  "sub" : "monty-pythons-flying-circus",
  "iss" : "urn://apigee-edge-JWT-policy-test",
  "aud" : "show",
  "iat" : 1506553019,
  "exp" : 1506556619,
  "jti" : "BD1FF263-3D25-4593-A685-5EC1326E1F37",
  "show": "And now for something completely different."
}

iat , exp , এবং jti দাবিগুলোর মান ভিন্ন ভিন্ন হবে।

RS256 অ্যালগরিদম দ্বারা স্বাক্ষরিত একটি JWT তৈরি করুন।

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

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

<GenerateJWT name="JWT-Generate-RS256">
    <Algorithm>RS256</Algorithm>
    <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
    <PrivateKey>
        <Value ref="private.privatekey"/>
        <Password ref="private.privatekey-password"/>
        <Id ref="private.privatekey-id"/>
    </PrivateKey>
    <Subject>apigee-seattle-hatrack-montage</Subject>
    <Issuer>urn://apigee-edge-JWT-policy-test</Issuer>
    <Audience>urn://c60511c0-12a2-473c-80fd-42528eb65a6a</Audience>
    <ExpiresIn>60m</ExpiresIn>
    <Id/>
    <AdditionalClaims>
        <Claim name="show">And now for something completely different.</Claim>
    </AdditionalClaims>
    <OutputVariable>jwt-variable</OutputVariable>
</GenerateJWT>

মূল উপাদানগুলি নির্ধারণ করা

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

<SecretKey>
  <Value ref="private.secretkey"/>
  <Id>1918290</Id>
</SecretKey>

<PrivateKey>
  <Value ref="private.privatekey"/>
  <Password ref="private.privatekey-password"/>
  <Id ref="private.privatekey-id"/>
</PrivateKey>

JWT তৈরি করার জন্য এলিমেন্ট রেফারেন্স

পলিসি রেফারেন্সে Generate JWT পলিসির উপাদান এবং বৈশিষ্ট্যগুলো বর্ণনা করা হয়েছে।

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

শীর্ষ-স্তরের উপাদানে প্রযোজ্য অ্যাট্রিবিউটসমূহ

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

নিম্নলিখিত বৈশিষ্ট্যগুলি সকল পলিসি প্যারেন্ট এলিমেন্টের জন্য সাধারণ।

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

<DisplayName>Policy Display Name</DisplayName>

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

<অ্যালগরিদম>

<Algorithm>algorithm-here</Algorithm>

টোকেনটি স্বাক্ষর করার জন্য এনক্রিপশন অ্যালগরিদম নির্দিষ্ট করে।

<দর্শক>

<Audience>audience-here</Audience>

or:

<Audience ref='variable_containing_audience'/>

পলিসিটি একটি JWT তৈরি করে, যাতে নির্দিষ্ট মানে সেট করা একটি 'aud' ক্লেইম থাকে। এই ক্লেইমটি সেই প্রাপকদের শনাক্ত করে যাদের জন্য JWT-টি উদ্দিষ্ট। এটি RFC7519- এ উল্লিখিত নিবন্ধিত ক্লেইমগুলোর মধ্যে একটি।

<অতিরিক্ত দাবি/দাবি>

<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-এর পেলোডে অতিরিক্ত ক্লেইম নেম/ভ্যালু পেয়ার নির্দিষ্ট করার সুযোগ দেয়। আপনি ক্লেইমটিকে স্ট্রিং, সংখ্যা, বুলিয়ান, ম্যাপ বা অ্যারে হিসেবে স্পষ্টভাবে উল্লেখ করতে পারেন। ম্যাপ হলো মূলত নেম/ভ্যালু পেয়ারের একটি সেট।

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

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

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

উদাহরণস্বরূপ:

<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 }
  }
}

তৈরি হওয়া JWT-তে JSON অবজেক্টের সমস্ত ক্লেইম অন্তর্ভুক্ত থাকে।

<অতিরিক্ত শিরোনাম/দাবি>

<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-এর হেডারে অতিরিক্ত ক্লেইম নেম/ভ্যালু পেয়ার(গুলি) যুক্ত করে।

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

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

<সমালোচনামূলক শিরোনাম>

<CriticalHeaders>a,b,c</CriticalHeaders>

or:

<CriticalHeaders ref=’variable_containing_headers’/>

JWT হেডারে ক্রিটিক্যাল হেডার, crit , যোগ করে। crit হেডারটি হলো হেডারের নামগুলোর একটি অ্যারে, যা JWT রিসিভারের কাছে পরিচিত এবং স্বীকৃত হতে হবে। উদাহরণস্বরূপ:

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

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

কাস্টম দাবি

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

<মেয়াদ শেষ হবে>

<ExpiresIn>time-value-here</ExpiresIn>

JWT-এর জীবনকাল মিলিসেকেন্ড, সেকেন্ড, মিনিট, ঘন্টা বা দিনে নির্দিষ্ট করে।

<আইডি>

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

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

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

<IgnoreUnresolvedVariables>true|false</IgnoreUnresolvedVariables>

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

<ইস্যুকারী>

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

এই পলিসিটি 'iss' নামের একটি ক্লেইম সম্বলিত একটি JWT তৈরি করে, যার মান নির্দিষ্ট ভ্যালুতে সেট করা থাকে। এই ক্লেইমটি JWT-এর ইস্যুকারীকে শনাক্ত করে। এটি RFC7519- এ উল্লিখিত নিবন্ধিত ক্লেইমগুলোর একটি।

<পূর্বে নয়>

<!-- Specify an absolute time. -->
<NotBefore>2017-08-14T11:00:21-07:00</NotBefore>
 -or-
<!-- Specify a time relative to when the token is generated. -->
<NotBefore>6h</NotBefore>

টোকেনটি কখন থেকে বৈধ হবে তা নির্দিষ্ট করে। নির্দিষ্ট সময় পর্যন্ত টোকেনটি অবৈধ থাকে। আপনি একটি নির্দিষ্ট সময়, অথবা টোকেনটি তৈরি হওয়ার সাপেক্ষে একটি সময় নির্দিষ্ট করতে পারেন।

পরম সময়ের মানের জন্য NotBefore এলিমেন্টের বৈধ সময়ের মান

আপেক্ষিক সময়ের মানের জন্য, একটি পূর্ণসংখ্যা এবং একটি সময়কাল উল্লেখ করুন, উদাহরণস্বরূপ:

• ১০ সেকেন্ড
• ৬০ মিটার
• ১২ ঘন্টা

<আউটপুট ভেরিয়েবল>

<OutputVariable>jwt-variable</OutputVariable>

এই পলিসি দ্বারা তৈরি JWT কোথায় রাখা হবে তা নির্দিষ্ট করে। ডিফল্টরূপে এটি jwt. POLICYNAME .generated_jwt

<প্রাইভেট কী/আইডি>

<PrivateKey>
  <Id ref="flow-variable-name-here"/>
</PrivateKey>

or

<PrivateKey>
  <Id>your-id-value-here</Id>
</PrivateKey>

JWT হেডারে অন্তর্ভুক্ত করার জন্য কী আইডি (kid) নির্দিষ্ট করে। শুধুমাত্র তখনই ব্যবহার করুন যখন অ্যালগরিদমটি RS256/RS384/RS512, PS256/PS384/PS512, অথবা ES256/ES384/ES512-এর মধ্যে একটি হয়।

<প্রাইভেট কী/পাসওয়ার্ড>

<PrivateKey>
  <Password ref="private.privatekey-password"/>
</PrivateKey>

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

<ব্যক্তিগত কী/মান>

<PrivateKey>
  <Value ref="private.variable-name-here"/>
</PrivateKey>

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

<গোপন কী/আইডি>

<SecretKey>
  <Id ref="flow-variable-name-here"/>
</SecretKey>

or

<SecretKey>
  <Id>your-id-value-here</Id>
</SecretKey>

HMAC অ্যালগরিদম দ্বারা স্বাক্ষরিত কোনো JWT-এর হেডারে অন্তর্ভুক্ত করার জন্য কী আইডি (kid) নির্দিষ্ট করে। শুধুমাত্র তখনই ব্যবহার করুন যখন অ্যালগরিদমটি HS256/HS384/HS512-এর মধ্যে একটি হয়।

<গোপন কী/মান>

<SecretKey>
  <Value ref="private.your-variable-name"/>
</SecretKey>

HMAC অ্যালগরিদম ব্যবহার করে টোকেন যাচাই বা স্বাক্ষর করার জন্য ব্যবহৃত গোপন কী প্রদান করে। শুধুমাত্র তখনই ব্যবহার করুন যখন অ্যালগরিদমটি HS256/HS384/HS512-এর মধ্যে একটি হয়। ফ্লো ভেরিয়েবলে কী-টি পাস করার জন্য ref অ্যাট্রিবিউট ব্যবহার করুন।

Edge, HS256/HS384/HS512 অ্যালগরিদমগুলোর জন্য একটি ন্যূনতম কী-স্ট্রেংথ বা কী-শক্তি বাধ্যতামূলক করেছে। HS256-এর জন্য ন্যূনতম কী-লেংথ হলো ৩২ বাইট, HS384-এর জন্য ৪৮ বাইট এবং HS512-এর জন্য ৬৪ বাইট। এর চেয়ে কম শক্তির কী ব্যবহার করলে রানটাইম এরর দেখা দেয়।

বিষয়

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

<Subject ref="flow_variable" />

উদাহরণস্বরূপ:

<Subject ref="apigee.developer.email"/>

পলিসিটি একটি সাব- ক্লেম সম্বলিত একটি JWT তৈরি করে, যা নির্দিষ্ট মানে সেট করা থাকে। এই ক্লেমটি JWT-এর বিষয়বস্তুকে শনাক্ত করে বা সে সম্পর্কে একটি বিবৃতি দেয়। এটি RFC7519- এ উল্লিখিত স্ট্যান্ডার্ড ক্লেমগুলোর একটি।

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

Generate JWT পলিসিটি ফ্লো ভেরিয়েবল সেট করে না।

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

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

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

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

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

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

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

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

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

ত্রুটি পরিচালনার জন্য, সর্বোত্তম অনুশীলন হল ত্রুটি প্রতিক্রিয়ার 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>
    

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

কী

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

ভিডিও

কীভাবে একটি স্বাক্ষরিত JWT তৈরি করতে হয় তা শিখতে একটি সংক্ষিপ্ত ভিডিও দেখুন।

নমুনা

• HS256 অ্যালগরিদম ব্যবহার করে স্বাক্ষরিত একটি JWT তৈরি করুন।
• RS256 অ্যালগরিদম দ্বারা স্বাক্ষরিত একটি JWT তৈরি করুন।

HS256 অ্যালগরিদম ব্যবহার করে স্বাক্ষরিত একটি JWT তৈরি করুন।

এই উদাহরণ পলিসিটি একটি নতুন JWT তৈরি করে এবং HS256 অ্যালগরিদম ব্যবহার করে তাতে স্বাক্ষর করে। স্বাক্ষর করা এবং যাচাই করা, উভয় কাজের জন্যই HS256 একটি শেয়ার্ড সিক্রেটের উপর নির্ভর করে।

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

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

<GenerateJWT name="JWT-Generate-HS256">
    <DisplayName>JWT Generate HS256</DisplayName>
    <Algorithm>HS256</Algorithm>
    <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
    <SecretKey>
        <Value ref="private.secretkey"/>
        <Id>1918290</Id>
    </SecretKey>
    <ExpiresIn>1h</ExpiresIn>
    <Subject>monty-pythons-flying-circus</Subject>
    <Issuer>urn://apigee-edge-JWT-policy-test</Issuer>
    <Audience>fans</Audience>
    <Id/>
    <AdditionalClaims>
        <Claim name="show">And now for something completely different.</Claim>
    </AdditionalClaims>
    <OutputVariable>jwt-variable</OutputVariable>
</GenerateJWT>

ফলস্বরূপ JWT-টির এই হেডারটি থাকবে …

{
  "typ" : "JWT", 
  "alg" : "HS256",
  "kid" : "1918290"
}

… এবং এর পেলোডে এইরকম বিষয়বস্তু থাকবে:

{ 
  "sub" : "monty-pythons-flying-circus",
  "iss" : "urn://apigee-edge-JWT-policy-test",
  "aud" : "show",
  "iat" : 1506553019,
  "exp" : 1506556619,
  "jti" : "BD1FF263-3D25-4593-A685-5EC1326E1F37",
  "show": "And now for something completely different."
}

iat , exp , এবং jti দাবিগুলোর মান ভিন্ন ভিন্ন হবে।

RS256 অ্যালগরিদম দ্বারা স্বাক্ষরিত একটি JWT তৈরি করুন।

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

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

<GenerateJWT name="JWT-Generate-RS256">
    <Algorithm>RS256</Algorithm>
    <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
    <PrivateKey>
        <Value ref="private.privatekey"/>
        <Password ref="private.privatekey-password"/>
        <Id ref="private.privatekey-id"/>
    </PrivateKey>
    <Subject>apigee-seattle-hatrack-montage</Subject>
    <Issuer>urn://apigee-edge-JWT-policy-test</Issuer>
    <Audience>urn://c60511c0-12a2-473c-80fd-42528eb65a6a</Audience>
    <ExpiresIn>60m</ExpiresIn>
    <Id/>
    <AdditionalClaims>
        <Claim name="show">And now for something completely different.</Claim>
    </AdditionalClaims>
    <OutputVariable>jwt-variable</OutputVariable>
</GenerateJWT>

মূল উপাদানগুলি নির্ধারণ করা

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

<SecretKey>
  <Value ref="private.secretkey"/>
  <Id>1918290</Id>
</SecretKey>

<PrivateKey>
  <Value ref="private.privatekey"/>
  <Password ref="private.privatekey-password"/>
  <Id ref="private.privatekey-id"/>
</PrivateKey>

JWT তৈরি করার জন্য এলিমেন্ট রেফারেন্স

পলিসি রেফারেন্সে Generate JWT পলিসির উপাদান এবং বৈশিষ্ট্যগুলো বর্ণনা করা হয়েছে।

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

শীর্ষ-স্তরের উপাদানে প্রযোজ্য অ্যাট্রিবিউটসমূহ

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

নিম্নলিখিত বৈশিষ্ট্যগুলি সকল পলিসি প্যারেন্ট এলিমেন্টের জন্য সাধারণ।

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

<DisplayName>Policy Display Name</DisplayName>

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

<অ্যালগরিদম>

<Algorithm>algorithm-here</Algorithm>

টোকেনটি স্বাক্ষর করার জন্য এনক্রিপশন অ্যালগরিদম নির্দিষ্ট করে।

<দর্শক>

<Audience>audience-here</Audience>

or:

<Audience ref='variable_containing_audience'/>

পলিসিটি একটি JWT তৈরি করে, যাতে নির্দিষ্ট মানে সেট করা একটি 'aud' ক্লেইম থাকে। এই ক্লেইমটি সেই প্রাপকদের শনাক্ত করে যাদের জন্য JWT-টি উদ্দিষ্ট। এটি RFC7519- এ উল্লিখিত নিবন্ধিত ক্লেইমগুলোর মধ্যে একটি।

<অতিরিক্ত দাবি/দাবি>

<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-এর পেলোডে অতিরিক্ত ক্লেইম নেম/ভ্যালু পেয়ার নির্দিষ্ট করার সুযোগ দেয়। আপনি ক্লেইমটিকে স্ট্রিং, সংখ্যা, বুলিয়ান, ম্যাপ বা অ্যারে হিসেবে স্পষ্টভাবে উল্লেখ করতে পারেন। ম্যাপ হলো মূলত নেম/ভ্যালু পেয়ারের একটি সেট।

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

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

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

উদাহরণস্বরূপ:

<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 }
  }
}

তৈরি হওয়া JWT-তে JSON অবজেক্টের সমস্ত ক্লেইম অন্তর্ভুক্ত থাকে।

<অতিরিক্ত শিরোনাম/দাবি>

<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-এর হেডারে অতিরিক্ত ক্লেইম নেম/ভ্যালু পেয়ার(গুলি) যুক্ত করে।

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

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

<সমালোচনামূলক শিরোনাম>

<CriticalHeaders>a,b,c</CriticalHeaders>

or:

<CriticalHeaders ref=’variable_containing_headers’/>

JWT হেডারে ক্রিটিক্যাল হেডার, crit , যোগ করে। crit হেডারটি হলো হেডারের নামগুলোর একটি অ্যারে, যা JWT রিসিভারের কাছে পরিচিত এবং স্বীকৃত হতে হবে। উদাহরণস্বরূপ:

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

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

কাস্টম দাবি

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

<মেয়াদ শেষ হবে>

<ExpiresIn>time-value-here</ExpiresIn>

JWT-এর জীবনকাল মিলিসেকেন্ড, সেকেন্ড, মিনিট, ঘন্টা বা দিনে নির্দিষ্ট করে।

<আইডি>

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

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

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

<IgnoreUnresolvedVariables>true|false</IgnoreUnresolvedVariables>

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

<ইস্যুকারী>

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

এই পলিসিটি 'iss' নামের একটি ক্লেইম সম্বলিত একটি JWT তৈরি করে, যার মান নির্দিষ্ট ভ্যালুতে সেট করা থাকে। এই ক্লেইমটি JWT-এর ইস্যুকারীকে শনাক্ত করে। এটি RFC7519- এ উল্লিখিত নিবন্ধিত ক্লেইমগুলোর একটি।

<পূর্বে নয়>

<!-- Specify an absolute time. -->
<NotBefore>2017-08-14T11:00:21-07:00</NotBefore>
 -or-
<!-- Specify a time relative to when the token is generated. -->
<NotBefore>6h</NotBefore>

টোকেনটি কখন থেকে বৈধ হবে তা নির্দিষ্ট করে। নির্দিষ্ট সময় পর্যন্ত টোকেনটি অবৈধ থাকে। আপনি একটি নির্দিষ্ট সময়, অথবা টোকেনটি তৈরি হওয়ার সাপেক্ষে একটি সময় নির্দিষ্ট করতে পারেন।

পরম সময়ের মানের জন্য NotBefore এলিমেন্টের বৈধ সময়ের মান

আপেক্ষিক সময়ের মানের জন্য, একটি পূর্ণসংখ্যা এবং একটি সময়কাল উল্লেখ করুন, উদাহরণস্বরূপ:

• ১০ সেকেন্ড
• ৬০ মিটার
• ১২ ঘন্টা

<আউটপুট ভেরিয়েবল>

<OutputVariable>jwt-variable</OutputVariable>

এই পলিসি দ্বারা তৈরি JWT কোথায় রাখা হবে তা নির্দিষ্ট করে। ডিফল্টরূপে এটি jwt. POLICYNAME .generated_jwt

<প্রাইভেট কী/আইডি>

<PrivateKey>
  <Id ref="flow-variable-name-here"/>
</PrivateKey>

or

<PrivateKey>
  <Id>your-id-value-here</Id>
</PrivateKey>

JWT হেডারে অন্তর্ভুক্ত করার জন্য কী আইডি (kid) নির্দিষ্ট করে। শুধুমাত্র তখনই ব্যবহার করুন যখন অ্যালগরিদমটি RS256/RS384/RS512, PS256/PS384/PS512, অথবা ES256/ES384/ES512-এর মধ্যে একটি হয়।

<প্রাইভেট কী/পাসওয়ার্ড>

<PrivateKey>
  <Password ref="private.privatekey-password"/>
</PrivateKey>

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

<ব্যক্তিগত কী/মান>

<PrivateKey>
  <Value ref="private.variable-name-here"/>
</PrivateKey>

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

<গোপন কী/আইডি>

<SecretKey>
  <Id ref="flow-variable-name-here"/>
</SecretKey>

or

<SecretKey>
  <Id>your-id-value-here</Id>
</SecretKey>

HMAC অ্যালগরিদম দ্বারা স্বাক্ষরিত কোনো JWT-এর হেডারে অন্তর্ভুক্ত করার জন্য কী আইডি (kid) নির্দিষ্ট করে। শুধুমাত্র তখনই ব্যবহার করুন যখন অ্যালগরিদমটি HS256/HS384/HS512-এর মধ্যে একটি হয়।

<গোপন কী/মান>

<SecretKey>
  <Value ref="private.your-variable-name"/>
</SecretKey>

HMAC অ্যালগরিদম ব্যবহার করে টোকেন যাচাই বা স্বাক্ষর করার জন্য ব্যবহৃত গোপন কী প্রদান করে। শুধুমাত্র তখনই ব্যবহার করুন যখন অ্যালগরিদমটি HS256/HS384/HS512-এর মধ্যে একটি হয়। ফ্লো ভেরিয়েবলে কী-টি পাস করার জন্য ref অ্যাট্রিবিউট ব্যবহার করুন।

Edge, HS256/HS384/HS512 অ্যালগরিদমগুলোর জন্য একটি ন্যূনতম কী-স্ট্রেংথ বা কী-শক্তি বাধ্যতামূলক করেছে। HS256-এর জন্য ন্যূনতম কী-লেংথ হলো ৩২ বাইট, HS384-এর জন্য ৪৮ বাইট এবং HS512-এর জন্য ৬৪ বাইট। এর চেয়ে কম শক্তির কী ব্যবহার করলে রানটাইম এরর দেখা দেয়।

বিষয়

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

<Subject ref="flow_variable" />

উদাহরণস্বরূপ:

<Subject ref="apigee.developer.email"/>

পলিসিটি একটি সাব- ক্লেম সম্বলিত একটি JWT তৈরি করে, যা নির্দিষ্ট মানে সেট করা থাকে। এই ক্লেমটি JWT-এর বিষয়বস্তুকে শনাক্ত করে বা সে সম্পর্কে একটি বিবৃতি দেয়। এটি RFC7519- এ উল্লিখিত স্ট্যান্ডার্ড ক্লেমগুলোর একটি।

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

Generate JWT পলিসিটি ফ্লো ভেরিয়েবল সেট করে না।

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

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

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

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

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

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

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

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

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

ত্রুটি পরিচালনার জন্য, সর্বোত্তম অনুশীলন হল ত্রুটি প্রতিক্রিয়ার 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>