ফ্লো কনফিগারেশন রেফারেন্স

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

এই বিভাগে আপনার API প্রক্সি ফ্লো নির্ধারণ করার জন্য ব্যবহৃত XML এলিমেন্ট সম্পর্কে রেফারেন্স তথ্য প্রদান করা হয়েছে।

হায়ারার্কি ও সিনট্যাক্স

নিচে দেওয়া উদাহরণে ফ্লো কনফিগারেশন এলিমেন্টের এলিমেন্ট হায়ারার্কি ও সিনট্যাক্স দেখানো হয়েছে:

এলিমেন্ট হায়ারার্কি

নিচের উদাহরণে, <ProxyEndpoint> এবং <TargetEndpoint> এলিমেন্টের মধ্যে ফ্লো কনফিগারেশন এলিমেন্টের হায়ারার্কি দেখানো হয়েছে:

<ProxyEndpoint | TargetEndpoint>
    <PreFlow>
          <Request>
                <Step>
                    <Condition>
                    <Name>
          <Response>
                <Step>
                    <Condition>
                    <Name>
          <Description>
    <Flows>
          <Flow>
                <Description>
                <Condition>
                <Request>
                      <Step>
                          
                <Response>
                      <Step>
                          
          <Description>
    <PostFlow>
          <Request>
                <Step>
                    
          <Response>
                <Step>
                    
          <Description>
    <PostClientFlow> (<ProxyEndpoint> only)
          <Response>
                
          <Description>

      // Additional configuration elements

</ProxyEndpoint | TargetEndpoint>

সিন্ট্যাক্স

ফ্লো কনফিগারেশন এলিমেন্টের সিনট্যাক্স নিচের উদাহরণে দেখানো হয়েছে। এইসব এলিমেন্টের প্রতিটি সম্পর্কে নিম্নলিখিত বিভাগে বিস্তারিতভাবে বর্ণনা করা হয়েছে:

<!-- ProxyEndpoint flow configuration file -->
<ProxyEndpoint ... >
  ...
  <PreFlow name="flow_name">
    <Description>flow_description</Description>
    <Request>
      <Step>
        <Condition>property operator "value"</Condition>
        <Name>policy_name</Name>
      </Step>
      ...
    </Request>
    <Response>
      <Step>
        <Condition>property operator "value"</Condition>
        <Name>policy_name</Name>
      </Step>
      ...
    </Response>
  </PreFlow>
  <Flows name="flow_name">
    <Flow name="conditional_flow_name">
      <Description>flow_description</Description>
      <Condition>property operator "value"</Condition>
      <Request>
        <Step>
          <Condition>property operator "value"</Condition>
          <Name>policy_name</Name>
        </Step>
        ...
      </Request>
      <Response>
        <Step>
          <Condition>property operator "value"</Condition>
          <Name>policy_name</Name>
        </Step>
        ...
      </Response>
    </Flow>
  </Flows>
  <PostFlow name="flow_name">
    <Description>flow_description</Description>
    <Request>
      <Step>
        <Condition>property operator "value"</Condition>
        <Name>policy_name</Name>
      </Step>
      ...
    </Request>
    <Response>
      <Step>
        <Condition>property operator "value"</Condition>
        <Name>policy_name</Name>
      </Step>
      ...
    </Response>
  </PostFlow>
  <PostClientFlow name="flow_name">
    <Description>flow_description</Description>
    <Response>
      <Step>
        <Condition>property operator "value"</Condition>
        <Name>policy_name</Name>
      </Step>
      ...
    </Response>
  </PostClientFlow>
  ...
</ProxyEndpoint>

<!-- TargetEndpoint flow configuration file -->
<TargetEndpoint ... >
  ...
  <PreFlow name="flow_name">
    <Description>flow_description</Description>
    <Request>
      <Step>
        <Condition>property operator "value"</Condition>
        <Name>policy_name</Name>
      </Step>
      ...
    </Request>
    <Response>
      <Step>
        <Condition>property operator "value"</Condition>
        <Name>policy_name</Name>
      </Step>
      ...
    </Response>
  </PreFlow>
  <Flows name="flow_name">
    <Flow name="conditional_flow_name">
      <Description>flow_description</Description>
      <Condition>property operator "value"</Condition>
      <Request>
        <Step>
          <Condition>property operator "value"</Condition>
          <Name>policy_name</Name>
        </Step>
        ...
      </Request>
      <Response>
        <Step>
          <Condition>property operator "value"</Condition>
          <Name>policy_name</Name>
        </Step>
        ...
      </Response>
    </Flow>
    ...
  </Flows>
  <PostFlow name="flow_name">
    <Description>flow_description</Description>
    <Request>
      <Step>
        <Condition>property operator "value"</Condition>
        <Name>policy_name</Name>
      </Step>
      ...
    </Request>
    <Response>
      <Step>
        <Condition>property operator "value"</Condition>
        <Name>policy_name</Name>
      </Step>
      ...
    </Response>
  </PostFlow>
  ...
</TargetEndpoint>

আপনার PreFlow, Conditional Flow, PostFlow এবং PostClientFlow এক্সিকিউশন নির্ধারণ করতে আপনি এইসব এলিমেন্ট ব্যবহার করেন।

<Condition>

রানটাইমে প্রসেস করা হয় এমন একটি স্টেটমেন্টকে সংজ্ঞায়িত করে। স্টেটমেন্টের মূল্যায়ন সত্য হলে, শর্তের সাথে যুক্ত ধাপ বা ফ্লো এক্সিকিউট করা হয়। যদি স্টেটমেন্টের মূল্যায়ন মিথ্যা হয়, তাহলে ধাপ বা ফ্লো উপেক্ষা করা হয়।

টাইপ করুন স্ট্রিং
প্যারেন্ট এলিমেন্ট <Flow>
<Step>
চাইল্ড এলিমেন্ট কোনওটিই নয়

আপনি কোনও নির্দিষ্ট ধাপে বা সম্পূর্ণ ফ্লোতে শর্ত প্রয়োগ করতে পারবেন। এটি নির্ভর করে আপনি এলিমেন্টটি <Flow> বা <Step> এলিমেন্টে রেখেছেন কিনা তার উপর:

// Condition can apply to just one step:        // Or to the flow:
<Flows>                                         <Flows>
  <Flow>                                          <Flow>
    <Step>                                          <Condition>
      <Condition>                                   <Step>
      <Name>                                          <Name>
      ...                                             ...
    ...                                             ...
  ...                                             ...
</Flows>                                        </Flows>

<Step>-এর মধ্যে থাকা কোনও কন্ডিশন মূল্যায়ন করে True হিসেবে দেখালে, Edge সেই ধাপটি এক্সিকিউট করে। কন্ডিশনটি মিথ্যা হলে, Edge এই ধাপটি এড়িয়ে যায়।

<Flow>-এর মধ্যে থাকা কোনও কন্ডিশন মূল্যায়ন করে যদি দেখা যায় যে সেটি সঠিক, তাহলে Edge ফ্লোয়ের সব ধাপ প্রসেস করে। কন্ডিশনটি মিথ্যা হলে, Edge সম্পূর্ণ ফ্লোটি এড়িয়ে যায়।

সিন্ট্যাক্স

<Condition> এলিমেন্ট নিম্নলিখিত সিনট্যাক্স ব্যবহার করে:

<Condition>property operator "value"</Condition>

যেখানে:

property
আপনার কন্ডিশনে ব্যবহার করতে চাওয়া ফ্লো ভেরিয়েবল প্রপার্টি। যেমন, request ফ্লো ভেরিয়েবলের প্রপার্টিগুলি হল path ও content। কোনও কন্ডিশনে সেগুলি ব্যবহার করতে, আপনাকে flow_variable[dot]property_name নির্দিষ্ট করতে হবে:
request.path
request.content

ফ্লো ভেরিয়েবল ও সেগুলির প্রপার্টির সম্পূর্ণ তালিকা দেখতে, ফ্লো ভেরিয়েবল রেফারেন্স দেখুন।

operator
আপনার কন্ডিশন কীভাবে মূল্যায়ন করা হবে তা নির্ধারণ করে এমন একটি কনস্ট্রাক্ট। সাধারণ অপারেটরদের মধ্যে এগুলি রয়েছে:
>     greater than           <=    less than or equal to
<     less than              >=    greater than or equal to
=     equals                 &&    and
!=    not equals             ||    or

~~    JavaRegex
~     Matches
/~    MatchesPath

সম্পূর্ণ তালিকার জন্য, কন্ডিশন রেফারেন্সে অপারেটর দেখুন।

"value"
ফ্লো ভেরিয়েবল প্রপার্টি যে ভ্যালুর সাথে মূল্যায়ন করা হয়। এটি সাধারণত পূর্ণসংখ্যা বা স্ট্রিংয়ের মতো প্রাথমিক ধরনের হয়। যেমন, ২০০ বা "/cat"। ভ্যালুতে ওয়াইল্ডকার্ড থাকতে পারে, যেমন, প্যাটার্ন ম্যাচিংয়ের জন্য অ্যাস্টেরিক্স ও অন্যান্য অক্ষর, যা কন্ডিশনাল সহ প্যাটার্ন ম্যাচিং লিঙ্কে বর্ণনা করা হয়েছে।

নমুনা ১

নিচের উদাহরণে request ফ্লো ভেরিয়েবলের verb প্রপার্টি "GET" কিনা তা চেক করা হয়েছে:

<!-- api-platform/reference/examples/flow-segments/condition-1.xml -->
<ProxyEndpoint name="default">
  <PreFlow name="my-preFlows">
    <Description>My first PreFlow</Description>
    <Request>
      <Step>
        <Condition>request.verb = "GET"</Condition>
        <Name>Log-Request-OK</Name>
      </Step>
    </Request>
  </PreFlow>
  ...
</ProxyEndpoint>

অনুরোধটি "GET" হলে, এই উদাহরণ "Log-Request-OK" নীতি প্রয়োগ করে।

নমুনা ২

নিম্নলিখিত উদাহরণটি রেসপন্স কোড চেক করে:

<!-- api-platform/reference/examples/flow-segments/condition-2.xml -->
<ProxyEndpoint name="default">
  <PreFlow name="my-preFlows">
    <Description>My first PreFlow</Description>
    <Response>
      <Step>
        <Condition>response.status.code LesserThanOrEquals 300</Condition>
        <Name>Log-Response-OK</Name>
      </Step>
      <Step>
        <Condition>response.status.code GreaterThan 300</Condition>
        <Name>Log-Response-NOT-OK</Name>
      </Step>
    </Response>
  </PreFlow>
  ...
</ProxyEndpoint>

কোডের মানের উপর নির্ভর করে, একটি আলাদা নীতি প্রয়োগ করা হয়।

অ্যাট্রিবিউট

<Condition> এলিমেন্টে কোনও অ্যাট্রিবিউট নেই।

চাইল্ড এলিমেন্ট

<Condition> এলিমেন্টের কোনও চাইল্ড এলিমেন্ট নেই।

<Description>

মানুষের-পঠনযোগ্য শব্দে ফ্লো বর্ণনা করে। ফ্লো সম্পর্কে নিজেকে বা অন্যান্য ডেভেলপারদের তথ্য দিতে এই এলিমেন্ট ব্যবহার করুন। বিবরণটি এক্সটার্নালি দেখা যায় না।

টাইপ করুন স্ট্রিং
প্যারেন্ট এলিমেন্ট <Flow>
<PreFlow>
<PostFlow>
চাইল্ড এলিমেন্ট কোনওটিই নয়

সিন্ট্যাক্স

<Description> এলিমেন্ট নিম্নলিখিত সিনট্যাক্স ব্যবহার করে:

<Description>flow_description</Description>

উদাহরণ

নিচের উদাহরণে <Description> এলিমেন্ট দেখানো হয়েছে যা ফ্লোয়ের উদ্দেশ্য নির্দিষ্ট করে:

<!-- api-platform/reference/examples/flow-segments/description-1.xml -->
<ProxyEndpoint name="default">
  <Flows name="my-conditional-flows">
    <Flow name="reports">
      <Request>
        <Description>Based on the path suffix, determine which flow to use</Description>
        <Step>
          <Condition>proxy.pathsuffix MatchesPath "/reports"</Condition>
          <Name>XML-to-JSON-1</Name>
        </Step>
        <Step>
          <Condition>proxy.pathsuffix MatchesPath "/forecasts"</Condition>
          <Name>XML-to-JSON-1</Name>
        </Step>
      </Request>
    </Flow>
  </Flows>
  ...
</ProxyEndpoint>

অ্যাট্রিবিউট

<Description> এলিমেন্টে কোনও অ্যাট্রিবিউট নেই।

চাইল্ড এলিমেন্ট

<Description> এলিমেন্টের কোনও চাইল্ড এলিমেন্ট নেই।

<Flow>

Edge-এর এক্সিকিউট করা ধাপের কাস্টম সেটকে সংজ্ঞায়িত করে।

টাইপ করুন জটিল অবজেক্ট
প্যারেন্ট এলিমেন্ট <Flows>
চাইল্ড এলিমেন্ট <Condition>
<Description>
<Request>
<Response>

আপনি ঐচ্ছিকভাবে <Flow>-এ <Condition> নির্দিষ্ট করতে পারেন। সেই ক্ষেত্রে, Edge শুধুমাত্র ফ্লোয়ের সেইসব ধাপ এক্সিকিউট করে যেগুলির কন্ডিশন সত্য হয়। অন্যথায়, Edge সম্পূর্ণ ফ্লো এড়িয়ে যায়।

<Flows> এলিমেন্টে একাধিক <Flow> এলিমেন্ট থাকতে পারে, প্রত্যেকটির নিজস্ব কন্ডিশন ও ধাপ থাকে। একাধিক <Flow> এলিমেন্ট থাকলে, Edge শুধুমাত্র প্রথমটি এক্সিকিউট করে, যেখানে কোনও কন্ডিশন নেই বা কন্ডিশনটি সত্য হিসেবে মূল্যায়ন করা হয়।

আপনি একটি ডিফল্ট ফ্লো নির্ধারণ করতে পারেন যা সবসময় এক্সিকিউট হয় (অন্য কোনও কন্ডিশনাল ফ্লো এক্সিকিউট না হলে)। আপনার API প্রক্সি কীভাবে কনফিগার করা হয়েছে তার উপর নির্ভর করে, এটি ক্ষতিকর আক্রমণ থেকে রক্ষা করার ক্ষেত্রে একটি উপযোগী টুল হতে পারে।

সিন্ট্যাক্স

<Flow> এলিমেন্ট নিম্নলিখিত সিনট্যাক্স ব্যবহার করে:

<Flow name="conditional_flow_name">
  <Description>flow_description</Description>
  <Condition>property operator "value"</Condition>
  <Request>
    <Step>
      <Condition>property operator "value"</Condition>
      <Name>policy_name</Name>
    </Step>
    ...
  </Request>
  <Response>
    <Step>
      <Condition>property operator "value"</Condition>
      <Name>policy_name</Name>
    </Step>
    ...
  </Response>
</Flow>

<Flow>-এর সব চাইল্ড এলিমেন্ট ঐচ্ছিক।

নমুনা ১

নিচে দেওয়া উদাহরণে একটি সাধারণ <Flow> দেখানো হয়েছে যা সবসময় "Log-Message-OK" নীতি প্রয়োগ করে:

<!-- api-platform/reference/examples/flow-segments/flow-1.xml -->
<ProxyEndpoint name="default">
  <Flows name="my-flow">
    <Flow>
      <Request>
        <Step>
          <Name>Log-Message-OK</Name>
        </Step>
      </Request>
    </Flow>
  </Flows>
  ...
</ProxyEndpoint>

নমুনা ২

নিচের উদাহরণে একাধিক ধাপ সহ একটি <Flow> দেখানো হয়েছে, প্রতিটি ধাপের নিজস্ব কন্ডিশন আছে:

<!-- api-platform/reference/examples/flow-segments/flow-2.xml -->
<ProxyEndpoint name="default">
  <Flows name="my-conditional-flows">
    <Flow name="reports">
      <Request>
        <Description>Based on the path suffix, determine which flow to use</Description>
        <Step>
          <Condition>proxy.pathsuffix MatchesPath "/reports"</Condition>
          <Name>XML-to-JSON-1</Name>
        </Step>
        <Step>
          <Condition>proxy.pathsuffix MatchesPath "/forecasts"</Condition>
          <Name>Verify-Auth-1</Name>
        </Step>
      </Request>
    </Flow>
  </Flows>
  ...
</ProxyEndpoint>

উদাহরণ ৩

নিচের উদাহরণে শর্তসাপেক্ষ ফ্লোতে একাধিক ফ্লো দেখানো হয়েছে:

