מהם תוספים?

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

אפשר להשתמש בתוספים כדי לשלב משאבים חיצוניים בשרתי ה-proxy ל-API. לדוגמה, אפשר לשלב שירותי Google Cloud Platform כמו Google Cloud Storage. בזמן הריצה, שרת proxy של API משתמש בתוסף כדי להחליף בקשות ותשובות עם המשאב החיצוני.

מסגרת סביבת זמן הריצה של התוסף

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

בהמשך מופיעה סקירה כללית של אופן העיבוד באמצעות תוסף במהלך זמן הריצה.

  1. בקשת לקוח מגיעה לשרת proxy של API, ותהליך הבקשה שלה מתבצע בהתאם למדיניות של שרת ה-proxy.
  2. תהליך הבקשה מגיע למדיניות של תוסף היתרונות המרכזיים בשרת ה-proxy שמוגדר להעביר נתונים לתוסף שנפרס בסביבה. הנתונים כוללים ערכים שיידרשו לשליחת בקשה למשאב החיצוני שהתוסף מייצג.
  3. התוסף שולח בקשה למשאב החיצוני, ולאחר מכן מקבל תשובה.
  4. התוסף מעביר את התשובה שלו חזרה למדיניות של קריאה לתוסף, שם היא מטופלת על ידי קוד proxy.
  5. תהליך הבקשה ממשיך דרך שרת ה-proxy עד שהוא מחזיר תשובה ללקוח.

עבודה עם תוספים

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

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

מסמכי תיעוד על תוספים

בנושאים הבאים מפורט מידע נוסף על תוספים: