ফ্লোকলআউট নীতি

ভাগ করা প্রবাহে API কী যাচাই করুন

এই উদাহরণে একটি শেয়ার্ড ফ্লো সাধারণ নিরাপত্তা-সম্পর্কিত কাজ সম্পাদন করতে ব্যবহৃত হয়। এখানে ভাগ করা প্রবাহ একটি API কীকে বৈধ করে। API প্রক্সি এবং অন্যান্য শেয়ার্ড ফ্লো এই শেয়ার্ড ফ্লোতে কল করতে FlowCallout নীতি ব্যবহার করতে পারে৷

নিম্নলিখিত শেয়ার্ড ফ্লো সংজ্ঞাতে একটি Verify-API-Key নীতি অন্তর্ভুক্ত রয়েছে যা একটি API প্রক্সিতে একটি ফ্লোকলআউট নীতি থেকে শেয়ার্ড ফ্লো কল করা হলে তা কার্যকর করে৷

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<SharedFlow name="default">
    <Step>
        <Name>Verify-API-Key</Name>
    </Step>
</SharedFlow>

পূর্ববর্তী ভাগ করা প্রবাহের মধ্যে VerifyAPIKey নীতি মূল মান পুনরুদ্ধার করে এবং এটি যাচাই করে।

<VerifyAPIKey async="false" continueOnError="false" enabled="true" name="Verify-API-Key">
    <DisplayName>Verify API Key</DisplayName>
    <APIKey ref="request.queryparam.apikey"/>
</VerifyAPIKey>

নিম্নলিখিত ফ্লোকলআউট নীতি, একটি API প্রক্সিতে ব্যবহৃত, API কী যাচাই করতে পূর্ববর্তী ভাগ করা প্রবাহকে কল করে৷ verify-apikey-shared শেয়ার্ড ফ্লো বান্ডেল (এখানে দেখানো হয়নি) শেয়ার্ড ফ্লো কনফিগার করে যেভাবে একটি APIProxy বান্ডেল একটি প্রক্সি কনফিগার করে।

<FlowCallout async="false" continueOnError="false" enabled="true" name="Auth-Flow-Callout">
    <DisplayName>Auth Flow Callout</DisplayName>
    <SharedFlowBundle>verify-apikey-shared</SharedFlowBundle>
</FlowCallout>

একটি ভাগ করা প্রবাহে প্যারামিটার পাস করুন

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

1. String-Handler ফ্লোকলআউট নীতি শেয়ার্ড ফ্লোকে কল করে, ভাগ করা প্রবাহের আউটপুট সংরক্ষণ করার জন্য ভেরিয়েবল নির্দিষ্ট করে, কী ভাগ করা ফ্লো অপারেশন ব্যবহার করতে হবে এবং কী ইনপুট ব্যবহার করতে হবে (এখানে, একটি স্ট্রিং আক্ষরিক, তবে এটি একটি ফ্লো ভেরিয়েবলও হতে পারে) ) Parameter উপাদান রানটাইম তৈরি করতে ভেরিয়েবলের নাম এবং মান নির্দিষ্ট করে। ভাগ করা প্রবাহ তার নিজস্ব কোডে ব্যবহারের জন্য এই ভেরিয়েবলগুলি পুনরুদ্ধার করতে পারে।

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <FlowCallout async="false" continueOnError="false" enabled="true" name="String-Handler">
     <DisplayName>String Handler</DisplayName>
     <Parameters>
       <Parameter name="input">Gladys Kravitz</Parameter>
       <Parameter name="operations">concatenate tolowercase</Parameter>
       <Parameter name="outputVariable">string.handler.output</Parameter>
     </Parameters>
     <SharedFlowBundle>StringHandler</SharedFlowBundle>
   </FlowCallout>
   

2. নিম্নলিখিত default শেয়ার্ড ফ্লোতে একটি SharedStringFunctions JavaScript নীতি অন্তর্ভুক্ত থাকে যা একটি FlowCallout নীতি থেকে শেয়ার্ড ফ্লো কল করা হলে তা কার্যকর করে৷

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <SharedFlow name="default">
     <Step>
       <Name>SharedStringFunctions</Name>
     </Step>
   </SharedFlow>

3. শেয়ার্ড ফ্লোতে, নিচের SharedStringFunctions JavaScript নীতিটি SharedStringFunctions.js JavaScript ফাইলটিকে এক্সিকিউট করার জন্য কোডের সাথে নির্দিষ্ট করে।

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <Javascript async="false" continueOnError="false" enabled="true" timeLimit="200" name="SharedStringFunctions">
     <DisplayName>SharedStringFunctions</DisplayName> <Properties/>
     <ResourceURL>jsc://SharedStringFunctions.js</ResourceURL>
   </Javascript>

4. নিম্নলিখিত জাভাস্ক্রিপ্ট, SharedStringFunctions.js, SharedStringFunctions JavaScript নীতি থেকে কার্যকর করা হয়। এই স্ক্রিপ্ট FlowCallout নীতি Parameter উপাদান থেকে তৈরি ভেরিয়েবল থেকে মান পুনরুদ্ধার করে।

   // Input value from the calling API proxy.
   var handledString = context.getVariable("input");
   // Variable to use for output from this script.
   var outputVariable = context.getVariable("outputVariable");
   // A space-separated list of things to do to the input string.
   // Convert to lower case to handle unintentional capitals in configuration.
   var operation = context.getVariable("operations").toLowerCase();
   
   // If "lowercase" was given as an operation, convert the input to lowercase.
   if (operation.includes("tolowercase")) {
       handledString = handledString.toLowerCase();
   }
   
   // If "concatenate" was given as an operation, concatenate the input.
   if (operation.includes("concatenate")) {
       handledString = handledString.replace(/\s+/g, '');
   }
   // Assign the resulting string to the output variable specified by
   // the calling API proxy.
   context.setVariable(outputVariable, handledString);

5. এক্সিকিউশন জাভাস্ক্রিপ্ট নীতি থেকে, শেয়ার্ড ফ্লোতে, তারপর আদি API প্রক্সিতে ফ্লোকলআউট নীতিতে প্রবাহিত হয়।

সিনট্যাক্স

আপনি নিম্নলিখিত সিনট্যাক্স ফর্মগুলির যে কোনও একটির সাথে এই উপাদানটি ব্যবহার করতে পারেন। নোট করুন যে আপনি যেখানে একটি আক্ষরিক মান ব্যবহার করেন, আপনি যে মানটি নির্দিষ্ট করেছেন তার বিন্যাসটি যে কোডটি ব্যবহার করে তার উপর নির্ভর করবে।

<!- A literal value in an attribute. --/>
<Parameter name="parameter-name" value='parameter-value' />
<!- A reference to a variable in an attribute. --/>
<Parameter name="parameter-name" ref='source-variable-name' />
<!- A literal value in the element content. --/>
<Parameter name="parameter-name">parameter-value</Parameter>
<!- An reference to an attribute in the element content. --/>
<Parameter name="parameter-name">{source-variable-name}</Parameter>

উদাহরণ

এই String-Handler ফ্লোকলআউট নীতিটি পরামিতি পাস করে যা উল্লেখ করে যে ভাগ করা প্রবাহের আউটপুট কোথায় সঞ্চয় করতে হবে এবং কোন ইনপুট ব্যবহার করতে হবে। Parameter উপাদান রানটাইম তৈরি করতে ভেরিয়েবলের নাম এবং মান নির্দিষ্ট করে। ভাগ করা প্রবাহ তার নিজস্ব কোডে ব্যবহারের জন্য এই ভেরিয়েবলগুলি পুনরুদ্ধার করতে পারে।

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<FlowCallout async="false" continueOnError="false" enabled="true" name="String-Handler">
  <DisplayName>String Handler</DisplayName>
  <Parameters>
    <Parameter name="input">Gladys Kravitz</Parameter>
    <Parameter name="outputVariable">string.handler.output</Parameter>
  </Parameters>
  <SharedFlowBundle>StringHandler</SharedFlowBundle>
</FlowCallout>

সিনট্যাক্স

<Parameters>
  <Parameter name="parameter-name" value='parameter-value' />
</Parameters>