FlowCallout নীতি

শেয়ার করা ফ্লোতে 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 প্রক্সিতে ব্যবহৃত নিম্নলিখিত FlowCallout নীতি, 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 নীতি, সাধারণ স্ট্রিং ম্যানেজমেন্ট ফাংশন পারফর্ম করার জন্য ডিজাইন করা একটি শেয়ার করা ফ্লোকে কল করে। শেয়ার করা ফ্লোতে JavaScript আছে যা এর ইনপুটকে কনক্যাটেনেট করে, এর ইনপুটকে লোয়ার-কেস করে অথবা দু'টিই করে। FlowCallout নীতিতে এমন প্যারামিটার সংজ্ঞায়িত করা হয় যা স্ট্রিং ইনপুট, আউটপুট এবং ইনপুট নিয়ে কী করতে হবে তা নির্দিষ্ট করে।

1. String-Handler FlowCallout নীতি শেয়ার করা ফ্লোকে কল করে, শেয়ার করা ফ্লোয়ের আউটপুট স্টোর করার জন্য ভেরিয়েবল নির্দিষ্ট করে প্যারামিটার পাস করে, কোন শেয়ার করা ফ্লো অপারেশন ব্যবহার করতে হবে এবং কোন ইনপুট ব্যবহার করতে হবে (এখানে, একটি স্ট্রিং লিটেরাল, তবে এটি একটি ফ্লো ভেরিয়েবলও হতে পারে)। রানটাইম তৈরি করার জন্য 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. নিম্নলিখিত JavaScript, 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. JavaScript নীতি থেকে শেয়ার্ড ফ্লোতে এবং তারপরে অরিজিনেটিং API প্রক্সির FlowCallout নীতিতে এক্সিকিউশন ফ্লো ফিরে আসে।

সিন্ট্যাক্স

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

<!- 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 FlowCallout নীতিতে এমন প্যারামিটার পাস করা হয় যা নির্দিষ্ট করে যে শেয়ার করা ফ্লোয়ের আউটপুট কোথায় স্টোর করতে হবে এবং কোন ইনপুট ব্যবহার করতে হবে। 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>