מהם תוספים?

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

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

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

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

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

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

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

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

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

משאבי עזרה בנושא תוספים

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