OAuth V2 নীতি প্রত্যাহার করা

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

এক নজরে

ডেভেলপার অ্যাপ আইডি বা অ্যাপ এন্ড-ইউজার আইডি অথবা দু'টির সাথেই যুক্ত OAuth2 অ্যাক্সেস টোকেন বাতিল করে দেয়।

OAuth 2.0 অ্যাক্সেস টোকেন তৈরি করতে OAuthv2 নীতি ব্যবহার করুন। Apigee-এর তৈরি টোকেন নিচের ফর্ম্যাটে থাকে:

{
  "issued_at" : "1421847736581",
  "application_name" : "a68d01f8-b15c-4be3-b800-ceae8c456f5a",
  "scope" : "READ",
  "status" : "approved",
  "api_product_list" : "[PremiumWeatherAPI]",
  "expires_in" : "3599", //--in seconds
  "developer.email" : "tesla@weathersample.com",
  "organization_id" : "0",
  "token_type" : "BearerToken",
  "client_id" : "k3nJyFJIA3p62DWOkLO6OJNi87GYXFmP",
  "access_token" : "7S22UqXGJDTuUADGzJzjXzXSaGJL",
  "organization_name" : "myorg",
  "refresh_token_expires_in" : "0", //--in seconds
  "refresh_count" : "0"
}

application_name এলিমেন্টে টোকেনের সাথে যুক্ত ডেভেলপার অ্যাপ আইডি থাকে।

সাধারণত, Apigee টোকেনে ব্যবহারকারীর আইডি অন্তর্ভুক্ত করে না। আপনি Apigee কনফিগার করে OAuthv2 নীতিতে <AppEndUser> এলিমেন্ট যোগ করে এন্ড-ইউজার আইডি অন্তর্ভুক্ত করতে পারেন:

<OAuthV2 name="GenerateAccessTokenClient">
    <Operation>GenerateAccessTokenV/Operation>
    ...
    <AppEndUser>request.queryparam.app_enduser</AppEndUser>
</OAuthV2>

এই উদাহরণে, app_enduser নামের কোয়েরি প্যারামিটারে OAuthv2 নীতি-তে ব্যবহারকারীর আইডি পাস করুন। তারপরে, app_enduser এলিমেন্টে টোকেনে এন্ড-ইউজার আইডি যোগ করা হয়:

{
 "issued_at" : "1421847736581",
 "application_name" : "a68d01f8-b15c-4be3-b800-ceae8c456f5a",
 "scope" : "READ",
 "app_enduser" : "6ZG094fgnjNf02EK",
 "status" : "approved",
 "api_product_list" : "[PremiumWeatherAPI]",
 "expires_in" : "3599", //--in seconds
 "developer.email" : "tesla@weathersample.com",
 "organization_id" : "0",
 "token_type" : "BearerToken",
 "client_id" : "k3nJyFJIA3p62DWOkLO6OJNi87GYXFmP",
 "access_token" : "7S22UqXGJDTuUADGzJzjXzXSaGJL",
 "organization_name" : "myorg",
 "refresh_token_expires_in" : "0", //--in seconds
 "refresh_count" : "0"
}

ডেভেলপার অ্যাপ আইডি দ্বারা প্রত্যাহার করা

ডেভেলপার অ্যাপ আইডির সাথে যুক্ত OAuth2 অ্যাক্সেস টোকেন প্রত্যাহার করুন। Apigee-এর জেনারেট করা সব OAuth2 অ্যাক্সেস টোকেনে টোকেনের সাথে যুক্ত ডেভেলপার অ্যাপের আইডি থাকে। তারপরে, আপনি সেই অ্যাপ আইডির ভিত্তিতে টোকেন প্রত্যাহার করতে পারবেন।

• নির্দিষ্ট ডেভেলপারদের জন্য অ্যাপ আইডির তালিকা পেতে Developer apps API ব্যবহার করুন।

• এছাড়াও, কোনও অ্যাপ সম্পর্কে বিস্তারিত তথ্য পেতে, আপনি Developer apps API ব্যবহার করতে পারেন।

অ্যাপের এন্ড-ইউজার আইডি দিয়ে প্রত্যাহার করা

কোনও নির্দিষ্ট অ্যাপের এন্ড-ইউজারের আইডির সাথে যুক্ত OAuth2 অ্যাক্সেস টোকেন প্রত্যাহার করুন। এটি হল সেই টোকেন যেটি সেই ব্যবহারকারীর আইডির সাথে যুক্ত যাকে টোকেন ইস্যু করা হয়েছে।

OAuth অ্যাক্সেস টোকেনে ডিফল্ট হিসেবে ব্যবহারকারীর আইডির কোনও ফিল্ড থাকে না। শেষ ব্যবহারকারীর আইডি দিয়ে OAuth 2.0 অ্যাক্সেস টোকেন প্রত্যাহার করার সুবিধা চালু করতে, আপনাকে OAuthv2 নীতি কনফিগার করতে হবে যাতে টোকেনে ব্যবহারকারীর আইডি যোগ করা যায়, যেমন উপরে দেখানো হয়েছে।

অ্যাপের এন্ড-ইউজার আইডি পেতে, Developer apps API ব্যবহার করুন।

নমুনা

