צירוף של זרימת עבודה משותפת באמצעות וו של זרימת עבודה

אתם צופים במסמכי התיעוד של Apigee Edge.
כדאי לעיין במסמכי התיעוד של Apigee X. מידע

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

הקוד שמצורף ל-flow hook נמצא מחוץ להקשר של הלוגיקה המרכזית של ה-proxy ל-API, ולכן חלק מההתנהגות שלו שונה מזו של proxies ל-API. חשוב לזכור:

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

בסרטון הבא מוצג איך לקשר תהליך משותף ל-flow hook, ואז לעקוב אחריו בממשק המשתמש של Classic Edge.

בסרטון הבא מוצגות הוראות לחיבור של תהליך משותף ל-Flow Hook, ולאחר מכן למעקב אחריו, בממשק המשתמש של New Edge.

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

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

מידע נוסף על תהליכים משותפים זמין במאמר תהליכים משותפים שאפשר לעשות בהם שימוש חוזר.

מצרפים תהליך משותף ל-Flow Hook באמצעות מסוף הניהול של Apigee Edge. אפשר לצרף לכל היותר זרימת נתונים משותפת אחת לנקודת חיבור של זרימת נתונים בכל אחד מהמקומות הבאים:

• Pre-proxy Flow Hook ללוגיקה שצריך לאכוף לפני שנקודת קצה של proxy מופעלת.

  לדוגמה, יכול להיות שיש לכם לוגיקה לאכיפת אבטחה בכל ממשקי ה-API בסביבה מסוימת.

• Pre-target Flow Hook ללוגיקה שצריך לאכוף לפני שקוראים ליעד.

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

• ‫Post-target Flow Hook ללוגיקה שצריך לאכוף אחרי שהתגובה של היעד מופעלת.

  האכיפה תתבצע מיד אחרי שהתשובה תחזור מהקצה העורפי. אפשר להשתמש בו כדי לרשום ביומן את התגובה של ה-Backend או לבצע תהליך בחירת רשת (Mediation) על ידי הסרת שדות רגישים מהתגובה של ה-Backend.

• Post-proxy Flow Hook ללוגיקה שצריך לאכוף אחרי נקודת הקצה של ה-proxy ולפני שהתגובה נשלחת ללקוח.

  הפעולות האלה יכולות לכלול לוגיקה מסוימת לאכיפת CORS, רישום התגובה או ביצוע מיזוג או עיצוב מסוימים.

צירוף של תהליך משותף לנקודת חיבור של תהליך

כדי לצרף זרימת נתונים משותפת לנקודת חיבור של זרימת נתונים, אתם צריכים להיות אדמינים בארגון שמכיל את זרימת הנתונים המשותפת.

1. ניגשים לדף Flow Hooks (נקודות חיבור לזרימת נתונים), כמו שמתואר בהמשך.

   Edge

   כדי לגשת לדף Flow Hooks (נקודות חיבור בתהליך) באמצעות ממשק המשתמש של Edge:

   1. נכנסים לחשבון בכתובת apigee.com/edge.
   2. בוחרים את הארגון שמכיל את התהליך המשותף. אפשר לקרוא על כך במאמר מעבר בין הארגונים.

      התהליך המשותף יהיה זמין לכל ה-proxy ל-API ולכל התהליך המשותף שנפרסו בסביבה מהארגון הזה. הוא לא יהיה זמין מחוץ לארגון הזה.

   3. בסרגל הניווט הימני, בוחרים באפשרות אדמין > סביבות > Flow Hooks.

   ‫Classic Edge (ענן פרטי)

   כדי לגשת לדף Flow Hooks (נקודות חיבור לזרימת נתונים) באמצעות ממשק המשתמש הקלאסי של Edge:

   1. מתחברים אל http://ms-ip:9000, כאשר ms-ip היא כתובת ה-IP או שם ה-DNS של צומת שרת הניהול.
   2. בוחרים את הארגון שמכיל את התהליך המשותף. אפשר לקרוא על כך במאמר מעבר בין הארגונים.

      התהליך המשותף יהיה זמין לכל ה-proxy ל-API ולכל התהליך המשותף שנפרסו בסביבה מהארגון הזה. הוא לא יהיה זמין מחוץ לארגון הזה.

   3. בסרגל הניווט העליון, בוחרים באפשרות ממשקי API > הגדרת סביבה > נקודות חיבור לזרימת נתונים.
2. ברשימת ה-flow hooks, מזהים את ה-flow hook שאליו רוצים לצרף את ה-shared flow, בהתאם למיקום שבו רוצים שה-shared flow יופעל.

   המיקום של קטע ה-Hook לזרימה	תיאור
   Pre-proxy Flow Hook	לפני שנקודת קצה של שרת proxy מופעלת
   Pre-target Flow Hook	לפני שנקודת קצה של יעד מופעלת
   Post-target Flow Hook	אחרי שהתשובה הממוקדת מופעלת
   Post-proxy Flow Hook	אחרי נקודת הקצה של ה-proxy ולפני שהתגובה נשלחת ללקוח

3. מעבירים את הסמן מעל נקודת החיבור של הזרימה ברשימה כדי להציג את עמודת הפעולות.
4. לוחצים על .
5. בתיבת הדו-שיח Shared Flow (זרימת נתונים משותפת), בוחרים את זרימת הנתונים המשותפת שרוצים לצרף מהתפריט הנפתח Shared flow (זרימת נתונים משותפת).
6. לוחצים על אישור.
7. מצרפים זרימות משותפות לנקודות חיבור אחרות של זרימות לפי הצורך.