‫Google برای ترجمه محتوا به زبان ترجیحی شما از فناوری هوشواره استفاده می‌کند. ترجمه‌های هوشواره‌ای ممکن است اشتباه داشته باشند.

پرسشگان Edge Microgateway

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

درحال شروع کردن

چگونه Edge Microgateway را نصب کنم؟: نصب Edge Microgateway را ببینید.
چگونه Edge Microgateway را اجرا کنم؟: راه‌اندازی و پیکربندی Edge Microgateway را ببینید.
آیا برای اجرای Microgateway به پایگاه داده نیاز دارم؟: ‫APIs که ازطریق Edge Microgateway پراکسی می‌شوند ممکن است با پایگاه داده‌ای که به‌عنوان بخشی از سرویس هدف اجرا می‌شود تعامل داشته باشند. بااین‌حال، Edge Microgateway مستقل از هرگونه پایگاه داده یا فروشگاه داده زیرینه عمل می‌کند.

عملیات

چه تغییراتی در Edge نیاز به بازراه‌اندازی Edge Microgateway دارد؟

‫Edge Microgateway به‌طور خودکار تغییرات ایجادشده در Apigee Edge را نظرسنجی می‌کند، مثل تغییرات در پراکسی‌های آگاه از میکروگیت‌وی، محصولات، یا برنامه‌های توسعه‌دهنده. فاصله نظرسنجی پیش‌فرض ۶۰۰ ثانیه است؛ بااین‌حال، می‌توانید فاصله را با تنظیم پیکربندی config_change_poll_interval تغییر دهید. مشخصه‌های edgemicro را ببینید.

اگر نمی‌خواهید منتظر فاصله زمانی نظرسنجی بمانید، از فرمان edgemicro reload برای دریافت آخرین تغییرات استفاده کنید. مجدد بار کردن خوشه ریزدروازه را ببینید.

چگونه بین پراکسی مستقر در Edge و پراکسی در Edge Microgateway تفاوت قائل شوم؟

وقتی Edge Microgateway را پیکربندی می‌کنید، فهرستی از پراکسی‌های آگاه به میکروگیت‌وی که در Apigee Edge مستقر شده‌اند در پیکربندی محلی Edge Microgateway بارگیری می‌شود. کارگزاران نیابتی آگاه از ریزدروازه کارگزاران نیابتی هستند که با پیشوند edgemicro_ نام‌گذاری شده‌اند.

گزینه‌های من برای گزارش با Edge Microgateway چیست؟

Edge Microgateway دارای ویژگی گزارش‌گیری داخلی است. برای جزئیات بیشتر، به مدیریت فایل‌های گزارش مراجعه کنید.

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

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

تا زمانی که سازمان و محیط برای نمونه‌های Microgateway یکسان باشد، می‌توانید از جفت کلید/رمز که درطول پیکربندی تولید می‌شود دوباره استفاده کنید.

چگونه Edge Microgateway را پیکربندی کنم تا در محیط تولید شروع شود؟

می‌توانید متغیرهای محیطی را برای پارامترهای فرمان راه‌اندازی، مثل EDGEMICRO_KEY، EDGEMICRO_SECRET، EDGEMICRO_ORG، و EDGEMICRO_ENV تنظیم کنید. با این متغیرها (و متغیرهای دیگر) می‌توانید «دروازه میکرو لبه‌ای» را با فرمان واحد edgemicro start شروع کنید. همچنین تنظیم متغیرهای محیطی را ببینید.

آیا می‌توانم از مشخصه‌های سفارشی محصول یا برنامه توسعه‌دهنده با Edge Microgateway استفاده کنم؟

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

مشخصه‌های سفارشی را به پراکسی edgemicro-auth که Edge Microgateway در Apigee Edge مستقر می‌کند اضافه کنید. این مشخصه‌ها هنگام استفاده از امنیت «کلید میانای برنامه‌سازی کاربردی» یا «کد OAuth» دردسترس خواهند بود.
افزایه OAuth را اصلاح کنید تا روی آن مشخصه‌ها عمل کند.

آیا محدودیتی برای اندازه سرایند درخواست وجود دارد؟

اگر Node.js را به v8.14.0 یا نسخه جدیدتری ارتقا دهید، توجه داشته باشید که حداکثر اندازه مجاز سرایند در درخواست‌ها از ۸۰ کیلوبایت به ۸ کیلوبایت کاهش یافته است. سرصفحه‌هایی که از ۸ کیلوبایت فراتر می‌روند منجر به خطای HTTP 431 می‌شوند.

گزینه پیکربندی Node.js که در Node.js نسخه ۱۱.۶.۰ اضافه شده است به شما امکان می‌دهد حداکثر اندازه پیش‌فرض سرایند را تغییر دهید. این پارامتر، --max-http-header-size، به شما امکان می‌دهد حداکثر اندازه سرصفحه‌های HTTP را برحسب بایت مشخص کنید.

برای تغییر پیکربندی پیش‌فرض، مقدار متغیر محیط NODE_OPTIONS را در خط فرمان به‌صورت زیر تنظیم کنید:

NODE_OPTIONS=--max-http-header-size=NUM_BYTES

برای مثال:

NODE_OPTIONS=--max-http-header-size=80000

‫Edge Microgateway از کدام میاناهای برنامه‌سازی کاربردی مدیریت استفاده می‌کند؟

فرمان‌های زیر در Edge Microgateway برای انجام کارشان، همان‌طور که در مرجع خط فرمان برای Edge Microgateway توضیح داده شده است، «میاناهای برنامه‌سازی کاربردی مدیریت Apigee Edge» را فرا می‌خوانند:

edgemicro configure
edgemicro upgradeauth
edgemicro upgradekvm
edgemicro rotatekey
edgemicro cert check
edgemicro cert delete
edgemicro cert install

بخش‌های زیر فهرست تماس‌های «میانای برنامه‌سازی کاربردی مدیریت» را که هر فرمان استفاده می‌کند ارائه می‌دهد.

فرمان‌های edgemicro configure و upgradeauth میاناهای برنامه‌سازی کاربردی مدیریت زیر را فرا می‌خوانند:

(فهرست استقرارها) GET: https://api.enterprise.apigee.com/v1/o/[org]/apis/edgemicro-auth/deployments
(دریافت اطلاعات استقرار) GET: https://api.enterprise.apigee.com/v1/o/[org]/apis/edgemicro-auth
(بارگذاری منابع) POST: https://api.enterprise.apigee.com/v1/o/[org]/apis/edgemicro-auth/revisions/1/resources?type=java&name=micro-gateway-products-javacallout-2.0.0.jar
(بارگذاری منابع) POST: https://api.enterprise.apigee.com/v1/o/[org]/apis/edgemicro-auth/revisions/1/resources?type=jsc&name=adjust-quota.js
(بارگذاری منابع) POST: https://api.enterprise.apigee.com/v1/o/[org]/apis/edgemicro-auth/revisions/1/resources?type=jsc&name=generate-jwk.js
(بارگذاری منابع) POST: https://api.enterprise.apigee.com/v1/o/[org]/apis/edgemicro-auth/revisions/1/resources?type=jsc&name=generate-verify-jwt.js
(بارگذاری منابع) POST: https://api.enterprise.apigee.com/v1/o/[org]/apis/edgemicro-auth/revisions/1/resources?type=jsc&name=jsrsasign-all-min.js
(بارگذاری منابع) POST: https://api.enterprise.apigee.com/v1/o/[org]/apis/edgemicro-auth/revisions/1/resources?type=jsc&name=jwt-initialization.js
(بارگذاری منابع) POST: https://api.enterprise.apigee.com/v1/o/[org]/apis/edgemicro-auth/revisions/1/resources?type=jsc&name=send-jwk-response.js
(بارگذاری منابع) POST: https://api.enterprise.apigee.com/v1/o/[org]/apis/edgemicro-auth/revisions/1/resources?type=jsc&name=send-product-list.js
(بارگذاری منابع) POST: https://api.enterprise.apigee.com/v1/o/[org]/apis/edgemicro-auth/revisions/1/resources?type=jsc&name=send-public-key.js
(بارگذاری منابع) POST: https://api.enterprise.apigee.com/v1/o/[org]/apis/edgemicro-auth/revisions/1/resources?type=jsc&name=set-jwt-variables.js
(بارگذاری منابع) POST: https://api.enterprise.apigee.com/v1/o/[org]/apis/edgemicro-auth/revisions/1/resources?type=jsc&name=set-quota-variables.js
(بارگذاری منابع) POST: https://api.enterprise.apigee.com/v1/o/[org]/apis/edgemicro-auth/revisions/1/resources?type=jsc&name=set-response.js
(بارگذاری منابع) POST: https://api.enterprise.apigee.com/v1/o/[org]/apis/edgemicro-auth/revisions/1/resources?type=jsc&name=validate-params.js
(ایجاد پراکسی میانای برنامه‌سازی کاربردی) POST: https://api.enterprise.apigee.com/v1/o/[org]/apis?action=import&validate=false&name=edgemicro-auth
(خط‌مشی‌های بارگذاری) POST: https://api.enterprise.apigee.com/v1/o/[org]/apis/edgemicro-auth/revisions/1/policies
(بارگذاری پراکسی‌ها) POST: https://api.enterprise.apigee.com/v1/o/[org]/apis/edgemicro-auth/revisions/1/proxies?name=default
(استقرار پراکسی) POST: https://api.enterprise.apigee.com/v1/o/[org]/e/[env]/apis/edgemicro-auth/revisions/1/deployments

فرمان upgradekvm میانای برنامه‌سازی کاربردی مدیریت زیر را فراخوانی می‌کند:

PUT: https://api.enterprise.apigee.com/v1/organizations/[org]/environments/[env]/keyvaluemaps/microgateway

فرمان rotatekey میانای برنامه‌سازی کاربردی مدیریت زیر را فراخوانی می‌کند:

GET: https://api.enterprise.apigee.com/v1/organizations/[org]/environments/[env]/keyvaluemaps/microgateway/entries/private_key

فرمان cert check میانای برنامه‌سازی کاربردی مدیریت زیر را فراخوانی می‌کند:

GET: https://api.enterprise.apigee.com/v1/organizations/[org]/environments/[env]/keyvaluemaps/microgateway

فرمان cert delete میانای برنامه‌سازی کاربردی مدیریت زیر را فراخوانی می‌کند:

DELETE: https://api.enterprise.apigee.com/v1/organizations/[org]/environments/[env]/keyvaluemaps/microgateway

فرمان cert install میانای برنامه‌سازی کاربردی مدیریت زیر را فراخوانی می‌کند:

POST: https://api.enterprise.apigee.com/v1/organizations/[org]/environments/[env]/keyvaluemaps

استقرار

آیا می‌توانم Edge Microgateway را در همان سروری که سرویس هدف من در آن اجرا می‌شود مستقر کنم؟: بله. «درگاه کوچک Edge» فرایندی سبک‌وزن است که می‌تواند نزدیک سرویس هدف شما اجرا شود، ازجمله در همان ماشین.
آیا می‌توانم بسته پراکسی Edge موجود را به‌عنوان استقرار Edge Microgateway مستقر کنم؟: نه. پراکسی‌های آگاه از Edge Microgateway الزامات خاصی دارند و از همه ویژگی‌های پراکسی‌های Edge معمولی پشتیبانی نمی‌کنند. دیدن بخش ۲: ایجاد نهادها در Apigee Edge
آیا می‌توانم برای یک «پراکسی API» یک پیاده‌سازی بسته پراکسی Edge و یک پیاده‌سازی Edge Microgateway را فعال کنم؟: نه. Edge Microgateway از استقرار پراکسی میانای برنامه‌سازی کاربردی غیرمیکروگیت‌وی در Apigee Edge اطلاعی ندارد.
مدل استقرار با دردسترس بودن بالا برای Edge Microgateway چیست؟: برای بحثی خوب درباره نحوه اجرای Edge Microgateway بااستفاده از NGINX به‌عنوان ترازکننده بار، به مدیریت میاناهای برنامه‌سازی کاربردی با Apigee Edge Microgateway و NGINX مراجعه کنید.
از کدام ترازکننده‌های بار می‌توانم با Edge Microgateway استفاده کنم؟: ‫Edge Microgateway می‌تواند با هر ترازکننده بار کاری کار کند.
آیا محدودیتی برای تعداد پراکسی‌های Edge Microgateway که می‌توانم مستقر کنم وجود دارد؟: به محدودیت‌های پیکربندی محصول مشخص‌شده برای پراکسی‌های Edge معمولی مراجعه کنید. تعداد پراکسی‌های آگاه از ریزدروازه که می‌توانید در سازمان و محیط Apigee Edge مستقر کنید و ازطریق Edge Microgateway فراخوانی کنید باید با همان محدودیت‌ها مطابقت داشته باشد.
آیا می‌توانم استقرار Edge Microgateway خود را به یک سازمان و محیط خاص مرتبط کنم؟: وقتی نمونه‌ای از Edge Microgateway را پیکربندی می‌کنید، باید آن را با سازمان و محیط Edge خاصی مرتبط کنید.
آیا می‌توانم استقرار Edge Microgateway خود را به یک منطقه خاص مرتبط کنم (اگر مشتری چندمنطقه‌ای هستم)؟: ‫Edge Microgateway به‌طور خودکار بهترین منطقه را برای تعامل با Apigee Edge انتخاب می‌کند. می‌توانید نمونه‌های Edge Microgateway را در هر منطقه‌ای که می‌خواهید سرویس‌دهی کنید مستقر کنید.

مدیریت

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

عملکرد

ملاحظات عملکردی برای استفاده از Edge Microgateway چیست؟: اگر Edge Microgateway را با برنامه هدف هم‌مکان می‌کنید، مطمئن شوید که سرور ظرفیت کافی داشته باشد.
روال‌های مطلوب برای اجرای Edge Microgateway در مقیاس بزرگ چیست؟: ‫Apigee توصیه می‌کند چندین نمونه از Edge Microgateway را در سرورهای مختلفی که با ترازکننده‌های بار مانند NGINX پیش‌برده می‌شوند اجرا کنید. همچنین مدیریت میاناهای برنامه‌سازی کاربردی با Apigee Edge Microgateway و NGINX و مقیاس‌بندی افقی عمودی در «انجمن Apigee» را ببینید.
«تراکنش در ثانیه» پیش‌فرض «دروازه خرد Edge» چقدر است و الزامات سخت‌افزاری برای نمونه «دروازه خرد» چیست: الزامات سخت‌افزاری و اندازه‌گیری‌های TPS با Edge Microgateway دشوار است. این امر به راه‌اندازی شما بستگی دارد که ترکیبی از تنظیم دقیق Edge Microgateway، استفاده از افزایه، افزایه‌های سفارشی، و پیکربندی موارد دیگر مثل TLS است. Apigee معمولاً توصیه می‌کند که از آن ترکیب موارد ایده بگیرید و با تنظیمات خاص خودتان آزمایش عملکرد انجام دهید.

استقرار «ابر خصوصی»

آیا Edge Microgateway با Edge for Private Cloud کار می‌کند؟: بله. برای جزئیات، مراحل پیکربندی Apigee Private Cloud را ببینید.

افزایه‌ها

سهمیه چگونه با Edge Microgateway اعمال می‌شود؟

می‌توانید افزایه سهمیه را به‌صورت اختیاری به نمونه Edge Microgateway خود اضافه کنید. برای جزئیات، استفاده از افزایه سهمیه را ببینید.

‫Spike Arrest چگونه با Edge Microgateway اجرا می‌شود؟

می‌توانید افزایه مهار جهش را به‌صورت اختیاری به نمونه Edge Microgateway خود اضافه کنید. برای جزئیات، استفاده از افزایه متوقف کردن جهش را ببینید.

آیا روش‌های دیگری برای نوشتن افزایه‌ها به‌جز Node.js برای Edge Microgateway وجود دارد؟

نه. افزایه‌ها باید به زبان Node.js نوشته شوند.

وقتی Edge Microgateway نتواند داده‌های Analytics را در Edge بارگذاری کند چه اتفاقی می‌افتد؟

‫Edge Microgateway دارای بافر درون‌حافظه‌ای است. اگر بافر پر شود، داده‌های قدیمی‌تر حذف می‌شوند تا ترافیک «میانای برنامه‌سازی کاربردی» به‌آرامی جریان یابد.

آیا می‌توانم خط‌مشی‌هایی به Edge Microgateway اضافه کنم؟

اگر خط‌مشی‌های معمولی Apigee Edge را به پراکسی‌های microgateway-aware در Apigee Edge پیوست کنید، نادیده گرفته می‌شوند. درعوض، Edge Microgateway از افزایه‌ها برای ارائه عملکردی مشابه خط‌مشی‌های Edge، مانند سهمیه، جلوگیری از جهش، امنیت کلید API، و امنیت OAuth2 استفاده می‌کند. همچنین می‌توانید افزایه‌های سفارشی بنویسید. به استفاده از افزایه‌ها و توسعه افزایه‌های سفارشی مراجعه کنید.

پست‌ها و وبلاگ‌های «انجمن Apigee» زیر درباره موارد استفاده افزایشی افزایه بحث می‌کنند:

امنیت

چگونه از منبع /products محافظت کنم؟

توجه: اگر Edge Microgateway را در تاریخ ۵ اکتبر ۲۰۱۸ یا قبل‌از آن نصب کرده‌اید، Apigee توصیه می‌کند مراحل این بخش را برای محافظت از نقطه پایانی /products کارگزار edgemicro-auth انجام دهید.

نمای کلی

وقتی Edge Microgateway را پیکربندی می‌کنید، کارگزار API به‌نام edgemicro-auth در سازمان:محیط شما در Apigee Edge مستقر می‌شود. این پراکسی نقطه پایانی /products را آشکار می‌کند که فهرست «محصولات API» را برمی‌گرداند. اگر Edge Microgateway را در تاریخ ۵ اکتبر ۲۰۱۸ یا قبل‌از آن نصب کرده‌اید، Apigee توصیه می‌کند برای محافظت از این نقطه پایانی اقدام کنید، زیرا پاسخ حاوی نشانی ایمیل توسعه‌دهنده‌ای است که «محصولات API» را در سازمان Apigee شما ایجاد و اصلاح کرده است.

با ارتقا دادن Edge Microgateway یا پیکربندی «امنیت لایه انتقال» دوطرفه می‌توانید از نقطه پایانی محافظت کنید. هر دو این گزینه‌ها در زیر توضیح داده شده است.

بررسی کنید که آیا نقطه پایانی /products محافظت می‌شود یا نه

اگر مطمئن نیستید که نقطه پایانی /products محافظت می‌شود یا نه، به بخش تأیید کنید که منبع /products محافظت می‌شود بروید و مراحل آنجا را قبل‌از ادامه دادن انجام دهید.

گزینه ۱: ارتقا دادن Edge Microgateway

اگر Edge Microgateway را در تاریخ ۵ اکتبر ۲۰۱۸ یا قبل‌از آن نصب کرده‌اید، Apigee توصیه می‌کند به جدیدترین نسخه Edge Microgateway ارتقا دهید. مراحل ارتقا دادن Edge Microgateway درصورت داشتن اتصال اینترنت را دنبال کنید.

اگر درحال‌حاضر نمی‌توانید ارتقا دهید، به «گزینه ۲» بروید.

گزینه ۲: پیکربندی «امنیت لایه انتقال دوطرفه»

اگر درحال‌حاضر نمی‌توانید Edge Microgateway را ارتقا دهید، Apigee توصیه می‌کند ارتباط بین Edge Microgateway و پراکسی edgemicro-auth را با «امنیت لایه انتقال» دوطرفه (که به‌عنوان «امنیت لایه انتقال» دوطرفه نیز شناخته می‌شود) محافظت کنید.

فایل $HOME/.edgemicro/org-env-config.yaml را باز کنید. اگر نمی‌توانید این فایل را پیدا کنید، Edge Microgateway کجا نصب شده است را ببینید.
بلوک tlsOptions زیر را به فایل org-env-config.yaml اضافه کنید تا «امنیت لایه انتقال» دوطرفه بین «درگاه کوچک Edge» و Apigee Edge فعال شود:
توجه: باید requestCert را روی true تنظیم کنید تا این دارایی فعال شود.
```
edge_config:
  bootstrap: >-
    https://domain/edgemicro/bootstrap/organization/org/environment/env
  jwt_public_key: 'https://domain/edgemicro-auth/publicKey'
  managementUri: 'https://api.enterprise.apigee.com'
  tlsOptions:
    agentOptions:
      requestCert: true
      cert: 'path/to/cert'
      key: 'path/to/key'
```
برای مثال:
```
tlsOptions:
  agentOptions:
    requestCert: true
    cert: '/Users/jdoe/twowayssl/ssl/client.key'
    key: '/Users/jdoe/twowayssl/ssl/ca.crt'
```
همچنین می‌توانید پارامترهای اختیاری agentOptions زیر را اضافه کنید:
- ‫ca: مسیر مرجع گواهینامه را مشخص می‌کند.
- pfx: اگر می‌خواهید به‌جای گواهینامه و کلید از فایل p12/pfx استفاده کنید، آن را اضافه کنید.
- passphrase: عبارت عبور برای فایل pfx.
- ciphers: رمزهای «امنیت لایه انتقال» را مشخص می‌کند.
مطمئن شوید میزبان مجازی که پراکسی edgemicro-auth در آن مستقر شده است، «امنیت لایه انتقال دوطرفه» را فعال کرده باشد. برای جزئیات، به تعریف میزبان مجازی برای TLS دوطرفه در اسناد Apigee Edge مراجعه کنید.
نماگرفت زیر نحوه فعال کردن TLS دوطرفه را در میزبان مجازی در «میانای کاربر Apigee Edge» نشان می‌دهد:
به پراکسی میانای برنامه‌سازی کاربردی edgemicro-auth در «واسط کاربر Edge» نگاه کنید و مطمئن شوید که میزبان مجازی صحیح در پیکربندی پراکسی مشخص شده است. برای مثال، اگر میزبان مجازی با قابلیت TLS به‌نام mutualtls ایجاد کرده‌اید، بخش HTTPProxyConnection کارگزار باید به این شکل باشد:
```
<HTTPProxyConnection>
    <BasePath>/edgemicro-auth</BasePath>
    <Properties/>
    <VirtualHost>mutualtls</VirtualHost>
</HTTPProxyConnection>
```

تأیید کنید که منبع /products محافظت می‌شود

این بخش توضیح می‌دهد که چگونه آزمایش کنید تا بررسی کنید آیا منبع /products محافظت می‌شود یا نه. مهم است که این آزمایش را پس‌از تکمیل مراحل (گزینه ۱ یا گزینه ۲) برای محافظت از منبع انجام دهید. برای مثال، می‌توانید این کار را با cURL انجام دهید:

curl -v https://your_domain/edgemicro-auth/products

اگر پاسخی مانند یکی از موارد زیر مشاهده کردید، نقطه پایانی /products محافظت‌شده است:

{
  "error":"unauthorized",
  "error_description": "authentication failed"
}

یا

curl: (35) error:1408F10B:SSL routines:ssl3_get_record:wrong version number

اگر پاسخی شبیه به این دیدید، یعنی منبع /products محافظت‌نشده است و ایمیل‌های توسعه‌دهنده می‌تواند فاش شود:

{
   "apiProduct":[
      {
         "apiResources":[
            "/",
            "/**"
         ],
         "approvalType":"auto",
         "attributes":[

         ],
         "createdAt":1537374680948,
         "createdBy":"jdoe@foo.com",
         "description":"",
         "displayName":"mock",
         "environments":[
            "test"
         ],
         "lastModifiedAt":1537374680948,
         "lastModifiedBy":"test@test.com",
         "name":"mock",
         "proxies":[
            "edgemicro-auth",
            "edgemicro_mock"
         ],
         "quota":"null",
         "quotaInterval":"null",
         "quotaTimeUnit":"null",
         "scopes":[
            ""
         ]
      }
   ]
}

‫Apigee همچنین توصیه می‌کند که میزبان مجازی HTTP را آزمایش کنید:

برای مثال:

curl -v http://your_domain/edgemicro-auth/products

اگر فراخوانی cURL فهرست «محصولات API» را برگرداند، احتمال دارد ایمیل‌های توسعه‌دهنده نمایان شده باشد. اگر نمی‌خواهید نقطه پایانی را با این میزبان مجازی غیر TLS نمایان کنید، حتماً آن را از پیکربندی edgemicro-auth HTTPProxyConnection بردارید.

برای محافظت از منبع، یکی از گزینه‌های زیر را انجام دهید:

گزینه ۱: ارتقا دادن Edge Microgateway.
گزینه ۲: پیکربندی «امنیت لایه انتقال دوطرفه».

چگونه می‌توانم کد دسترسی منقضی‌شده را تمدید کنم؟

درحال‌حاضر نمی‌توانید نشان JWT را برای نمونه Edge Microgateway معینی تمدید کنید.

راهکار موقت:

هر کد JWT دارای یک ویژگی exp است که تاریخ انقضای کد را مشخص می‌کند. برنامه می‌تواند با فراخوانی مستقیم API به نقطه پایانی کد edgemicro-auth، زمان انقضا را محاسبه کند و کد جدیدی درخواست کند. برای مثال، می‌توانید فراخوان میانای برنامه‌سازی کاربردی را به‌این‌صورت انجام دهید:

POST https: //{your_org}-{your_env}.apigee.net/edgemicro-auth/token

… با بدنه JSON مانند این:

{ "client_id": {your_id}, "client_secret": {your_secret}, "grant_type": "client_credentials" }

همچنین از اینجا دیدن کنید:

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

پیکربندی SSL در Windows

اگر Edge Microgateway را در Windows اجرا می‌کنید، OpenSSL باید در ماشین نصب شود و به PATH اضافه شود. همه دستگاه‌های Windows با OpenSSL ارسال نمی‌شوند. برای کسب اطلاعات درباره بارگیری و نصب OpenSSL، به اسناد OpenSSL مراجعه کنید.

آیا می‌توانم بااستفاده از محصول API مرتبط با پراکسی Edge Micro-aware دسترسی به منابع API را مجاز کنم؟

درحال‌حاضر، فقط مسیر پایه بررسی می‌شود تا مشخص شود که آیا یک «میانای برنامه‌سازی کاربردی» برای «محصولات میانای برنامه‌سازی کاربردی» مرتبط با یک کد OAuth خاص تأیید شده است یا خیر.

برای مثال:

پراکسی پیشوندی edgemicro_ را با مسیر پایه و هدف ایجاد می‌کنید.
این پراکسی را به محصولی اضافه می‌کنید. بیایید آن را edgemicro-prod1 بنامیم.
وقتی فراخوانی میانای برنامه‌سازی کاربردی ازطریق Edge Microgateway بااستفاده از کلید میانای برنامه‌سازی کاربردی یا کد OAuth انجام می‌شود، Edge Microgateway بررسی می‌کند که آیا مسیر پایه میانای برنامه‌سازی کاربردی با مسیر پایه پراکسی edgemicro_* که برای فهرست محصولات تأییدشده برای آن کلید یا کد تأیید شده است مطابقت دارد یا نه.

همچنین هنگام استفاده از دروازه edgemicro در محصولاتی که نشانی وب آن‌ها باید در محصولات استفاده‌شده در منابع فهرست سفید شود؟ در «انجمن Apigee» را ببینید.

آیا می‌توانم از گواهینامه‌های SSL سفارشی با Edge Microgateway استفاده کنم؟

درحال‌حاضر فقط از گواهینامه SSL پیش‌فرض Apigee پشتیبانی می‌شود. درحال‌حاضر از گواهینامه‌های SSL سفارشی پشتیبانی نمی‌شود.

راهکارهای موقت:

اگر می‌خواهید از گواهینامه SSL سفارشی (غیرپیش‌فرض Apigee) استفاده کنید، این گزینه‌ها را دارید:

از نقطه پایانی jwt_public_key غیر SSL استفاده کنید. فایل پیکربندی Edge Microgateway را برای استفاده از http://{org}-{env}.apigee.net/edgemicro-auth/publicKey تغییر دهید -یا-
قبل‌از شروع Edge Microgateway، این متغیر محیطی را تنظیم کنید: export NODE_TLS_REJECT_UNAUTHORIZED ="0"

توجه: همچنین مطمئن شوید که از نسخه پشتیبانی‌شده Node.js برای نسخه Edge Microgateway خود استفاده می‌کنید. در سند «نصب» برای Edge Microgateway، پیش‌نیازها را ببینید.

همچنین خطاهای نصب Edge Micro در گواهینامه SSL را در انجمن Apigee تأیید کنید را ببینید.

آیا می‌توانم از حساب‌های «سرپرست سازمان» با Edge Microgateway استفاده نکنم؟

برنامه پیکربندی Edge Microgateway یک پراکسی edgemicro-auth را در Edge مستقر می‌کند و این استقرار به اعتبارنامه‌های «سرپرست سازمان» نیاز دارد.

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

آیا می‌توانم از کد OAuth خود با Edge Microgateway استفاده کنم؟

می‌توانید از کد خودتان استفاده کنید، اما ابتدا باید مجوز داخلی را برای Edge Microgateway خاموش کنید. برای انجام این کار:

فایل پیکربندی Edge Microgateway را باز کنید.
دو تنظیم oauth را به درست تغییر دهید، به این صورت:
```
oauth:
    allowNoAuthorization: true
    allowInvalidAuthorization: true
```

هنگام شروع Edge Microgateway، خطای دسترسی رد شد دریافت می‌کنم

اگر هنگام شروع Edge Microgateway با این فرمان خطای «دسترسی رد شد» دریافت کردید:

edgemicro start -o [org] -e [env] -k [key] -s [secret]

ممکن است کلید و رمز به‌دلایلی معتبر نباشند. بهترین کار این است که کلید و رمز را با فرمان edgemicro genkeys بازتولید کنید.

آزمایش و اشکال‌زدایی

چگونه از خطاهای «فایل‌های باز بسیار زیاد» درطول آزمایش بار جلوگیری کنم؟

در برخی موارد، ممکن است سیستم شما با وضعیتی مواجه شود که اتصالات فایل باز بیش‌ازحد زیاد باشد، و این می‌تواند باعث ازکارافتادن Edge Micro شود. گزارش‌گیری پیش‌فرض برای تراکنش‌های ورودی و خروجی ازطریق Microgateway به دو اتصال HTTP نیاز دارد.

برای اهداف آزمایش و محک‌زنی، Apigee توصیه می‌کند فرمان ulimit سیستم خود را روی نامحدود تنظیم کنید: ulimit -n unlimited. همچنین خطای Edge Microgateway درطول آزمایش بار در «انجمن Apigee» را ببینید.

نکته‌هایی برای توسعه و اشکال‌زدایی سریع

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

فعلاً چند نکته در اینجا آمده است:

برای شروع Edge Microgateway، می‌توانید متغیرهای محیطی EDGEMICRO_KEY و EDGEMICRO_SECRET را روی جفت کلید/رمز موردنیاز فرمان راه‌اندازی Microgateway تنظیم کنید. با این کار می‌توانید Edge Microgateway را بدون وارد کردن کلید/رمز در خط فرمان شروع کنید. همچنین تنظیم متغیرهای محیطی را در اسناد Edge Microgateway ببینید.
‫Edge Microgateway را در حالت «اشکال‌زدایی» شروع کنید تا برونداد اضافی را در پایانه فرمان ببینید: DEBUG=* edgemicro start -o [org] -e [env] -k [key] -s [secret]

کسب‌وکار و پروانه

رابطه بین Apigee-127 و مدل‌های پشتیبانی Edge Microgateway چیست؟

‫Apigee-127 یک پروژه نرم‌افزار متن‌باز است که در مدل متن‌باز پشتیبانی می‌شود. یعنی می‌توانید در پروژه GitHub مشکلاتی را مطرح کنید و اگر بخواهید چیزی را اصلاح کنید، درخواست کشش ایجاد کنید. ‫Apigee-127 هیچ‌گونه «قرارداد پروانه نرم‌افزار» با Apigee را الزامی نمی‌داند یا شامل نمی‌شود.

از سوی دیگر، Edge Microgateway محصولی «سازمانی» است که Apigee برای مشتریان Apigee پشتیبانی می‌کند. یعنی مشتریان Apigee می‌توانند بااستفاده از پشتیبانی Apigee Edge در Google Cloud، درخواست‌های ویژگی و گزارش‌های اشکال ایجاد کنند.

توجه: Edge Microgateway به‌هیچ‌وجه براساس Apigee-127 نیست. پروژه‌های کاملاً متفاوتی با اهداف متفاوت هستند. تنها شباهت این است که هر دو در Node.js پیاده‌سازی شده‌اند. نباید هیچ وجه مشترک دیگری را فرض کنید.