הדף הזה רלוונטי ל-Apigee ול-Apigee Hybrid.
לעיון במסמכי התיעוד של
Apigee Edge
אתם יכולים להשתמש בזרימות משותפות כדי לבצע עיבוד מקדים של בקשות או עיבוד פוסט של תגובות במגוון ממשקי API. באמצעות flow hook, אתם מצרפים shared flow כך שהוא יופעל באותו מקום עבור כל ה-API proxy שנפרסו בסביבה ספציפית. כך מקבלים רצף לוגי שהוטמע ונפרס בנפרד, ולא מהווה חלק מקוד ההטמעה של ה-proxy.
הקוד שמצורף ל-flow hook נמצא מחוץ להקשר של הלוגיקה המרכזית של ה-proxy ל-API, ולכן חלק מההתנהגות שלו שונה מזו של proxies ל-API. חשוב לזכור:
- צריכה להיות לכם הרשאה לצרף זרימת נתונים משותפת לנקודת חיבור של זרימת נתונים. אתם צריכים להיות אדמינים בארגון.
- אפשר לצרף רק זרימת נתונים משותפת אחת לכל וו של זרימת נתונים.
- אפשר לצרף את אותו רצף משותף לכמה נקודות חיבור של רצפים.
- אם זרימה משותפת שמצורפת ל-flow hook מעלה תקלה או שיש שגיאות במהלך ההפעלה של הזרימה המשותפת, ההודעה תידחה והתקלה תישלח בחזרה למתקשר.
- אם הודעה נדחית במהלך ההפעלה של hook בתהליך עבודה, הפרטים יתועדו בניתוח הנתונים בהקשר של ה-proxy שנקרא. הזרימה המשותפת יכולה גם להחזיר שגיאה עם קוד מותאם אישית והודעת שגיאה
בסרטון הבא מוצגות הפעולות לחיבור של זרימה משותפת ל-flow hook, ואז למעקב אחריה, בממשק המשתמש של Apigee.
הוספה של Shared Flow ל-Proxy באמצעות Flow Hook מאפשרת להוסיף לוגיקה שמחילה דרישות מדיניות רחבות. לדוגמה, נניח שיש לכם צוות אחד שמנהל קבוצה אחת של דרישות אבטחה עבור כמה צוותים שמייצגים ענפים כלכליים שונים. כל צוות LOB יכול לפתח ממשקי API בהתאם לדרישות שלו, בלי להתחשב בדרישות האבטחה הרחבות יותר. צוות האבטחה יכול להטמיע את דרישות האבטחה האלה בתהליך משותף, ואז לצרף את התהליך לסביבת Apigee באמצעות וו של תהליך. מכיוון שהזרימה המשותפת לא נכללת בקוד ה-proxy, צוות האבטחה יכול לשנות אותה לפי הצורך בלי להפריע לקוד LOB.
תצורות SharedFlow שמצורפות באמצעות ווים של תצורות Flow מופעלות במיקום הזה עבור כל proxy ל-API שנפרס בסביבה של ה-Proxy Hook. לכן, האפשרות להשתמש ב-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.
- בוחרים את הארגון שמכיל את התהליך המשותף. איך עוברים בין הארגונים
התהליך המשותף יהיה זמין לכל שרתי ה-proxy של ה-API ולתהליכים משותפים שנפרסו בסביבה מהארגון הזה. הוא לא יהיה זמין מחוץ לארגון הזה.
- בוחרים את הסביבה שרוצים לערוך מתוך רשימת הסביבות הזמינות.
- בדף Environment details, לוחצים על הכרטיסייה Flow hooks.
מוצגת התצוגה Flow hooks.
- ברשימת ה-flow hooks, מזהים את ה-flow hook שאליו רוצים לצרף את ה-shared flow.
ה-flow hook שתבחרו תלוי במיקום שבו תרצו שהתקשורת המשותפת תתבצע.
המיקום של קטע ההוק (hook) לזרימה תיאור Pre-proxy מופעל לפני הפעלה של נקודת קצה של שרת proxy לפני הטירגוט הפעולה מתבצעת לפני שנקודת קצה של יעד מופעלת Post-target הפעולה מתבצעת אחרי שהתגובה ליעד מתבצעת Post-proxy הפעולה מתבצעת אחרי נקודת הקצה של ה-proxy ולפני שהתגובה נשלחת ללקוח - בתיבת הרשימה של נקודת החיבור לזרימה שבחרתם, בוחרים את הזרימה המשותפת שרוצים לצרף.
- מצרפים זרימות משותפות לנקודות חיבור אחרות של זרימות לפי הצורך.
- לוחצים על שמירה כדי לצרף את התהליכים המשותפים שנבחרו לנקודות ההתחלה של התהליך.