شما در حال مشاهده اسناد Apigee Edge هستید.
به مستندات Apigee X بروید . اطلاعات
می توانید از برنامه های افزودنی برای ادغام منابع خارجی در پراکسی های API خود استفاده کنید. برای مثال، می‌توانید سرویس‌های پلتفرم Google Cloud مانند Google Cloud Storage را ادغام کنید. در زمان اجرا، یک پراکسی API از افزونه برای تبادل درخواست ها و پاسخ ها با منبع خارجی استفاده می کند.
چارچوب زمان اجرا پسوند
در زمان اجرا، یک برنامه افزودنی به عنوان واسطه ای عمل می کند و درخواست ها و پاسخ ها را بین یک پراکسی API و یک منبع خارجی پردازش می کند.
در اینجا یک نمای کلی از نحوه عملکرد پردازش از طریق یک برنامه افزودنی در زمان اجرا آورده شده است.
- یک درخواست مشتری به یک پروکسی API می رسد و جریان درخواست آن از طریق خط مشی های پروکسی انجام می شود.
- جریان درخواست به یک خط مشی Extension Callout در پراکسی می رسد که برای ارسال داده به یک برنامه افزودنی مستقر در محیط پیکربندی شده است. داده ها شامل مقادیری است که برای ارسال درخواست به منبع خارجی که برنامه افزودنی نشان می دهد، مورد نیاز است.
- برنامه افزودنی درخواستی را به منبع خارجی ارسال می کند، سپس یک پاسخ دریافت می کند.
- برنامه افزودنی پاسخ خود را به خط مشی Extension Callout ارسال می کند، جایی که توسط کد پراکسی مدیریت می شود.
- جریان درخواست از طریق پروکسی ادامه می یابد تا زمانی که پاسخی را به مشتری بازگرداند.
کار با افزونه ها
هر برنامه افزودنی با در نظر گرفتن یک منبع خارجی خاص توسعه و پیکربندی شده است. برای استفاده از یک برنامه افزودنی، یک مدیر Apigee Edge و توسعه دهنده پروکسی API این مراحل سطح بالا را دنبال می کنند:
- یک مدیر سازمان Apigee Edge افزونه را پیکربندی و اجرا می کند. آنها آن را با مقادیری خاص برای نیازهای کسب و کار پیکربندی می کنند. این پیکربندی یک نمونه برنامه افزودنی ایجاد می کند که برای استفاده توسط توسعه دهنده پروکسی API متمرکز شده است. برای مثال، آنها ممکن است یک برنامه افزودنی را برای دسترسی به یک سطل خاص در Google Cloud Storage پیکربندی کنند، از جمله اعتبارنامه‌های احراز هویت مورد نیاز.
- یک توسعه‌دهنده پروکسی API از یک برنامه افزودنی پیکربندی‌شده در یک پراکسی API با افزودن یک خط‌مشی فراخوان برنامه افزودنی به پراکسی استفاده می‌کند. پیکربندی خط مشی مشخص می کند
- که برنامه افزودنی را برای استفاده پیکربندی کرده است.
- اقدامات برنامه افزودنی (اینها را به عنوان فراخوانی تابع به برنامه افزودنی در نظر بگیرید) برای فراخوانی.
- پارامترهای عمل برای ارسال با فراخوانی اقدام. در زمان اجرا، این خط مشی از برنامه افزودنی برای دسترسی به منبع خارجی به عنوان بخشی از جریان پروکسی استفاده می کند.
اسناد در مورد پسوندها
موضوعات زیر اطلاعات بیشتری در مورد افزونه ها ارائه می دهد:
- برای آشنایی عملی با افزونه‌ها، به آموزش: افزودن و استفاده از افزونه مراجعه کنید.
- برای ارجاع به برنامه های افزودنی همراه با Apigee Edge، به نمای کلی مرجع برنامه های افزودنی مراجعه کنید.
- برای ارجاع به API مدیریتی که می‌توانید برای افزودن، حذف و استقرار برنامه‌های افزودنی استفاده کنید، به API برنامه‌های افزودنی مراجعه کنید.