نمای کلی Edge Microgateway

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

Edge Microgateway نسخه ۳.۱.۵ و بالاتر

Apigee Edge Microgateway یک پردازشگر پیام مبتنی بر HTTP و ایمن برای «میاناهای برنامه‌سازی کاربردی» است. وظیفه اصلی آن پردازش ایمن درخواست‌ها و پاسخ‌ها به و از سرویس‌های زیرینه به‌صورت ناهمزمان و ارسال داده‌های ارزشمند اجرای میانای برنامه‌سازی کاربردی به Apigee Edge است، جایی که سیستم Edge Analytics از آن استفاده می‌کند. نصب و استقرار Edge Microgateway آسان است -- می‌توانید نمونه‌ای را در چند دقیقه راه‌اندازی کنید.

معمولاً Edge Microgateway در شبکه مطمئنی در نزدیکی سرویس‌های هدف زیرینه نصب می‌شود. این محصول امنیت در سطح سازمانی و برخی‌از ویژگی‌های کلیدی افزایه مانند مهار جهش، سهمیه، و تجزیه‌وتحلیل را ارائه می‌دهد، اما قابلیت‌ها یا ردپای کامل Apigee Edge را ارائه نمی‌دهد. درصورت تمایل می‌توانید Edge Microgateway را در همان مرکز داده یا حتی در همان ماشین سرویس‌های زیرینه خود نصب کنید.

می‌توانید Edge Microgateway را به‌عنوان فرایندی مستقل اجرا کنید یا آن را در محتوی Docker اجرا کنید. به استفاده از Docker با Edge Microgateway مراجعه کنید. همچنین می‌توانید از Edge Microgateway برای ارائه مدیریت Apigee API برای سرویس‌های درحال اجرا در خوشه Kubernetes استفاده کنید. چه درحال انتقال سرویس‌ها و میاناهای برنامه‌سازی کاربردی موجود به پشته Kubernetes باشید چه درحال ایجاد سرویس‌ها و میاناهای برنامه‌سازی کاربردی جدید، Edge Microgateway به ارائه تجربه مدیریت میانای برنامه‌سازی کاربردی پاکیزه‌ای کمک می‌کند که شامل امنیت، مدیریت ترافیک، تجزیه‌وتحلیل، انتشار، و موارد دیگر می‌شود. یکپارچه‌سازی Edge Microgateway با Kubernetes را ببینید.

کاربردهای معمول

موارد استفاده معمول برای راهکار مدیریت Cloud API ترکیبی مانند Edge Microgateway شامل موارد زیر است:

  • تأخیر ترافیک «میانای برنامه‌سازی کاربردی» را برای سرویس‌هایی که در مجاورت هم اجرا می‌شوند کاهش دهید. برای مثال، اگر مصرف‌کنندگان و تولیدکنندگان میانای برنامه‌سازی کاربردی شما در مجاورت یکدیگر باشند، لزوماً نمی‌خواهید میاناهای برنامه‌سازی کاربردی از یک دروازه مرکزی عبور کنند.
  • ترافیک «میانای برنامه‌سازی کاربردی» را برای اهداف امنیتی یا رعایت استانداردها در محدوده تأییدشده سازمانی نگه دارید.
  • اگر اتصال اینترنت موقتاً قطع شد، پردازش پیام‌ها ادامه می‌یابد.
  • مدیریت Apigee API را برای سرویس‌های درحال اجرا در خوشه Kubernetes ارائه دهید. یکپارچه‌سازی Edge Microgateway با Kubernetes را ببینید.

برای موارد استفاده بیشتر، این مقاله انجمن Apigee را ببینید.

ویژگی‌ها و مزایای کلیدی

