پسوندها چیست؟

شما در حال مشاهده مستندات Apigee Edge هستید.
به مستندات Apigee X مراجعه کنید .
اطلاعات

شما می‌توانید از افزونه‌ها برای ادغام منابع خارجی در پروکسی‌های API خود استفاده کنید. به عنوان مثال، می‌توانید سرویس‌های Google Cloud Platform مانند Google Cloud Storage را ادغام کنید. در زمان اجرا، یک پروکسی API از افزونه برای تبادل درخواست‌ها و پاسخ‌ها با منبع خارجی استفاده می‌کند.

چارچوب زمان اجرای افزونه

در زمان اجرا، یک افزونه به عنوان یک واسطه عمل می‌کند و درخواست‌ها و پاسخ‌ها را بین یک پروکسی API و یک منبع خارجی پردازش می‌کند.

در اینجا مروری بر نحوه پردازش از طریق یک افزونه در زمان اجرا ارائه شده است.

  1. یک درخواست کلاینت به یک پروکسی API می‌رسد و جریان درخواست آن از طریق سیاست‌های پروکسی ادامه می‌یابد.
  2. جریان درخواست به یک سیاست فراخوانی افزونه در پروکسی می‌رسد که برای ارسال داده‌ها به افزونه‌ای که در محیط مستقر است پیکربندی شده است. داده‌ها شامل مقادیری هستند که برای ارسال درخواست به منبع خارجی که افزونه نشان می‌دهد، مورد نیاز خواهند بود.
  3. افزونه یک درخواست به منبع خارجی ارسال می‌کند، سپس پاسخی دریافت می‌کند.
  4. افزونه پاسخ خود را به سیاست فراخوانی افزونه‌ها ارسال می‌کند، جایی که توسط کد پروکسی مدیریت می‌شود.
  5. جریان درخواست از طریق پروکسی ادامه می‌یابد تا زمانی که پاسخی به کلاینت برگرداند.

کار با افزونه‌ها

هر افزونه با در نظر گرفتن یک منبع خارجی خاص توسعه داده و پیکربندی می‌شود. برای استفاده از یک افزونه، یک مدیر Apigee Edge و یک توسعه‌دهنده پروکسی API، این مراحل سطح بالا را دنبال می‌کنند:

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

مستندات مربوط به افزونه‌ها

مباحث زیر اطلاعات بیشتری در مورد افزونه‌ها ارائه می‌دهند: