מהם תוספים?

אתם צופים במסמכי התיעוד של Apigee Edge.
כדאי לעיין במסמכי התיעוד של Apigee X. מידע

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

סביבת זמן ריצה של תוספים

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

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

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

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

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

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

מסמכי תיעוד בנושא תוספים

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