צירוף מדיניות ל-ProxyEndpoint או לתהליך יעד של נקודת קצה (TargetEndpoint)

מוצג המסמך של Apigee Edge.
עוברים אל מסמכי תיעוד של Apigee X. מידע

כללי מדיניות לא יופעלו לפני שהם יצורפו לתהליך. אפשר ליצור מדיניות קובץ מצורף על ידי מתן שם למדיניות בהגדרת השלב.

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

הפורמט של קובץ מצורף למדיניות הוא:

<Step>
    <Name>{policy_name}</Name>
</Step>

לדוגמה:

<Step>
    <Name>QuotaPolicy</Name>
</Step>

מדיניות מצורפת ל-flow על ידי הוספה של הגדרת השלב לבקשה המתאימה, או רכיב זרימה של תגובה בתצורה של ProxyEndpoint או TargetEndpoint.

אפשר לצרף מדיניות לבקשה או לתהליך תגובה. ממשיכים עם תהליכי הבקשות והתשובות בחלוקת משנה ל-PreFlow ו-PostFlow.

הדוגמה הבאה ממחישה את ההגדרה המינימלית של ProxyEndpoint, ללא מדיניות קבצים מצורפים. היא מגדירה רק את ה-HTTPProxyConnection (הנכנס) ואת RouteRule.

<ProxyEndpoint name="default">
    <HTTPProxyConnection>
        <BasePath>/weather</BasePath>
        <VirtualHost>default</VirtualHost>
    </HTTPProxyConnection>
    <RouteRule name="default">
        <TargetEndpoint>default</TargetEndpoint>
    </RouteRule>
</ProxyEndpoint>

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

כדי לאכוף את ההגדרה הזו, צריך לצרף שלב עיבוד לבקשה PreFlow בתור ככה:

<ProxyEndpoint name="default">
  <PreFlow>
    <Request>
      <Step><Name>QuotaPolicy</Name></Step>
    </Request>
  </PreFlow>
  <HTTPProxyConnection> 
    <BasePath>/weather</BasePath> 
    <VirtualHost>default</VirtualHost> 
  </HTTPProxyConnection> 
  <RouteRule name="default"> 
    <TargetEndpoint>default</TargetEndpoint> 
  </RouteRule> 
</ProxyEndpoint>

לפעמים ייתכן שתרצו שמדיניות תופעל לאחר עיבוד ראשוני אחר נקודת קצה לשרת proxy. לדוגמה, אתם רוצים לבדוק את Quota ב-PreFlow, ואז לבצע סט נוסף של מתבצע עיבוד אחרי בדיקת המכסה, למשל המרת הבקשה מ-JSON ל-XML. כדי לעשות את זה, לצרף מדיניות לנתיב הבקשה של PostFlow. הדוגמה הבאה היא בקשה ב-PostFlow מצורף. המדיניות הזו תבוצע בהודעת הבקשה לאחר שכל כללי המדיניות יופיעו PreFlow (וכל זרימה מותנית) תופעל.

<PostFlow>
  <Request>
    <Step><Name>JSONtoXMLPolicy</Name></Step>
  </Request>
</PostFlow>

בהמשך מוצגת דוגמה לקובץ תגובה מ-PostFlow. המדיניות הזו תופעל הודעת תגובה. (תגובת PostFlow של ProxyEndpoint היא שלב העיבוד האחרון לפני התגובה תוחזר לאפליקציית הלקוח שהגיש את הבקשה.)

<PostFlow>
  <Response>
    <Step><Name>XMLtoJSONPolicy</Name></Step>
  </Response>
</PostFlow>