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