นโยบายข้อความไฮไลต์สำหรับโฟลว์

ยืนยันคีย์ API ในโฟลว์ที่แชร์

ในตัวอย่างนี้ ระบบจะใช้โฟลว์ที่แชร์เพื่อทำงานทั่วไปที่เกี่ยวข้องกับความปลอดภัย โดยโฟลว์ที่แชร์จะตรวจสอบคีย์ API พร็อกซี API และโฟลว์ที่แชร์อื่นๆ สามารถใช้นโยบาย FlowCallout เพื่อเรียกใช้โฟลว์ที่แชร์นี้ได้

คำจำกัดความของโฟลว์ที่แชร์ต่อไปนี้มีนโยบาย Verify-API-Key ที่ทำงาน เมื่อมีการเรียกโฟลว์ที่แชร์จากนโยบาย FlowCallout ในพร็อกซี 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>

นโยบาย FlowCallout ต่อไปนี้ซึ่งใช้ในพร็อกซี 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 จะเรียกโฟลว์ที่แชร์ซึ่งออกแบบมาเพื่อทำหน้าที่จัดการสตริงทั่วไป โฟลว์ที่แชร์มี JavaScript ที่เชื่อมสตริงอินพุต แปลงอินพุตเป็นตัวพิมพ์เล็ก หรือทั้ง 2 อย่าง นโยบาย FlowCallout กำหนดพารามิเตอร์ที่ระบุ อินพุตสตริง เอาต์พุต และสิ่งที่ต้องทำกับอินพุต

1. นโยบาย FlowCallout 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 ต่อไปนี้มีนโยบาย JavaScript SharedStringFunctions ที่ทำงานเมื่อมีการเรียกโฟลว์ที่แชร์จากนโยบาย FlowCallout

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

3. ในโฟลว์ที่แชร์ นโยบาย JavaScript SharedStringFunctions ต่อไปนี้จะระบุไฟล์ JavaScript SharedStringFunctions.js ที่มีโค้ดที่จะดำเนินการ

   <?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 สคริปต์นี้จะดึงค่าจาก ตัวแปรที่สร้างจากองค์ประกอบ Parameter ของนโยบาย FlowCallout

   // 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 ไปยังโฟลว์ที่แชร์ แล้วไปยัง นโยบาย FlowCallout ในพร็อกซี 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>

ตัวอย่าง

นโยบาย FlowCallout 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>