<!-- api-platform/reference/examples/flow-segments/flows-2.xml -->
<ProxyEndpoint name="default">
  <Flows>
    <Flow name="my-flow-1">
      <Response>
        <Step>
          <Condition>response.status.code = 200</Condition>
          <Name>Assign-Message-1</Name>
        </Step>
      </Response>
    </Flow>
    <Flow name="my-flow-2">
      <Response>
        <Step>
          <Condition>response.status.code >= 400</Condition>
          <Name>Assign-Message-2</Name>
        </Step>
      </Response>
    </Flow>
    <Flow name="my-flow-3">
      <Response>
        <Step>
          <Condition>response.status.code >= 300</Condition>
          <Name>Assign-Message-3</Name>
        </Step>
      </Response>
    </Flow>
  </Flows>
  ...
</ProxyEndpoint>

Edge কোনও সেগমেন্টে শুধুমাত্র একটি ফ্লো এক্সিকিউট করে; এটি প্রথম ফ্লো এক্সিকিউট করে যাতে কোনও কন্ডিশন নেই অথবা যার কন্ডিশন সত্য হিসেবে সমাধান করা হয়।

অ্যাট্রিবিউট

নিচের সারণীতে <Flow> এলিমেন্টের অ্যাট্রিবিউট সম্পর্কে বর্ণনা করা হয়েছে:

অ্যাট্রিবিউট ধরন বিবরণ
name স্ট্রিং (প্রয়োজনীয়) ফ্লোয়ের জন্য অনন্য আইডি। যেমন, "My-Conditional-Flow-1"। নামে স্পেস বা অন্য বিশেষ অক্ষর থাকলে চলবে না।

চাইল্ড এলিমেন্ট

নিচের সারণীতে <Flow>-এর চাইল্ড এলিমেন্ট সম্পর্কে বর্ণনা করা হয়েছে:

চাইল্ড এলিমেন্ট ধরন বিবরণ
<Condition> স্ট্রিং রানটাইমে প্রসেস করা হয় এমন শর্তসাপেক্ষ বিবৃতিকে সংজ্ঞায়িত করে। স্টেটমেন্টের মূল্যায়ন সত্য হলে, ফ্লো (এবং এর সব ধাপ) এক্সিকিউট করা হয়। স্টেটমেন্টের মূল্যায়ন মিথ্যা হলে, ফ্লো (এবং এর সব ধাপ) এড়িয়ে যাওয়া হয়।
<Description> স্ট্রিং ফ্লোয়ের সংক্ষিপ্ত বিবরণ দেয়। এই বিবরণ এক্সটার্নালি দেখা যায় না।
<Request> জটিল অবজেক্ট অনুরোধ করা সেগমেন্টের জন্য ধাপ ও শর্তাবলী নির্দিষ্ট করে।
<Response> জটিল অবজেক্ট উত্তর অংশের ধাপ ও শর্তাবলী নির্দিষ্ট করে।

<Flows>

এতে শূন্য বা তার বেশি <Flow> এলিমেন্ট আছে।

টাইপ করুন জটিল অবজেক্ট
প্যারেন্ট এলিমেন্ট <ProxyEndpoint>
<TargetEndpoint>
চাইল্ড এলিমেন্ট <Flow>

<Flows>-এর মধ্যে একাধিক <Flow> এলিমেন্ট থাকলে, শুধুমাত্র একটি <Flow> এলিমেন্ট এক্সিকিউট হবে। এটি প্রথম ফ্লো হবে যাতে <Condition> নেই অথবা যার কন্ডিশন সত্য হিসেবে সমাধান হয়।

আপনি একটি ডিফল্ট ফ্লো নির্ধারণ করতে পারেন যা সবসময় এক্সিকিউট হয় (যদি অন্য কোনও ফ্লো না হয়)। আপনার API প্রক্সি কীভাবে কনফিগার করা হয়েছে তার উপর নির্ভর করে, এটি ক্ষতিকর আক্রমণ থেকে রক্ষা করার ক্ষেত্রে একটি উপযোগী টুল হতে পারে।

সিন্ট্যাক্স

<Flows> এলিমেন্ট নিম্নলিখিত সিনট্যাক্স ব্যবহার করে:

<Flows name="flow_name">
  <Flow name="conditional_flow_name">
    <Description>flow_description</Description>
    <Condition>property operator "value"</Condition>
    <Request>
      <Step>
        <Condition>property operator "value"</Condition>
        <Name>policy_name</Name>
      </Step>
      ...
    </Request>
    <Response>
      <Step>
        <Condition>property operator "value"</Condition>
        <Name>policy_name</Name>
      </Step>
      ...
    </Response>
  </Flow>
</Flows>

<Flows>-এর সব চাইল্ড এলিমেন্ট ঐচ্ছিক।

নমুনা ১

নিচের উদাহরণে একটি <Flow> সহ একটি সাধারণ <Flows> এলিমেন্ট দেখানো হয়েছে:

<!-- api-platform/reference/examples/flow-segments/flows-1.xml -->
<ProxyEndpoint name="default">
  <Flows name="my-conditional-flows">
    <Flow name="reports">
      <Request>
        <Description>Based on the path suffix, determine which flow to use</Description>
        <Step>
          <Condition>proxy.pathsuffix MatchesPath "/reports"</Condition>
          <Name>XML-to-JSON-1</Name>
        </Step>
        <Step>
          <Condition>proxy.pathsuffix MatchesPath "/forecasts"</Condition>
          <Name>Verify-Auth-1</Name>
        </Step>
      </Request>
    </Flow>
  </Flows>
  ...
</ProxyEndpoint>

Edge, proxy ফ্লো ভেরিয়েবল থেকে পাওয়া পাথ সাফিক্সের উপর ভিত্তি করে এইসব নীতির মধ্যে একটি প্রয়োগ করে। পাথ সাফিক্স যদি কোনও শর্তের সাথে না মেলে, তাহলে Edge এই ফ্লো এক্সিকিউট করে না।

নমুনা ২

নিচের উদাহরণে <Flows>-এর মধ্যে একাধিক <Flow> এলিমেন্ট দেখানো হয়েছে, প্রত্যেকটির নিজস্ব <Condition> রয়েছে:

<!-- api-platform/reference/examples/flow-segments/flows-2.xml -->
<ProxyEndpoint name="default">
  <Flows>
    <Flow name="my-flow-1">
      <Response>
        <Step>
          <Condition>response.status.code = 200</Condition>
          <Name>Assign-Message-1</Name>
        </Step>
      </Response>
    </Flow>
    <Flow name="my-flow-2">
      <Response>
        <Step>
          <Condition>response.status.code >= 400</Condition>
          <Name>Assign-Message-2</Name>
        </Step>
      </Response>
    </Flow>
    <Flow name="my-flow-3">
      <Response>
        <Step>
          <Condition>response.status.code >= 300</Condition>
          <Name>Assign-Message-3</Name>
        </Step>
      </Response>
    </Flow>
  </Flows>
  ...
</ProxyEndpoint>

Edge কোনও সেগমেন্টের শুধুমাত্র প্রথম ফ্লোটি এক্সিকিউট করে, যেটির কন্ডিশন 'সত্য' হিসেবে মূল্যায়ন করা হয়। এর পরে, Edge সেগমেন্টের বাকি ফ্লো এড়িয়ে যায়।

উদাহরণ ৩

নিচে দেওয়া উদাহরণে একটি "ডিফল্ট" <Flow> দেখানো হয়েছে:

<!-- api-platform/reference/examples/flow-segments/flows-3.xml -->
<ProxyEndpoint name="default">
  <Flows>
    <Flow name="my-conditional-flow-1">
      <Response>
        <Step>
          <Condition>response.status.code = 200</Condition>
          <Name>Assign-Message-1</Name>
        </Step>
      </Response>
    </Flow>
    <Flow name="my-conditional-flow-2">
      <Response>
        <Step>
          <Condition>response.header.someheader = "42"</Condition>
          <Name>Assign-Message-2</Name>
        </Step>
      </Response>
    </Flow>
    <Flow name="my-default-flow">
      <Response>
        <Step>
          <Name>Assign-Message-3</Name>
        </Step>
      </Response>
    </Flow>
  </Flows>
  ...
</ProxyEndpoint>

Edge কোনও সেগমেন্টের শুধুমাত্র প্রথম ফ্লোটি এক্সিকিউট করে, যেটির কন্ডিশন 'সত্য' হিসেবে মূল্যায়ন করা হয়। কোনও কন্ডিশনাল ফ্লো এক্সিকিউট না হলে, এই উদাহরণের থার্ড ফ্লো (কোনও কন্ডিশন না থাকা) এক্সিকিউট হয়।

ডিফল্ট ফ্লো হল ক্ষতিকারক অ্যাটাক থেকে সুরক্ষিত থাকার একটি কার্যকর টুল।

অ্যাট্রিবিউট

<Flows> এলিমেন্টে কোনও অ্যাট্রিবিউট নেই।

চাইল্ড এলিমেন্ট

<Flows> এলিমেন্টের নিম্নলিখিত চাইল্ড এলিমেন্ট আছে:

চাইল্ড এলিমেন্ট ধরন বিবরণ
<Flow> জটিল অবজেক্ট কন্ডিশনাল ফ্লোয়ের মধ্যে সম্ভাব্য ধাপের একটি সেটকে যে ফ্লো ডিফাইন করে।

<Name>

<Flow>-এর মধ্যে প্রয়োগ করার জন্য নীতির আইডি নির্দিষ্ট করে।

টাইপ করুন স্ট্রিং
প্যারেন্ট এলিমেন্ট <Step>
চাইল্ড এলিমেন্ট কোনওটিই নয়

সিন্ট্যাক্স

<Name> এলিমেন্ট নিম্নলিখিত সিনট্যাক্স ব্যবহার করে:

<Name>policy_name</Name>

উদাহরণ

নিচের উদাহরণে দুটি নীতি দেখানো হয়েছে যেগুলি ফ্লোতে তাদের নাম দিয়ে যোগ করা হয়েছে:

<!-- api-platform/reference/examples/flow-segments/name-1.xml -->
<ProxyEndpoint name="default">
  <Flows name="my-conditional-flows">
    <Flow name="reports">
      <Request>
        <Description>Based on the path suffix, determine which flow to use</Description>
        <Step>
          <Condition>proxy.pathsuffix MatchesPath "/reports"</Condition>
          <Name>XML-to-JSON-1</Name>
        </Step>
        <Step>
          <Condition>proxy.pathsuffix MatchesPath "/forecasts"</Condition>
          <Name>Verify-Auth-1</Name>
        </Step>
      </Request>
    </Flow>
  </Flows>
  ...
</ProxyEndpoint>

অ্যাট্রিবিউট

<Name> এলিমেন্টে কোনও অ্যাট্রিবিউট নেই।

চাইল্ড এলিমেন্ট

<Name> এলিমেন্টের কোনও চাইল্ড এলিমেন্ট নেই।

<PostFlow>

অনুরোধ ও উত্তরের PostFlow-তে কী কী ধাপ নিতে হবে তা নির্ধারণ করে।

টাইপ করুন জটিল অবজেক্ট
প্যারেন্ট এলিমেন্ট <ProxyEndpoint>
<TargetEndpoint>
চাইল্ড এলিমেন্ট <Description>
<Request>
<Response>

<PostFlow> এলিমেন্ট নিম্নলিখিত সিনট্যাক্স ব্যবহার করে:

সিন্ট্যাক্স

<PostFlow name="flow_name">
  <Description>flow_description</Description>
  <Request>
    <Step>
      <Condition>property operator "value"</Condition>
      <Name>policy_name</Name>
    </Step>
    ...
  </Request>
  <Response>
    <Step>
      <Condition>property operator "value"</Condition>
      <Name>policy_name</Name>
    </Step>
    ...
  </Response>
</PostFlow>

উদাহরণ

নিচের উদাহরণে অনুরোধ ও উত্তর দু'টির জন্য ধাপ সহ PostFlow দেখানো হয়েছে:

<!-- api-platform/reference/examples/flow-segments/postflow-1.xml -->
<ProxyEndpoint name="default">
  <PostFlow name="my-postflows">
    <Description>My first PostFlow</Description>
    <Request>
      <Step>
        <Condition>request.verb = "GET"</Condition>
        <Name>Log-Request-OK</Name>
      </Step>
    </Request>
    <Response>
      <Step>
        <Name>Set-Response-Headers</Name>
      </Step>
    </Response>
  </PostFlow>
  ...
</ProxyEndpoint>

অ্যাট্রিবিউট

নিচের সারণীতে <PostFlow> এলিমেন্টের অ্যাট্রিবিউট বর্ণনা করা হয়েছে:

অ্যাট্রিবিউট ধরন বিবরণ
name স্ট্রিং ফ্লোয়ের অনন্য আইডি (এন্ডপয়েন্টের মধ্যে অনন্য)। যেমন, "My-PostFlow-1"। ভ্যালুতে স্পেস বা অন্যান্য বিশেষ অক্ষর থাকলে চলবে না।

চাইল্ড এলিমেন্ট

নিচের সারণীতে <PostFlow>-এর চাইল্ড এলিমেন্ট সম্পর্কে বর্ণনা করা হয়েছে:

চাইল্ড এলিমেন্ট ধরন বিবরণ
<Description> স্ট্রিং ফ্লোয়ের সংক্ষিপ্ত বিবরণ দেয়।
<Request> জটিল অবজেক্ট অনুরোধের PostFlow চলাকালীন কার্যকর করার জন্য নীতি নির্ধারণ করে।
<Response> জটিল অবজেক্ট উত্তরের PostFlow চলাকালীন প্রয়োগ করার জন্য নীতি নির্ধারণ করে।

<PostClientFlow>

ProxyEndpoint-এ এমন নীতি নির্ধারণ করে যা ক্লায়েন্টকে উত্তর ফেরত দেওয়ার পরেই এক্সিকিউট হয়। এইসব নীতি সাধারণত উত্তরের সাথে সম্পর্কিত মেসেজ লগ করে।

টাইপ করুন জটিল অবজেক্ট
প্যারেন্ট এলিমেন্ট <ProxyEndpoint>
চাইল্ড এলিমেন্ট <Description>
<Response>

সিন্ট্যাক্স

<PostClientFlow> এলিমেন্ট নিম্নলিখিত সিনট্যাক্স ব্যবহার করে:

<PostClientFlow name="flow_name">
  <Description>flow_description</Description>
  <Response>
    <Step>
      <Condition>property operator "value"</Condition>
      <Name>policy_name</Name>
    </Step>
    ...
  </Response>
</PostClientFlow>

<PostClientFlow>-এর সব চাইল্ড এলিমেন্ট ঐচ্ছিক।

উদাহরণ

নিচে একটি সাধারণ PostClientFlow-এর উদাহরণ দেওয়া হল যা একটি নীতি প্রয়োগ করে:

<!-- api-platform/reference/examples/flow-segments/postclientflow-1.xml -->
<ProxyEndpoint name="default">
  <PostClientFlow name="my-postclientflows">
    <Description>My first PostClientFlow. Processed after the response is sent back to the client.</Description>
    <Response>
      <Step>
        <Name>Message-Logging-OK</Name>
      </Step>
    </Response>
  </PostClientFlow>
  ...
</ProxyEndpoint>

অ্যাট্রিবিউট

নিচের সারণীতে <PostClientFlow> এলিমেন্টের অ্যাট্রিবিউট বর্ণনা করা হয়েছে:

অ্যাট্রিবিউট ধরন বিবরণ
name স্ট্রিং ফ্লোয়ের অনন্য আইডি। নামে স্পেস বা অন্যান্য বিশেষ অক্ষর থাকলে চলবে না। যেমন, "My-PostClientFlow-1"।

চাইল্ড এলিমেন্ট

নিচের সারণীতে <PostClientFlow>-এর চাইল্ড এলিমেন্ট সম্পর্কে বর্ণনা করা হয়েছে:

চাইল্ড এলিমেন্ট ধরন বিবরণ
<Description> স্ট্রিং ফ্লোয়ের সংক্ষিপ্ত বিবরণ দেয়।
<Response> জটিল অবজেক্ট উত্তরের PostFlow চলাকালীন প্রয়োগ করার জন্য নীতি নির্ধারণ করে।

<PreFlow>

অনুরোধ ও উত্তরের প্রিফ্লোতে প্রয়োগ করার জন্য নীতি নির্ধারণ করে।

টাইপ করুন জটিল অবজেক্ট
প্যারেন্ট এলিমেন্ট <ProxyEndpoint>
<TargetEndpoint>
চাইল্ড এলিমেন্ট <Description>
<Request>
<Response>

সিন্ট্যাক্স

<PreFlow> এলিমেন্ট নিম্নলিখিত সিনট্যাক্স ব্যবহার করে:

<PreFlow name="flow_name">
  <Description>flow_description</Description>
  <Request>
    <Step>
      <Condition>property operator "value"</Condition>
      <Name>policy_name</Name>
    </Step>
    ...
  </Request>
  <Response>
    <Step>
      <Condition>property operator "value"</Condition>
      <Name>policy_name</Name>
    </Step>
    ...
  </Response>
</PreFlow>

<PreFlow>-এর সব চাইল্ড এলিমেন্ট ঐচ্ছিক।

উদাহরণ

নিচের উদাহরণে একটি অনুরোধ ও উত্তর ফ্লো সহ একটি PreFlow দেখানো হয়েছে:

<!-- api-platform/reference/examples/flow-segments/preflow-1.xml -->
<ProxyEndpoint name="default">
  <PreFlow name="my-preFlows">
    <Description>My first PreFlow</Description>
    <Request>
      <Step>
        <Condition>request.verb = "GET"</Condition>
        <Name>Log-Request-OK</Name>
      </Step>
    </Request>
    <Response>
      <Step>
        <Condition>response.status.code LesserThanOrEquals 300</Condition>
        <Name>Log-Response-OK</Name>
      </Step>
      <Step>
        <Condition>response.status.code GreaterThan 300</Condition>
        <Name>Log-Response-NOT-OK</Name>
      </Step>
    </Response>
  </PreFlow>
  ...
</ProxyEndpoint>

অ্যাট্রিবিউট

নিচের সারণীতে <PreFlow> এলিমেন্টের অ্যাট্রিবিউট বর্ণনা করা হয়েছে:

অ্যাট্রিবিউট ধরন বিবরণ
name স্ট্রিং ফ্লোয়ের অনন্য আইডি। নামে স্পেস বা অন্যান্য বিশেষ অক্ষর থাকলে চলবে না। যেমন, "My-PreFlow-1"।

চাইল্ড এলিমেন্ট

নিচের সারণীতে <PreFlow>-এর চাইল্ড এলিমেন্ট সম্পর্কে বর্ণনা করা হয়েছে:

চাইল্ড এলিমেন্ট ধরন বিবরণ
<Description> স্ট্রিং ফ্লোয়ের সংক্ষিপ্ত বিবরণ দেয়।
<Request> জটিল অবজেক্ট অনুরোধের প্রিফ্লো চলাকালীন প্রয়োগ করার জন্য নীতি নির্ধারণ করে।
<Response> জটিল অবজেক্ট উত্তরের PreFlow চলাকালীন প্রয়োগ করার জন্য নীতি নির্ধারণ করে।

<Request>

ফ্লোয়ের অনুরোধ সেগমেন্ট চলাকালীন প্রয়োগ করার জন্য নীতি নির্ধারণ করে।

টাইপ করুন জটিল অবজেক্ট
প্যারেন্ট এলিমেন্ট <Flow>
<PreFlow>
<PostFlow>
চাইল্ড এলিমেন্ট <Condition>
<Step>

সিন্ট্যাক্স

<Request> এলিমেন্ট নিম্নলিখিত সিনট্যাক্স ব্যবহার করে:

<Request>
  <Step>
    <Condition>property operator "value"</Condition>
    <Name>policy_name</Name>
  </Step>
  ...
</Request>

<Request>-এর সব চাইল্ড এলিমেন্ট ঐচ্ছিক।

উদাহরণ

নিচের উদাহরণে PreFlow ও PostFlow, দু'টিতেই অনুরোধের জন্য নির্ধারিত ফ্লো দেখানো হয়েছে:

<!-- api-platform/reference/examples/flow-segments/request-1.xml -->
<ProxyEndpoint name="default">
  <PreFlow name="my-preFlows">
    <Description>My first PreFlow</Description>
    <Request>
      <Step>
        <Condition>request.verb = "GET"</Condition>
        <Name>Log-Request-OK</Name>
      </Step>
    </Request>
  </PreFlow>
  <PostFlow name="my-postflows">
    <Description>My first PostFlow</Description>
    <Request>
      <Step>
        <Condition>request.verb = "GET"</Condition>
        <Name>Log-Request-OK</Name>
      </Step>
    </Request>
  </PostFlow>
  ...
</ProxyEndpoint>

অ্যাট্রিবিউট

<Request> এলিমেন্টে কোনও অ্যাট্রিবিউট নেই।

চাইল্ড এলিমেন্ট

নিচের সারণীতে <Request>-এর চাইল্ড এলিমেন্ট সম্পর্কে বর্ণনা করা হয়েছে:

চাইল্ড এলিমেন্ট ধরন বিবরণ
<Condition> জটিল অবজেক্ট অনুরোধের সেগমেন্টের মধ্যে থাকা ধাপগুলি এক্সিকিউট করা হবে কিনা তা নির্ধারণ করে।
<Step> স্ট্রিং অনুরোধের সেগমেন্টের মধ্যে প্রয়োগ করার জন্য একটি নীতি নির্দিষ্ট করে।

<Response>

ফ্লোয়ের উত্তর পর্ব চলাকালীন প্রয়োগ করার জন্য নীতি নির্ধারণ করে।

টাইপ করুন জটিল অবজেক্ট
প্যারেন্ট এলিমেন্ট <Flow>
<PreFlow>
<PostClientFlow>
<PostFlow>
চাইল্ড এলিমেন্ট <Condition>
<Step>

সিন্ট্যাক্স

<Response> এলিমেন্ট নিম্নলিখিত সিনট্যাক্স ব্যবহার করে:

<Response>
  <Step>
    <Condition>property operator "value"</Condition>
    <Name>policy_name</Name>
  </Step>
  ...
</Response>

<Response>-এর সব চাইল্ড এলিমেন্ট ঐচ্ছিক।

উদাহরণ

নিচের উদাহরণে, উত্তর দেওয়ার জন্য নির্ধারিত ফ্লো দেখানো হয়েছে, যা PreFlow ও PostFlow, দু'টিতেই আছে:

<!-- api-platform/reference/examples/flow-segments/response-1.xml -->
<ProxyEndpoint name="default">
    <PreFlow name="my-preFlows">
        <Description>My first PreFlow</Description>
        <Response>
            <Step>
                <Condition>response.status.code LesserThanOrEquals 300</Condition>
                <Name>Log-Response-OK</Name>
            </Step>
            <Step>
                <Condition>response.status.code GreaterThan 300</Condition>
                <Name>Log-Response-NOT-OK</Name>
            </Step>
        </Response>
    </PreFlow>
    <PostFlow name="my-postflows">
        <Description>My first PostFlow</Description>
        <Response>
            <Step>
                <Name>Set-Response-Headers</Name>
            </Step>
        </Response>
    </PostFlow>
  ...
</ProxyEndpoint>

অ্যাট্রিবিউট

<Response> এলিমেন্টে কোনও অ্যাট্রিবিউট নেই।

চাইল্ড এলিমেন্ট

নিচের সারণীতে <Response>-এর চাইল্ড এলিমেন্ট সম্পর্কে বর্ণনা করা হয়েছে:

চাইল্ড এলিমেন্ট ধরন বিবরণ
<Condition> স্ট্রিং উত্তর বিভাগের মধ্যে থাকা ধাপগুলি এক্সিকিউট করা হবে কিনা তা নির্ধারণ করে।
<Step> স্ট্রিং উত্তর সেগমেন্টের মধ্যে প্রয়োগ করার জন্য একটি নীতি নির্দিষ্ট করে।

<Step>

কোনও নীতি প্রয়োগ করার জন্য নির্দিষ্ট করে এবং (ঐচ্ছিকভাবে) এমন একটি শর্ত যা নির্ধারণ করে যে সেই নীতি প্রয়োগ করা হবে কিনা।

টাইপ করুন জটিল অবজেক্ট
প্যারেন্ট এলিমেন্ট <Request>
<Response>
চাইল্ড এলিমেন্ট <Condition>
<Name>

<Flow>-এ একাধিক ধাপ থাকতে পারে এবং ফ্লোয়ের XML-এ যেভাবে ধাপগুলি সাজানো থাকে, সেই ক্রমেই সেগুলি এক্সিকিউট করা হয়।

কোনও শর্ত না থাকলে ধাপগুলি সবসময় এক্সিকিউট হয়। শর্তযুক্ত ধাপ তখনই এক্সিকিউট হয় যদি শর্তটি সত্য হয়। শর্তটি মিথ্যা হলে, Edge ধাপটি এড়িয়ে যায়।

সিন্ট্যাক্স

<Step> এলিমেন্ট নিম্নলিখিত সিনট্যাক্স ব্যবহার করে:

<Step>
  <Condition>property operator "value"</Condition>
  <Name>policy_name</Name>
</Step>

<Step> পিছু একটি <Condition> ও একটি <Name> থাকতে পারে, কিন্তু <Flow>-এ একাধিক ধাপ থাকতে পারে।

<Step>-এর সব চাইল্ড এলিমেন্ট ঐচ্ছিক।

নমুনা ১

নিচের উদাহরণে একটি শর্ত সহ এবং একটি শর্ত ছাড়া ধাপ দেখানো হয়েছে:

<!-- api-platform/reference/examples/flow-segments/step-1.xml -->
<ProxyEndpoint name="default">
  <PostFlow name="my-postflows">
      <Description>My first PostFlow</Description>
      <Request>
          <Step>
              <Condition>request.verb = "GET"</Condition>
              <Name>Log-Request-OK</Name>
          </Step>
      </Request>
      <Response>
          <Step>
              <Name>Set-Response-Headers</Name>
          </Step>
      </Response>
  </PostFlow>
  ...
</ProxyEndpoint>

যে ধাপে কোনও কন্ডিশন নেই, সেটি অনুরোধের সেগমেন্ট চলাকালীন প্রতিবার এক্সিকিউট করা হবে। কন্ডিশন সহ ধাপটি শুধুমাত্র তখনই এক্সিকিউট হবে যখন অনুরোধটি রেসপন্স সেগমেন্ট চলাকালীন "GET" হবে।

নমুনা ২

নিচের উদাহরণে একটি সেগমেন্টে একাধিক ধাপ দেখানো হয়েছে:

<!-- api-platform/reference/examples/flow-segments/step-2.xml -->
<ProxyEndpoint name="default">
    <PostFlow name="PostFlow">
        <Response>
            <Step>
                <Name>Assign-Message-1</Name>
            </Step>
            <Step>
                <Name>Assign-Message-2</Name>
            </Step>
        </Response>
    </PostFlow>
  ...
</ProxyEndpoint>

শর্ত ছাড়া ধাপ সবসময় এক্সিকিউট হয়।

অ্যাট্রিবিউট

<Step> এলিমেন্টে কোনও অ্যাট্রিবিউট নেই।

চাইল্ড এলিমেন্ট

নিচের সারণীতে <Step>-এর চাইল্ড এলিমেন্ট সম্পর্কে বর্ণনা করা হয়েছে:

চাইল্ড এলিমেন্ট ধরন বিবরণ
<Condition> স্ট্রিং রানটাইমে প্রসেস করা ধাপের জন্য একটি শর্তসাপেক্ষ বিবৃতি নির্ধারণ করে। যদি বিবৃতিটি সত্য হয়, তাহলে Edge ধাপটি এক্সিকিউট করে। বিবৃতিটি মিথ্যা হলে Edge এই ধাপটি এড়িয়ে যায়।
<Name> স্ট্রিং বর্তমান ফ্লোতে এক্সিকিউট করার জন্য নীতির আইডি নির্দিষ্ট করে।