המדיניות בנושא יתרונות מרכזיים של זרימה

אימות מפתח ה-API בתהליך המשותף

בדוגמה הזו, תהליך משותף משמש לביצוע משימות נפוצות שקשורות לאבטחה. כאן תהליך משותף מאמת מפתח API. שרתי proxy ל-API ותהליכים משותפים אחרים יכולים להשתמש בתוסף היתרונות המרכזיים של ה-flow. לביצוע קריאות לתהליך המשותף הזה.

הגדרת התהליך המשותף הבא כוללת מדיניות Verify-API-Key שמופעלת כשהתהליך המשותף נקרא ממדיניות FlowCallout בו-זמנית בשרת proxy ל-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, שבה נעשה שימוש בשרת proxy ל-API, מפעילה את התהליך המשותף הקודם אל לאמת את מפתח ה-API. חבילת התהליך המשותף verify-apikey-shared (לא מוצגת כאן) מגדירה את התהליך המשותף באופן שבו חבילת APIProxy מגדירה שרת proxy.

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

העברת פרמטרים לתהליך משותף

דוגמה זו ממחישה כיצד להעביר פרמטרים ממדיניות יתרונות מרכזיים של זרימה תהליך משותף. כאן, המדיניות בנושא יתרונות מרכזיים של זרימה מתייחסת לתהליך משותף שנועד לספק פונקציות של טיפול במחרוזות. התהליך המשותף כולל JavaScript שמשרשר את הקלט, באותיות קטנות, או את שניהם. המדיניות 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 כולל מדיניות JavaScript SharedStringFunctions, שמופעלת כשמתבצעת קריאה לתהליך המשותף ממדיניות של FlowCallout.

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

3. בתהליך המשותף, נעשה שימוש במדיניות SharedStringFunctions הבאה של JavaScript מציין את קובץ ה-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, מבצע מתוך מדיניות JavaScript SharedStringFunctions. הסקריפט הזה מאחזר ערכים מ- משתנים שנוצרו מרכיבי 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, לתהליך המשותף ואז אל מדיניות FlowCallout בו-זמנית בשרת ה-proxy המקורי של ה-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>