ویژگی مزايا
امنیت ‫Edge Microgateway درخواست‌ها را بااستفاده از کلید میانای برنامه‌سازی کاربردی یا کد دسترسی امضاشده‌ای که Apigee Edge برای هر برنامه سرویس‌گیرنده صادر کرده است اصالت‌سنجی می‌کند.
استقرار سریع برخلاف استقرار کامل Apigee Edge، می‌توانید نمونه‌ای از Edge Microgateway را در چند دقیقه مستقر و اجرا کنید.
مجاورت شبکه می‌توانید Edge Microgateway را در همان ماشین، زیرشبکه، یا مرکز داده‌ای نصب و مدیریت کنید که «میاناهای برنامه‌سازی کاربردی هدف» زیرینه که Edge Microgateway با آن‌ها تعامل دارد در آن قرار دارد.
Analytics ‫Edge Microgateway داده‌های اجرای میانای برنامه‌سازی کاربردی را به‌صورت ناهم‌زمان به Apigee Edge ارائه می‌دهد، جایی که این داده‌ها توسط سیستم Edge Analytics پردازش می‌شوند. می‌توانید از مجموعه کامل سنجه‌ها، داشبوردها، و میاناهای برنامه‌سازی کاربردی Edge Analytics استفاده کنید.
کاهش تأخیر همه ارتباطات با Apigee Edge ناهمزمان است و به‌عنوان بخشی از پردازش درخواست‌های API کارخواه انجام نمی‌شود. این کار به Edge Microgateway امکان می‌دهد داده‌های API را جمع‌آوری کند و بدون تأثیر گذاشتن بر تأخیر، آن را به Apigee Edge ارسال کند.
آشنایی ‫Edge Microgateway از ویژگی‌های Apigee Edge استفاده می‌کند و با آن‌ها تعامل دارد. مدیران Edge ازقبل با این ویژگی‌ها آشنا هستند، مثل پراکسی‌ها، محصولات، و برنامه‌های توسعه‌دهنده.
پیکربندی برای راه‌اندازی و مدیریت Edge Microgateway نیازی به برنامه‌نویسی نیست. همه چیز ازطریق پیکربندی مدیریت می‌شود.
آسانی می‌توانید Edge Microgateway را با زیرساخت و فرایندهای پایش و مدیریت برنامه موجودتان یکپارچه کنید. توجه داشته باشید که پایش Apigee API برای Edge Microgateway پشتیبانی نمی‌شود.
ثبت فایل‌های گزارش همه رویدادهای عادی و استثنایی را که درطول پردازش API توسط Edge Microgateway با آن‌ها مواجه شده است به‌تفصیل شرح می‌دهد.
CLI میانای خط فرمان به شما امکان می‌دهد Edge Microgateway را شروع، متوقف، و بازراه‌اندازی کنید، آمار عملکرد را استخراج کنید، فایل‌های گزارش را مشاهده کنید، نشان‌های دسترسی را درخواست کنید، و کارهای دیگر انجام دهید.

آنچه باید درباره Edge Microgateway بدانید

این بخش نحوه عملکرد Edge Microgateway، معماری پایه، پیکربندی، و استقرار آن را توضیح می‌دهد.

چرا از Edge Microgateway استفاده کنیم؟

نزدیک کردن عنصر مدیریت API به برنامه‌های هدف زیرینه می‌تواند تأخیر شبکه را کاهش دهد. اگرچه می‌توانید Apigee Edge را در محل در فضای ابری خصوصی نصب کنید، اما استقرار کامل Apigee Edge لزوماً بزرگ و پیچیده است تا از مجموعه کامل ویژگی‌ها و ویژگی‌های سنگین داده مانند مدیریت کلید، درآمدزایی و تجزیه‌وتحلیل پشتیبانی کند. این یعنی استقرار Apigee Edge در محل در هر مرکز داده همیشه مطلوب نیست.

با Edge Microgateway، برنامه ردپای نسبتاً کوچکی دریافت می‌کنید که نزدیک به برنامه‌های کارساز شما اجرا می‌شود. و می‌توانید از Apigee Edge کامل برای تجزیه‌وتحلیل، امنیت، و ویژگی‌های دیگر استفاده کنید.

سناریوهای استقرار نمونه

این بخش چندین سناریو استقرار احتمالی برای Edge Microgateway را نشان می‌دهد.

همان دستگاه

