הדף הזה רלוונטי ל-Apigee ול-Apigee Hybrid.
לעיון במסמכי התיעוד של
Apigee Edge
אתם יכולים להגדיר שזרימות משותפות יבצעו עיבוד מקדים של בקשות או עיבוד פוסט של תגובות עבור קבוצה של ממשקי API. באמצעות flow hook, אתם מצרפים תהליך משותף כך שהוא יפעל באותו מקום עבור כל ה-proxy ל-API שנפרסו בסביבה מסוימת. כך מקבלים רצף לוגי שהוטמע ונפרס בנפרד, ולא מהווה חלק מקוד ההטמעה של ה-proxy.
הקוד שמצורף ל-flow hook נמצא מחוץ להקשר של הלוגיקה המרכזית של ה-proxy ל-API, ולכן חלק מההתנהגות שלו שונה מזו של proxies ל-API. חשוב לזכור:
- צריכה להיות לכם הרשאה לצרף תהליך משותף לנקודת חיבור של רצף פעולות. אתם צריכים להיות אדמינים בארגון.
- אפשר לצרף רק זרימת נתונים משותפת אחת לכל נקודת חיבור של זרימת נתונים.
- אפשר לצרף את אותו תהליך משותף לכמה נקודות חיבור לזרימה.
- אם זרימה משותפת שמצורפת ל-flow hook מעלה תקלה או שיש שגיאות במהלך ההפעלה של הזרימה המשותפת, ההודעה תידחה והתקלה תישלח בחזרה למתקשר.
- אם הודעה נדחית במהלך ההפעלה של hook בתהליך עבודה, הפרטים נרשמים ביומן של Analytics בהקשר של ה-proxy שנקרא. התהליך המשותף יכול גם להקפיץ הודעת שגיאה עם קוד מותאם אישית והודעת שגיאה
בסרטון הבא מוצגות הפעולות שצריך לבצע בממשק המשתמש של Apigee כדי לקשר זרימת נתונים משותפת לנקודת חיבור של זרימת נתונים, ואז לעקוב אחריה.
הוספת Shared Flow ל-Proxy באמצעות Flow Hook מאפשרת להוסיף בקלות לוגיקה שמחילה דרישות מדיניות רחבות. לדוגמה, נניח שיש לכם צוות אחד שמנהל קבוצה אחת של דרישות אבטחה עבור כמה צוותים שמייצגים ענפים כלכליים שונים. כל צוות LOB יכול לפתח ממשקי API בהתאם לדרישות שלו, בלי להתחשב בדרישות האבטחה הרחבות יותר. צוות האבטחה יכול להטמיע את דרישות האבטחה האלה בתהליך משותף, ואז לצרף את התהליך לסביבת Apigee באמצעות וו של תהליך. מכיוון שהזרימה המשותפת לא מהווה חלק מקוד ה-proxy, צוות האבטחה יכול לשנות אותה לפי הצורך בלי להפריע לקוד LOB.
תהליכים משותפים שמצורפים באמצעות ווים של תהליכים מופעלים במיקום הזה עבור כל proxy ל-API שנפרס בסביבה של הוו של ה-proxy. לכן, האפשרות להשתמש ב-flow hooks זמינה רק לאדמינים בארגון Apigee.
מידע נוסף על תהליכים משותפים זמין במאמר בנושא יצירת תהליכים משותפים שאפשר לעשות בהם שימוש חוזר.
מצרפים תהליך משותף לנקודת חיבור של תהליך באמצעות ממשק המשתמש של Apigee או Flowhooks API. אפשר לצרף לכל היותר זרימת נתונים משותפת אחת לנקודת חיבור של זרימת נתונים בכל אחד מהמקומות הבאים:
-
Pre-proxy flow hook ללוגיקה שצריך לאכוף לפני שנקודת קצה של proxy מופעלת.
לדוגמה, יכול להיות שיש לכם לוגיקה לאכיפת אבטחה בכל ממשקי ה-API בסביבה מסוימת.
Pre-target flow hook ללוגיקה שצריך לאכוף לפני שנקודת קצה של יעד מופעלת.
לדוגמה, אפשר להטמיע רישום ביומן לפני שהבקשה מגיעה לקצה העורפי. אפשר גם לאכוף גישור על ידי הסרת שדות מסוימים מהבקשה.
Post-target flow hook ללוגיקה שצריך לאכוף אחרי שהתגובה של היעד מופעלת.
האכיפה תתבצע מיד אחרי שהתשובה תחזור מהקצה העורפי. אפשר להשתמש בו כדי לרשום ביומן את התגובה של ה-Backend או לבצע תהליך בחירת רשת (Mediation) על ידי הסרת שדות רגישים מהתגובה של ה-Backend.
Post-proxy flow hook ללוגיקה שצריך לאכוף אחרי נקודת הקצה של ה-proxy ולפני שליחת התגובה ללקוח.
הפעולות האלה יכולות לכלול לוגיקה מסוימת לאכיפת CORS, רישום התגובה או ביצוע מיזוג או עיצוב מסוימים.
צירוף של תהליך משותף לנקודת חיבור של תהליך
כדי לצרף זרימת נתונים משותפת לנקודת חיבור של זרימת נתונים, אתם צריכים להיות אדמינים בארגון שמכיל את זרימת הנתונים המשותפת.
כדי לצרף תהליך משותף לנקודת חיבור של תהליך:
במסוף Google Cloud , עוברים לדף Apigee > Management > Environments.
- בוחרים את הארגון שמכיל את התהליך המשותף. איך עוברים בין הארגונים
ה-Flow המשותף יהיה זמין לכל שרתי ה-proxy של ה-API ולכל ה-Flows המשותפים שנפרסו בסביבה מהארגון הזה. הוא לא יהיה זמין מחוץ לארגון הזה.
- בוחרים את הסביבה שרוצים לערוך מתוך רשימת הסביבות הזמינות.
- בדף Environment details, לוחצים על הכרטיסייה Flow hooks.
מוצגת התצוגה Flow hooks.
- ברשימת ה-flow hooks, מזהים את ה-flow hook שאליו רוצים לצרף את התהליך המשותף.
ה-flow hook שתבחרו תלוי במיקום שבו תרצו שהתקשורת המשותפת תתבצע.
המיקום של קטע ההוק (hook) לזרימה תיאור Pre-proxy הפעולה מתבצעת לפני שנקודת קצה של שרת proxy מופעלת לפני בחירת היעד מופעל לפני הפעלה של נקודת קצה של יעד Post-target הפעולה מתבצעת אחרי שהתגובה של היעד מתבצעת Post-proxy הפעולה מתבצעת אחרי נקודת הקצה של ה-proxy ולפני שהתגובה נשלחת ללקוח - בתיבת הרשימה של נקודת החיבור לזרימה שבחרתם, בוחרים את הזרימה המשותפת שרוצים לצרף.
- מצרפים זרימות משותפות לנקודות חיבור אחרות של זרימות לפי הצורך.
- לוחצים על שמירה כדי לצרף את התהליכים המשותפים שנבחרו לנקודות ההתחלה של התהליך.