درحال مشاهده اسناد Apigee Edge هستید.
به
اسناد Apigee X بروید. اطلاعات
Edge Microgateway نسخه ۲.۴.x
مخاطبان
این موضوع مقدمه‌ای کلی بر Edge Microgateway است که برای همه مخاطبان درنظر گرفته شده است.
Apigee Edge Microgateway چیست؟
Apigee Edge Microgateway یک پردازشگر پیام مبتنی بر HTTP و ایمن برای «میاناهای برنامه‌سازی کاربردی» است. وظیفه اصلی آن پردازش ایمن درخواست‌ها و پاسخ‌ها به و از سرویس‌های زیرینه به‌صورت ناهمزمان و ارسال داده‌های ارزشمند اجرای میانای برنامه‌سازی کاربردی به Apigee Edge است، جایی که سیستم Edge Analytics از آن استفاده می‌کند. نصب و استقرار Edge Microgateway آسان است -- می‌توانید نمونه‌ای را در چند دقیقه راه‌اندازی کنید.
معمولاً Edge Microgateway در شبکه مطمئنی در نزدیکی سرویس‌های هدف زیرینه نصب می‌شود. این محصول امنیت در سطح سازمانی و برخی‌از ویژگی‌های کلیدی افزایه مانند مهار جهش، سهمیه، و تجزیه‌وتحلیل را ارائه می‌دهد، اما قابلیت‌ها یا ردپای کامل Apigee Edge را ارائه نمی‌دهد. درصورت تمایل می‌توانید Edge Microgateway را در همان مرکز داده یا حتی در همان ماشین سرویس‌های زیرینه خود نصب کنید.
موارد استفاده اصلی
موارد استفاده معمول برای راهکار مدیریت Cloud API ترکیبی مانند Edge Microgateway شامل موارد زیر است:
-
تأخیر ترافیک «میانای برنامه‌سازی کاربردی» را برای سرویس‌هایی که در مجاورت هم اجرا می‌شوند کاهش دهید. برای مثال، اگر مصرف‌کنندگان و تولیدکنندگان میانای برنامه‌سازی کاربردی شما در مجاورت یکدیگر باشند، لزوماً نمی‌خواهید میاناهای برنامه‌سازی کاربردی از یک دروازه مرکزی عبور کنند.
- ترافیک «میانای برنامه‌سازی کاربردی» را برای اهداف امنیتی یا رعایت استانداردها در محدوده تأییدشده سازمانی نگه دارید.
- اگر اتصال اینترنت موقتاً قطع شد، پردازش پیام‌ها ادامه می‌یابد.
- همچنین این بحث مورد استفاده در انجمن 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 را با زیرساخت و فرایندهای پایش و مدیریت برنامه موجودتان یکپارچه کنید.
- ساده. نصب، پیکربندی، و نگهداری آن ساده است.
- درحال ثبت. فایل‌های گزارش همه رویدادهای عادی و استثنایی را که درطول پردازش API توسط Edge Microgateway با آن‌ها مواجه شده است به‌تفصیل شرح می‌دهد.
- CLI. میانای خط فرمان به شما امکان می‌دهد Microgateway Edge را شروع، متوقف، و بازراه‌اندازی کنید، آمار عملکرد را استخراج کنید، فایل‌های گزارش را مشاهده کنید، نشان‌های دسترسی را درخواست کنید، و کارهای دیگری انجام دهید.
آنچه باید درباره 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 Microgateway، و پیاده‌سازی‌های API پشتیبان HTTP است، می‌توانید Apigee Edge Microgateway را روی دستگاهی متفاوت از پیاده‌سازی API نصب کنید، همان‌طور که در «شکل ۲» نشان داده شده است.
شکل ۲: Edge Microgateway جدا از میاناهای برنامه‌سازی کاربردی هدف زیرینه
پراکسی کردن چند برنامه
از یک نمونه Edge Microgateway می‌توان برای پشتیبانی از چندین برنامه هدف پس‌زمینه استفاده کرد، همان‌طور که در «شکل ۳» نشان داده شده است.
شکل ۳: Edge Microgateway می‌تواند چندین پراکسی API را در جلو قرار دهد
با ترازکننده بار
خود Edge Microgateway می‌تواند با یک پراکسی معکوس استاندارد یا ترازکننده بار برای پایان دادن به SSL و/یا تراز کردن بار، همان‌طور که در «شکل ۴» نشان داده شده است، پیش‌کار شود.
شکل ۴: اجرای Edge Microgateway با ترازکننده بار
استقرار اینترانت
از Edge Microgateway برای محافظت از ترافیک اینترانت و از Apigee Edge برای محافظت از ترافیک اینترنت استفاده کنید، همان‌طور که در «شکل ۵» نشان داده شده است. فرض کنیم نقطه پایانی API /orders ازطریق Apigee Edge Cloud پراکسی شود و به هدف زیرینه https://mycompany.com/orders برسد. این با پیاده‌سازی میانای برنامه‌سازی کاربردی هدف در سمت راست نشان داده می‌شود. این «میانای برنامه‌سازی کاربردی» سپس می‌تواند چندین نقطه پایانی «میانای برنامه‌سازی کاربردی» را که با پیاده‌سازی هدف در سمت راست نشان داده شده است فراخوانی کند. برای مثال، ممکن است به‌صورت داخلی /customers و
/transactions را فراخوانی کند. همچنین
این پست را در «انجمن Apigee» ببینید.
شکل ۵: اجرای Edge Microgateway برای محافظت از ترافیک اینترانت
وابستگی به Apigee Edge
Edge Microgateway به Apigee Edge وابسته است و با آن تعامل دارد. Edge Microgateway باید برای کار کردن با Apigee Edge ارتباط برقرار کند. روش‌های اصلی که Edge Microgateway با Edge تعامل می‌کند عبارت‌اند از:
- پس‌از راه‌اندازی، Edge Microgateway فهرستی از پراکسی‌های ویژه «آگاه از Edge Microgateway» و فهرستی از همه محصولات سازمان Apigee Edge شما را دریافت می‌کند. برای هر درخواست ورودی مشتری، «ریزدروازه Edge» تعیین می‌کند که آیا درخواست با یکی از این پراکسی‌های API مطابقت دارد یا نه و سپس کد دسترسی ورودی یا کلید API را براساس کلیدهای محصول مرتبط با آن پراکسی اعتبارسنجی می‌کند.
- سیستم Apigee Edge Analytics داده‌های API را که به‌صورت ناهمزمان از Edge Microgateway ارسال شده است ذخیره و پردازش می‌کند.
- Apigee Edge اطلاعات اعتباری‌ای را که برای امضا کردن نشانه‌های دسترسی استفاده می‌شود یا کلیدهای میانای برنامه‌سازی کاربردی‌ای را که کارخواهانی که ازطریق Edge Microgateway تماس با «میانای برنامه‌سازی کاربردی» برقرار می‌کنند به آن‌ها نیاز دارند ارائه می‌دهد. می‌توانید این نشان‌ها را بااستفاده از فرمان CLI دریافت کنید.
پیکربندی یک‌باره
ابتدا باید 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 را بااستفاده از دستور CLI مناسب توضیح می‌دهد.
آنچه باید درباره پراکسی‌های آگاه از 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 را نمی‌توان در «ویرایشگر کارگزار نیابتی» در واسط کاربر مدیریت Apigee Edge ویرایش کرد. یعنی نمی‌توانید خط‌مشی اضافه کنید یا جاری‌سازی‌های شرطی اضافه کنید. (یا اگر تلاش کنید، نادیده گرفته می‌شوند.)
- درغیراین‌صورت، پراکسی‌های Edge Microgateway در «واسط کاربر مدیریت Edge» مانند هر پراکسی API دیگری در Edge نشان داده می‌شود.
- مانند هر پراکسی API در Edge، پراکسی‌های Edge Microgateway می‌توانند در محصولات دسته‌بندی شوند و با برنامه‌های توسعه‌دهنده مرتبط شوند.
- مانند هر پراکسی دیگری، می‌توانید تجزیه‌وتحلیل پراکسی Edge Microgateway را پیگیری کنید.
- کارگزاران نیابتی Edge Microgateway را نمی‌توان بااستفاده از ابزار 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» عبور می‌کند تجزیه‌وتحلیل کنید.
شکل ۶: داشبورد «ترافیک پراکسی» در Edge
برای کسب اطلاعات بیشتر درباره «تجزیه‌وتحلیل لبه‌ای»، به داشبوردهای Analytics مراجعه کنید.
درباره امنیت Edge Microgateway
نقش Apigee Edge
همان‌طور که قبلاً ذکر شد، Apigee Edge در ایمن‌سازی همه درخواست‌های کارخواه به Edge Microgateway نقش دارد. نقش‌های اصلی که Apigee Edge ایفا می‌کند عبارت‌اند از:
- ارائه اطلاعات اعتباری کارخواه که به‌عنوان کلیدهای میانای برنامه‌سازی کاربردی یا برای تولید نشانه‌های دسترسی معتبر استفاده می‌شود و کارخواه‌ها از آن برای برقراری تماس‌های ایمن با «میانای برنامه‌سازی کاربردی» ازطریق Edge Microgateway استفاده می‌کنند.
- ارائه اطلاعات اعتباری که Edge Microgateway برای ارسال داده‌های اجرای API به سیستم Apigee Edge Analytics به آن نیاز دارد. این اعتبارنامه‌ها یک‌بار توسط Edge Microgateway درطول مراحل راه‌اندازی اولیه دریافت می‌شوند. (برای مراحل دقیق، راه‌اندازی و پیکربندی Edge Microgateway را ببینید.)
- ارائه پلاتفرمی برای دسته‌بندی منابع API در محصولات، ثبت و مدیریت توسعه‌دهندگان، و ایجاد و مدیریت برنامه‌های توسعه‌دهنده.
اصالت‌سنجی برنامه کارخواه
- Edge Microgateway از اصالت‌سنجی کارخواه ازطریق کلیدهای API و رموز دسترسی پشتیبانی می‌کند. کلیدهای امنیتی و نشان‌ها توسط Apigee Edge تولید و توسط Edge Microgateway برای هر فراخوانی API اعتبارسنجی می‌شوند.
- اگر افزایه oauth فعال باشد، Edge Microgateway کد دسترسی امضاشده یا کلید API را بررسی می‌کند و اگر معتبر باشد، تماس API به هدف زیرینه ادامه می‌یابد. اگر معتبر نباشد، خطایی برگردانده می‌شود.
- برای مراحل لازم برای دریافت و استفاده از نشان‌های دسترسی، به راه‌اندازی و پیکربندی Edge Microgateway مراجعه کنید. برای کسب اطلاعات درباره کلیدهای API، به «استفاده از امنیت کلید API» در مرجع عملیات و پیکربندی برای Edge Microgateway مراجعه کنید.
اصالت‌سنجی 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 Microgateway را ببینید.
آیا می‌توانم از خط‌مشی‌ها با پراکسی‌های Edge Microgateway استفاده کنم؟
همان‌طور که در بخش قبلی توضیح داده شد، نمی‌توانید خط‌مشی‌ها را به پراکسی‌های «آگاه از دروازه کوچک» در Apigee Edge پیوست کنید. Edge Microgateway از افزایه‌ها برای ارائه عملکردی مشابه با خط‌مشی‌های Edge، مانند سهمیه، جلوگیری از جهش، امنیت کلید API، و امنیت OAuth2 استفاده می‌کند. استفاده از افزونه‌ها را ببینید. همچنین می‌توانید افزایه‌های سفارشی بنویسید، همان‌طور که در توسعه افزایه‌های سفارشی توضیح داده شده است.
بهترین راه برای آشنایی با Edge Microgateway چیست؟
Apigee این منابع را ارائه می‌دهد:
-
Edge Microgateway اسناد - اسناد شامل آموزش گام‌به‌گام شروع کار و همچنین اطلاعات کامل مرجع و پیکربندی است.
-
وبینار تخصصی - درباره Edge Microgateway به‌طور مفصل بحث می‌کند و نحوه راه‌اندازی و پیکربندی Edge Microgateway را نشان می‌دهد.
-
تالار گفتمان Edge Micro - تالار گفتمان Edge Micro در انجمن Apigee مکانی عالی برای پرسیدن سؤال و بهره‌مندی از سؤالات پرسیده و پاسخ داده‌شده توسط دیگران است.