شکل ۱ مسیر پردازش درخواست را زمانی نشان می‌دهد که Edge Microgateway در ساده‌ترین پیکربندی ممکن خود مستقر شده باشد، جایی که Edge Microgateway و APIهای هدف زیرینه در یک ماشین نصب شده‌اند. از یک نمونه Edge Microgateway می‌توان برای پشتیبانی از چندین برنامه هدف زیرینه استفاده کرد

دروازه کوچک Edge در شبکه شما مستقر شده است. درخواست‌های «میانای برنامه‌سازی کاربردی» را از کارخواه‌ها پردازش می‌کند و سرویس‌های هدف را فراخوانی می‌کند. ریزدروازه داده‌های پراکسی و تجزیه‌وتحلیل را با Apigee Edge Cloud مبادله می‌کند.
شکل ۱: ساده‌ترین استقرار Edge Microgateway

دستگاه دیگر

ازآنجایی‌که همه ارتباطات بین مشتریان، Edge Microgateway، و پیاده‌سازی‌های API پشتیبان HTTP است، می‌توانید Apigee Edge Microgateway را روی دستگاهی متفاوت از پیاده‌سازی API نصب کنید، همان‌طور که در «شکل ۲» نشان داده شده است.

‫Edge Microgateway در یک ماشین مستقر شده است و خدمات زیرینه در مکان دیگری مستقر شده است. درخواست‌های API توسط ریزدروازه پردازش می‌شوند و درخواست‌ها به هدف‌های زیرینه ارسال می‌شوند. ‫Microgateway داده‌های تجزیه‌وتحلیل و پراکسی را با Apigee Edge Cloud ارتباط برقرار می‌کند.
شکل ۲: Edge Microgateway جدا از میاناهای برنامه‌سازی کاربردی هدف زیرینه

با ترازکننده بار

خود Edge Microgateway می‌تواند با یک پراکسی معکوس استاندارد یا ترازکننده بار برای پایان دادن به SSL و/یا تراز کردن بار، همان‌طور که در «شکل ۳» نشان داده شده است، پیش‌کار شود.

تراز بار ترافیک را به چندین نمونه از Edge Microgateway ارسال می‌کند. نمونه‌های ریزدروازه با Edge Cloud ارتباط برقرار می‌کنند و درخواست‌ها را به سرویس‌های هدف واسطه‌گری می‌کنند.
شکل ۳: اجرای Edge Microgateway با ترازکننده بار

استقرار اینترانت

از Edge Microgateway برای محافظت از ترافیک اینترانت استفاده کنید و درعین‌حال با Apigee Edge از ترافیک اینترنت محافظت کنید، همان‌طور که در «شکل ۴» نشان داده شده است. فرض کنیم نقطه پایانی API /orders ازطریق Apigee Edge Cloud پراکسی شود و به هدف زیرینه https://mycompany.com/orders برسد. این با پیاده‌سازی میانای برنامه‌سازی کاربردی هدف در سمت راست نشان داده می‌شود. این «میانای برنامه‌سازی کاربردی» سپس می‌تواند چندین نقطه پایانی «میانای برنامه‌سازی کاربردی» را که با پیاده‌سازی هدف در سمت راست نشان داده شده است فراخوانی کند. برای مثال، ممکن است به‌صورت داخلی /customers و /transactions را فراخوانی کند. همچنین این پست را در «انجمن Apigee» ببینید.

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

وابستگی به Apigee Edge

‫Edge Microgateway به Apigee Edge وابسته است و با آن تعامل دارد. ‫Edge Microgateway باید برای عملکرد صحیح با Apigee Edge ارتباط برقرار کند. روش‌های اصلی که Edge Microgateway با Edge تعامل می‌کند عبارت‌اند از:

  • پس‌از راه‌اندازی، Edge Microgateway فهرستی از پراکسی‌های ویژه «آگاه از Edge Microgateway» و فهرستی از همه محصولات API از سازمان Apigee Edge شما دریافت می‌کند. برای هر درخواست ورودی مشتری، «دروازه کوچک Edge» تعیین می‌کند که آیا درخواست با یکی از این پراکسی‌های API مطابقت دارد یا نه و سپس کد دسترسی ورودی یا کلید API را براساس کلیدهای موجود در محصول API مرتبط با آن پراکسی اعتبارسنجی می‌کند.
  • سیستم Apigee Edge Analytics داده‌های API را که به‌صورت ناهم‌زمان از Edge Microgateway ارسال شده است ذخیره و پردازش می‌کند.
  • ‫Apigee Edge اطلاعات اعتباری‌ای را که برای امضا کردن نشانه‌های دسترسی استفاده می‌شود یا کلیدهای میانای برنامه‌سازی کاربردی‌ای را که کارخواهانی که ازطریق Edge Microgateway تماس با «میانای برنامه‌سازی کاربردی» برقرار می‌کنند به آن‌ها نیاز دارند ارائه می‌دهد. می‌توانید این نشان‌ها را بااستفاده از فرمان CLI ارائه‌شده با Edge Microgateway دریافت کنید.

پیکربندی یک‌باره

ابتدا باید Edge Microgateway را پیکربندی کنید تا بتواند با سازمان Apigee Edge شما ارتباط برقرار کند. در زمان راه‌اندازی، Edge Microgateway یک عملیات خودراه‌اندازی با Apigee Edge را آغاز می‌کند. ‫Edge Microgateway اطلاعات موردنیاز برای پردازش تماس‌های API را به‌تنهایی از Apigee Edge بازیابی می‌کند، ازجمله فهرست پراکسی‌های Edge Microgateway-aware که در Apigee Edge مستقر شده‌اند. به‌زودی درباره این پراکسی‌ها بیشتر صحبت خواهیم کرد.

«دروازه کوچک Edge» لازم نیست با Apigee Edge هم‌مکان باشد؛ پیشنهادهای ابری عمومی و خصوصی Apigee Edge به‌یک اندازه خوب کار می‌کنند.

آنچه باید درباره پراکسی‌های آگاه از Edge Microgateway بدانید

کارگزاران آگاه از Edge Microgateway اطلاعات خاصی را دراختیار Edge Microgateway قرار می‌دهند که به آن امکان می‌دهد درخواست‌های API مشتری را پردازش کند. اطلاعات مربوط به این پراکسی‌ها هنگام راه‌اندازی Edge Microgateway از Apigee Edge در Edge Microgateway بارگیری می‌شود.

اگر بخواهید، می‌توانید این پراکسی‌ها را در Apigee Edge بااستفاده از واسط کاربر مدیریت Apigee Edge یا ازطریق روش‌های دیگر ایجاد کنید. این کار برعهده شما یا تیم API شما است. انجام این کار آسان است و جزئیات آن را در راه‌اندازی و پیکربندی Edge Microgateway توضیح داده‌ایم.

ویژگی‌های پراکسی‌های آگاه از Edge Microgateway عبارت‌اند از:

  • این فایل‌ها دو بخش کلیدی از اطلاعات را دراختیار Edge Microgateway قرار می‌دهند: مسیر پایه و نشانی وب مقصد.
  • باید به نقاط پایان هدف HTTP اشاره کنند. هدف زیرینه نمی‌تواند برنامه Node.js باشد که توسط عنصر ScriptTarget در تعریف TargetEndpoint ارجاع داده شده است. برای اطلاعات بیشتر، یادداشت قبلی را ببینید.
  • نام‌های پراکسی باید با edgemicro_ پیشوند داشته باشند. برای مثال: edgemicro_weather.
  • نمی‌توانید به این پراکسی‌ها خط‌مشی یا جریان شرطی اضافه کنید. اگر تلاش کنید، نادیده گرفته می‌شوند. درغیراین‌صورت، کارگزاران پراکسی آگاه از Edge Microgateway در «میانای کاربری مدیریت Edge» مانند هر کارگزار پراکسی API دیگری در Edge نشان داده می‌شوند.
  • می‌توانند در محصولات دسته‌بندی شوند و با برنامه‌های توسعه‌دهنده مرتبط شوند.
  • داده‌های ترافیک در Edge Analytics نشان داده می‌شود.
  • نمی‌توان آن‌ها را بااستفاده از ابزار Apigee Edge Trace ردیابی کرد.

درباره Edge Microgateway و Apigee Edge Analytics

هم‌زمان با جاری شدن ترافیک API ازطریق Edge Microgateway،‏ Edge Microgateway داده‌های اجرای API را در حافظه میان‌گیر قرار می‌دهد و به‌صورت ناهم‌زمان به Apigee Edge ارسال می‌کند. در Apigee Edge، داده‌ها در سیستم Edge Analytics ذخیره و پردازش می‌شود. این ارتباط ناهم‌زمان به Edge Microgateway اجازه می‌دهد از ویژگی‌های تجزیه‌وتحلیل Edge استفاده کند، درحالی‌که ردپای نسبتاً کوچکی با سربار یا مسدودسازی پردازش حداقلی حفظ می‌کند. مجموعه کامل داشبوردهای «تجزیه‌وتحلیل‌های Edge» و قابلیت‌های گزارش‌دهی سفارشی برای شما و تیمتان دردسترس است تا ترافیکی را که از «درگاه کوچک Edge» عبور می‌کند تجزیه‌وتحلیل کنید.

داشبورد ترافیک پراکسی حجم ترافیک API را درطول زمان، داده‌های تعامل توسعه‌دهنده، و ترکیب ترافیک را براساس برنامه توسعه‌دهنده تفکیک‌شده نشان می‌دهد.
شکل ۵: داشبورد «ترافیک پراکسی» در Edge

برای کسب اطلاعات بیشتر درباره «تجزیه‌وتحلیل لبه‌ای»، به داشبوردهای Analytics مراجعه کنید.

درباره امنیت Edge Microgateway

نقش Apigee Edge

همان‌طور که قبلاً ذکر شد، Apigee Edge در ایمن‌سازی همه درخواست‌های کارخواه به Edge Microgateway نقش دارد. نقش‌های اصلی که Apigee Edge ایفا می‌کند عبارت‌اند از:

  • ارائه اطلاعات اعتباری کارخواه که به‌عنوان کلیدهای میانای برنامه‌سازی کاربردی یا برای تولید نشانه‌های دسترسی معتبر استفاده می‌شود و کارخواه‌ها از آن برای برقراری تماس‌های ایمن با «میانای برنامه‌سازی کاربردی» ازطریق Edge Microgateway استفاده می‌کنند.
  • ارائه اطلاعات اعتباری که Edge Microgateway برای ارسال داده‌های اجرای API به سیستم Apigee Edge Analytics به آن نیاز دارد. این اعتبارنامه‌ها یک‌بار توسط Edge Microgateway درطول مراحل راه‌اندازی اولیه دریافت می‌شوند.
  • ارائه پلاتفرمی برای دسته‌بندی منابع API در محصولات، ثبت و مدیریت توسعه‌دهندگان، و ایجاد و مدیریت برنامه‌های توسعه‌دهنده.

اصالت‌سنجی برنامه کارخواه

‫Edge Microgateway از اصالت‌سنجی کارخواه ازطریق کلیدهای API و رموز دسترسی پشتیبانی می‌کند. کلیدهای امنیتی و نشان‌ها توسط Apigee Edge تولید و توسط Edge Microgateway برای هر فراخوانی API اعتبارسنجی می‌شوند. اگر افزایه OAuth فعال باشد، Edge Microgateway کد دسترسی امضاشده یا کلید API را بررسی می‌کند و اگر معتبر باشد، تماس API به هدف زیرینه ادامه می‌یابد. اگر معتبر نباشد، خطایی برگردانده می‌شود.

برای مراحل لازم برای دریافت و استفاده از نشان‌های دسترسی و کلیدهای میانای برنامه‌سازی کاربردی، به راه‌اندازی و پیکربندی «ریزدروازه Edge» مراجعه کنید.

اصالت‌سنجی Edge Microgateway در Apigee Edge

تماس‌های غیرهم‌زمان که Edge Microgateway برای به‌روزرسانی داده‌های تجزیه‌وتحلیل در Apigee Edge برقرار می‌کند به اصالت‌سنجی نیاز دارد. این اصالت‌سنجی ازطریق جفت کلید عمومی/محرمانه که ازطریق CLI یا بااستفاده از متغیرهای محیطی به Edge Microgateway منتقل می‌شود ارائه می‌شود. این کلیدها را یک‌بار هنگام نصب و راه‌اندازی اولیه Edge Microgateway دریافت و استفاده می‌کنید.

پلاتفرم مدیریت محصول میانای برنامه‌سازی کاربردی

‫Edge به‌عنوان پلاتفرمی برای دسته‌بندی منابع میانای برنامه‌سازی کاربردی در محصولات، ثبت و مدیریت توسعه‌دهندگان، و ایجاد و مدیریت برنامه‌های توسعه‌دهنده عمل می‌کند. برای مثال، همان‌طور که می‌توانید نهادهایی مثل محصولات و برنامه‌های توسعه‌دهنده را برای پراکسی‌های معمولی Apigee Edge ایجاد و دسته‌بندی کنید، می‌توانید دقیقاً همین کار را برای پراکسی‌های Edge Microgateway انجام دهید. امنیت سطح API با تولید کلیدهای امنیتی عمومی و خصوصی برای هر «بسته» امکان‌پذیر می‌شود. این سازوکار با روش عملکرد امنیت API در Apigee Edge یکسان است.

آیا می‌توانم پیاده‌سازی‌های پراکسی Edge موجودم را به Edge Microgateway منتقل کنم؟

نمی‌توانید پراکسی‌های موجود را با خط‌مشی‌های مرتبط یا جریان‌های شرطی به Edge Microgateway انتقال دهید. ‫Edge Microgateway از شما می‌خواهد پراکسی‌های «آگاه از میکروگیت‌وی» جدیدی ایجاد کنید. این کارگزاران باید با پیشوند ویژه‌ای به نام edgemicro_ نام‌گذاری شوند. پس‌از راه‌اندازی، Edge Microgateway این پراکسی‌های edgemicro_* را شناسایی می‌کند و اطلاعات پیکربندی را برای هریک از آن‌ها بارگیری می‌کند. این اطلاعات شامل نشانی‌های وب هدف و مسیرهای منبع آن‌ها می‌شود. از آن نقطه به بعد، از پراکسی‌ها استفاده نمی‌شود. هیچ خط‌مشی یا جریان شرطی در این پراکسی‌ها اجرا نخواهد شد.

دلیل دیگر برای داشتن پراکسی‌های آگاه از ریزدروازه این است که Edge Microgateway داده‌های Analytics را به‌صورت ناهمزمان برای هر پراکسی آگاه از ریزدروازه به Edge ارسال می‌کند. سپس می‌توانید داده‌های تجزیه‌وتحلیل پراکسی‌های آگاه از ریزدروازه را همان‌گونه که برای هر پراکسی دیگری در واسط کاربر Edge Analytics مشاهده می‌کنید، ببینید.

موضوع راه‌اندازی شما را در تمام مراحلی که برای شروع کردن تماس‌های میانای برنامه‌سازی کاربردی ازطریق Edge Microgateway نیاز دارید راهنمایی می‌کند، ازجمله چند مرحله ساده که باید در Apigee Edge برای راه‌اندازی پیکربندی موردنیاز Edge Microgateway انجام دهید، ازجمله ایجاد پراکسی‌های آگاه از میکروگیت‌وی. راه‌اندازی و پیکربندی «دروازه کوچک Edge» را ببینید.

درباره Edge Microgateway بیشتر بدانید

‫Apigee این منابع را ارائه می‌دهد:

  • Edge Microgateway اسناد - اسناد شامل راهنمای نصب و آموزش گام‌به‌گام شروع به کار، و همچنین اطلاعات کامل مرجع و پیکربندی است.

  • ویدیوها - مجموعه ویدیوهای چهار دقیقه‌ای Apigee برای توسعه‌دهندگان شامل مجموعه‌ای از قسمت‌ها درباره Edge Microgateway است.

  • انجمن Apigee جای بسیار خوبی برای پرسیدن سؤال و بهره‌مند شدن از سؤالات پرسیده و پاسخ داده‌شده توسط دیگران است.