OAuth2 অ্যাক্সেস টোকেন তুলে নেওয়ার জন্য নিম্নলিখিত নমুনাগুলি Revoke OAuth V2 নীতি ব্যবহার করে।

<RevokeOAuthV2 continueOnError="false" enabled="true" name="MyRevokeTokenPolicy">
  <DisplayName>Revoke OAuth v2.0-1</DisplayName>
  <AppId ref="request.queryparam.app_id"></AppId>
</RevokeOAuthV2>

<RevokeOAuthV2 continueOnError="false" enabled="true" name="MyRevokeTokenPolicy">
  <DisplayName>Revoke OAuth v2.0-1</DisplayName>
  <AppId ref="request.queryparam.app_id"></AppId>
  <RevokeBeforeTimestamp>1561939200000</RevokeBeforeTimestamp>
</RevokeOAuthV2>

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

এলিমেন্ট রেফারেন্সে RevokeOAuthV2 নীতির এলিমেন্ট ও অ্যাট্রিবিউট বর্ণনা করা হয়।

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<RevokeOAuthV2 continueOnError="false" enabled="true" name="GetOAuthV2Info-1">
  <DisplayName>Get OAuth v2.0 Info 1</DisplayName>
  <AppId ref="variable"></AppId>
  <EndUserId ref="variable"></EndUserId>
  <RevokeBeforeTimestamp ref="variable"></RevokeBeforeTimestamp>
  <Cascade>false</Cascade>
</RevokeOAuthV2>

<RevokeOAuthV2> অ্যাট্রিবিউট

<RevokeOAuthV2 continueOnError="false" enabled="true" name="Revoke-OAuth-v20-1">

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

<DisplayName> এলিমেন্ট

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

<DisplayName>Policy Display Name</DisplayName>

<AppId> এলিমেন্ট

প্রত্যাহার করার জন্য টোকেনের ডেভেলপার অ্যাপ আইডি নির্দিষ্ট করে। অ্যাপ আইডি আছে এমন কোনও ভেরিয়েবল অথবা আক্ষরিক অ্যাপ আইডি পাস করুন।

<AppId>appIdString</AppId>

or:

<AppId ref="request.queryparam.app_id"></AppId>

<Cascade> এলিমেন্ট

true এবং আপনার কাছে যদি ঐতিহ্যবাহী অস্বচ্ছ অ্যাক্সেস টোকেন থাকে, তাহলে <AppId> অথবা <EndUserId> ম্যাচ করলে রিফ্রেশ টোকেন ও অ্যাক্সেস টোকেন, দুটিই বাতিল করা হবে। false হলে, শুধুমাত্র অ্যাক্সেস টোকেন প্রত্যাহার করা হয় এবং রিফ্রেশ টোকেন অপরিবর্তিত থাকে। একই আচরণ শুধুমাত্র অস্বচ্ছ অ্যাক্সেস টোকেনের ক্ষেত্রে প্রযোজ্য।

<Cascade>false<Cascade>

<EndUserId> এলিমেন্ট

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

<EndUserId>userIdString</EndUserId>

or:

<EndUserId ref="request.queryparam.access_token"></EndUserId>

<RevokeBeforeTimestamp> এলিমেন্ট

টাইমস্ট্যাম্পের আগে ইস্যু করা টোকেন তুলে নিন। এই এলিমেন্ট <AppId> ও <EndUserId>-এর সাথে কাজ করে যাতে আপনি নির্দিষ্ট সময়ের আগে টোকেন প্রত্যাহার করতে পারেন। নীতি প্রয়োগ করার সময় হল ডিফল্ট ভ্যালু।

<RevokeBeforeTimestamp>timeStampString</RevokeBeforeTimestamp>

or:

<RevokeBeforeTimestamp ref="request.queryparam.revoke_since_timestamp"></RevokeBeforeTimestamp>

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

RevokeOAuthV2 নীতি ফ্লো ভেরিয়েবল সেট করে না।

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

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

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

নীতি এক্সিকিউট করার সময় এই সমস্যা হতে পারে। নিচে দেখানো সমস্যার নামগুলি হল স্ট্রিং যেগুলি সমস্যা হলে fault.name ভেরিয়েবলে অ্যাসাইন করা হয়। আরও বিবরণের জন্য নিচে Fault ভেরিয়েবল বিভাগ দেখুন।

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

ডেপ্লয়মেন্ট সংক্রান্ত সমস্যার ব্যাপারে তথ্য পেতে UI-তে রিপোর্ট করা মেসেজ দেখুন।

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

এই নীতি রানটাইমে কোনও সমস্যা ট্রিগার করলে, এইসব ভেরিয়েবল সেট করা হয়।

সমস্যার উত্তরের উদাহরণ

{
   "fault":{
      "faultstring":"Timestamp is in the future.",
      "detail":{
         "errorcode":"steps.oauth.v2.InvalidFutureTimestamp"
      }
   }
}

ভুল নিয়মের উদাহরণ

<FaultRule name="RevokeOAuthV2 Faults">
    <Step>
        <Name>AM-InvalidTimestamp</Name>
    </Step>
    <Condition>(fault.name = "InvalidFutureTimestamp")</Condition>
</FaultRule>

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

• OAuthV2 নীতি
• OAuth হোম
• টোকেন কাস্টমাইজ করা এবং অনুমোদন কোড