חיבור תהליך משותף באמצעות קרס לזרימה

אתם צופים במסמכי העזרה של Apigee Edge.
כניסה למסמכי העזרה של Apigee X. info

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• פונקציית ה-hook של תהליך הבקשה אחרי שרת ה-proxy לצורך לוגיקה שצריך לאכוף אחרי נקודת הקצה של שרת ה-proxy, ותמיד לפני שהתגובה נשלחת ללקוח.

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

צירוף תהליך עבודה משותף ל-flow hook

כדי לצרף תהליך עבודה משותף ל-flow hook, צריך להיות לכם הרשאת אדמין בארגון שמכיל את תהליך העבודה המשותף.

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

   Edge

   כדי לגשת לדף Flow Hooks באמצעות ממשק המשתמש של Edge:

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

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

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

   Classic Edge (ענן פרטי)

   כדי לגשת לדף Flow Hooks באמצעות ממשק המשתמש הקלאסי של Edge:

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

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

   3. בסרגל הניווט העליון, בוחרים באפשרות APIs‏ > Environment Configuration‏ > Flow Hooks.
2. ברשימת ה-flow hooks, מאתרים את ה-flow hook שאליו רוצים לצרף את התהליך המשותף, בהתאם למקום שבו רוצים להריץ את התהליך המשותף.

   מיקום הוו לזרימה	תיאור
   הוק לזרימה לפני שרת proxy	לפני שמתבצעת הפעלה של נקודת קצה (endpoint) של שרת proxy
   וו (hook) לזרימה לפני היעד	לפני שהקצה היעד מופעל
   וו (hook) לזרימה אחרי יעד	אחרי שהתגובה של היעד מתבצעת
   וו (hook) לזרימה אחרי שרת proxy	אחרי נקודת הקצה של שרת ה-proxy, ממש לפני שהתגובה נשלחת ללקוח

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