מהם תוספים?

כרגע מוצג התיעוד של Apigee Edge.
כניסה למסמכי התיעוד של Apigee X. מידע

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

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

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

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

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

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

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

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

תיעוד לגבי תוספים

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