درحال مشاهده اسناد Apigee Edge هستید.
به
اسناد Apigee X بروید. اطلاعات
می‌توانید جریان‌های مشترک را برای انجام پیش‌پردازش درخواست‌های کلیشه‌ای یا پس‌پردازش پاسخ در مجموعه‌ای از میاناهای برنامه‌سازی کاربردی داشته باشید. با قلاب جاری‌سازی، جاری‌سازی مشترکی را پیوست می‌کنید تا در همان مکان برای همه پراکسی‌های API که در محیطی خاص مستقر شده‌اند اجرا شود. این به شما دنباله‌ای از منطق را می‌دهد که به‌طور جداگانه پیاده‌سازی و مستقر شده است و بخشی از کد پیاده‌سازی کارگزار نیست.
ازآنجایی‌که کد پیوست‌شده به قلاب جاری‌سازی خارج از زمینه منطق اصلی پراکسی API است، برخی‌از عملکردهای آن با پراکسی‌های API متفاوت است. موارد زیر را به یاد داشته باشید:
- برای پیوست کردن یک جریان مشترک به قلاب جریان باید اجازه داشته باشید. باید سرپرست سازمان باشید.
- فقط می‌توانید یک جاری‌سازی مشترک را به هر قلاب جاری‌سازی پیوست کنید.
- می‌توانید همان جاری‌سازی هم‌رسانی‌شده را به چندین قلاب جاری‌سازی پیوست کنید.
- اگر جریان مشترک پیوست‌شده به قلاب جریان خطا ایجاد کند یا درطول اجرای جریان مشترک خطا وجود داشته باشد، پیام رد خواهد شد و خطا به تماس‌گیرنده برگردانده خواهد شد.
- اگر پیامی درحین اجرای قلاب جریان رد شود، جزئیات در Analytics در زمینه پراکسی فراخوانده‌شده ثبت خواهد شد. جریان مشترک همچنین می‌تواند با کد سفارشی و پیام خطا، خطا ایجاد کند
ویدیو زیر نحوه اتصال یک جریان مشترک به یک قلاب جریان و سپس ردیابی آن را در واسط کاربر Classic Edge نشان می‌دهد.
ویدیو زیر نحوه اتصال یک جریان مشترک به یک قلاب جریان و سپس ردیابی آن را در واسط کاربر تجربه New Edge نشان می‌دهد.
جریان مشترکی که ازطریق قلاب جریان به یک کارگزار پروکسی متصل شده است، مکان مناسبی برای منطقی است که الزامات خط‌مشی گسترده را اعمال می‌کند. برای مثال، تصور کنید که یک تیم دارید که مجموعه واحدی از الزامات امنیتی را برای چندین تیم که نماینده خطوط کسب‌وکار مختلف (LOB) هستند مدیریت می‌کند. هر تیم LOB می‌تواند براساس الزامات خود و بدون نیاز به درنظر گرفتن الزامات امنیتی گسترده‌تر، «میاناهای برنامه‌سازی کاربردی» توسعه دهد. تیم امنیتی می‌تواند آن الزامات امنیتی را در یک جریان مشترک پیاده‌سازی کند، سپس جریان را بااستفاده از قلاب جریان به محیط Apigee Edge پیوست کند. چون جاری‌سازی مشترک بخشی از کد کارگزار نیست، تیم امنیتی می‌تواند آن را درصورت نیاز بدون تداخل با کد LOB اصلاح کند.
جریان‌های مشترک پیوست‌شده ازطریق قلاب‌های جریان در آن موقعیت برای هر پراکسی API مستقرشده در محیط قلاب پراکسی اجرا می‌شوند. به همین دلیل، امکان استفاده از قلاب‌های جریان فقط برای مدیران سازمان Apigee Edge دردسترس است.
برای اطلاعات بیشتر درباره جاری‌سازی‌های مشترک، جاری‌سازی‌های مشترک قابل‌استفاده مجدد را ببینید.
جریان مشترک را بااستفاده از کنسول مدیریت Apigee Edge به قلاب جریان پیوست می‌کنید. می‌توانید حداکثر یک جاری‌سازی هم‌رسانی‌شده را در هریک از مکان‌های زیر به قلاب جاری‌سازی پیوست کنید:
-
قلاب جریان پیش‌کارگزار برای منطقی که باید قبل‌از اجرای نقطه پایانی کارگزار اعمال شود.
برای مثال، می‌توانید منطقی برای اعمال امنیت در همه میاناهای برنامه‌سازی کاربردی در یک محیط داشته باشید.
-
قلاب جریان پیش‌هدف برای منطقی که باید پیش‌از فراخوانی هدف اجرا شود.
برای مثال، می‌توانید گزارش‌گیری را قبل‌از اینکه درخواست به زیرینه برسد پیاده‌سازی کنید. همچنین می‌توانید با برداشتن فیلدهای خاصی از درخواست، میانجی‌گری را اجباری کنید.
-
قلاب جاری‌سازی پس‌هدف برای منطقی که باید پس‌از اجرای پاسخ هدف اعمال شود.
این کار بلافاصله پس‌از دریافت پاسخ از زیرینه اعمال خواهد شد. می‌توانید از آن برای ثبت پاسخ زیرینه یا انجام برخی‌از میانجی‌گری‌ها با برداشتن فیلدهای حساس از پاسخ زیرینه استفاده کنید.
-
قلاب جریان پس‌از پراکسی برای منطقی که باید پس‌از نقطه پایانی پراکسی و
درست قبل‌از ارسال پاسخ به مشتری اعمال شود.
این می‌تواند شامل برخی‌از منطق‌های اجرایی برای CORS، ثبت پاسخ، یا انجام برخی‌از ترکیب‌ها یا قالب‌بندی‌ها باشد.
پیوست کردن جاری‌سازی مشترک به قلاب جاری‌سازی
برای پیوست کردن جاری‌سازی هم‌رسانی‌شده به قلاب جاری‌سازی، باید در سازمانی که جاری‌سازی هم‌رسانی‌شده در آن قرار دارد سرپرست باشید.
- به صفحه «قلاب‌های جریان» طبق توضیحات زیر دسترسی پیدا کنید.
Edge
برای دسترسی به صفحه «قلاب‌های جریان» بااستفاده از «واسط کاربر Edge»:
- به سیستم apigee.com/edge وارد شوید.
- سازمانی را که حاوی جریان هم‌رسانی‌شده شما است انتخاب کنید. به جابه‌جایی بین سازمان‌ها مراجعه کنید.
جریان مشترک برای همه پراکسی‌های API و جریان‌های مشترکی که در محیطی از این سازمان مستقر شده‌اند دردسترس خواهد بود. از خارج این سازمان دردسترس نخواهد بود.
- در نوار پیمایش سمت راست، سرپرست > محیط‌ها > قلاب‌های جریان را انتخاب کنید.
Classic Edge (ابر خصوصی)
برای دسترسی به صفحه «قلاب‌های جریان» بااستفاده از «واسط کاربر Classic Edge»:
- به سیستم
http://ms-ip:9000وارد شوید، که در آن ms-ip نشانی IP یا نام ساناد گره «سرور مدیریت» است. - سازمانی را که حاوی جریان هم‌رسانی‌شده شما است انتخاب کنید. به جابه‌جایی بین سازمان‌ها مراجعه کنید.
جریان مشترک برای همه پراکسی‌های API و جریان‌های مشترکی که در محیطی از این سازمان مستقر شده‌اند دردسترس خواهد بود. از خارج این سازمان دردسترس نخواهد بود.
- در نوار پیمایش بالا، واسط‌های برنامه‌سازی کاربردی > پیکربندی محیط > قلاب‌های جریان را انتخاب کنید.
- در فهرست قلاب‌های جاری‌سازی، قلاب جاری‌سازی را که می‌خواهید جاری‌سازی هم‌رسانی‌شده را به آن پیوست کنید
براساس جایی که می‌خواهید جاری‌سازی هم‌رسانی‌شده اجرا شود شناسایی کنید.
مکان قلاب جریان شرح قلاب جریان پیش‌از پراکسی پیش‌از اجرای نقطه پایانی پراکسی قلاب جریان پیش‌هدف پیش‌از اجرای نقطه پایان هدف قلاب جاری‌سازی پس‌از هدف پس‌از اجرای پاسخ هدف قلاب جریان پس‌از پراکسی پس‌از نقطه پایانی پراکسی و درست قبل‌از اینکه پاسخ به کارخواه ارسال شود - مکان‌نما را روی قلاب جاری‌سازی در فهرست قرار دهید تا ستون کنش‌ها نمایش داده شود.
- روی
کلیک کنید. - در چارگوش گفتگوی «جریان مشترک»، جریان مشترکی را که می‌خواهید در منو کرکره‌ای جریان مشترک پیوست کنید انتخاب کنید.
- روی تأیید کلیک کنید.
- جریان‌های هم‌رسانی‌شده را درصورت نیاز به قلاب‌های جریان دیگر پیوست کنید.