اتصال یک جریان مشترک با استفاده از قلاب جریان

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

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

از آنجا که کد متصل به یک هوک جریان خارج از چارچوب منطق هسته پروکسی API است، برخی از رفتارهای آن با پروکسی‌های API متفاوت است. موارد زیر را در نظر داشته باشید:

  • شما باید مجوز اتصال یک جریان مشترک به یک هوک جریان را داشته باشید. شما باید مدیر سازمان باشید.
  • شما می‌توانید فقط یک جریان مشترک را به هر هوک جریان متصل کنید.
  • شما می‌توانید یک جریان مشترک را به چندین هوک جریان متصل کنید.
  • اگر جریان مشترک متصل به یک قلاب جریان، خطایی ایجاد کند یا در حین اجرای جریان مشترک خطایی رخ دهد، پیام رد شده و خطا به فراخواننده ارسال می‌شود.
  • اگر پیامی در حین اجرای یک هوک جریان رد شود، جزئیات در چارچوب پروکسی فراخوانی شده به آنالیتیکس ثبت می‌شوند. جریان مشترک همچنین می‌تواند با یک کد سفارشی و پیام خطا، خطا ایجاد کند.

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

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

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

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

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

شما با استفاده از کنسول مدیریت Apigee Edge، یک جریان مشترک را به یک قلاب جریان متصل می‌کنید. می‌توانید حداکثر یک جریان مشترک را در هر یک از مکان‌های زیر به یک قلاب جریان متصل کنید:

  • هوک جریان پیش پروکسی برای منطقی که باید قبل از اجرای یک نقطه پایانی پروکسی اجرا شود.

    برای مثال، می‌توانید منطقی برای اجرای امنیت در تمام APIهای یک محیط داشته باشید.

  • هوک جریان پیش از هدف برای منطقی که باید قبل از فراخوانی یک هدف اجرا شود.

    برای مثال، می‌توانید قبل از رسیدن درخواست به backend، گزارش‌گیری (logging) را پیاده‌سازی کنید. همچنین می‌توانید با حذف فیلدهای خاصی از درخواست، میانجیگری (mediation) را اعمال کنید.

  • هوک جریان پس از هدف برای منطقی که باید پس از اجرای پاسخ هدف اجرا شود.

    این بلافاصله پس از دریافت پاسخ از backend اعمال می‌شود. می‌توانید از آن برای ثبت پاسخ backend یا انجام برخی اقدامات میانجیگری با حذف فیلدهای حساس از پاسخ backend استفاده کنید.

  • هوک جریان پس از پروکسی برای منطقی که باید پس از نقطه پایانی پروکسی و درست قبل از ارسال پاسخ به کلاینت اجرا شود.

    این می‌تواند شامل برخی از منطق‌های اجرایی برای CORS، ثبت پاسخ یا انجام برخی از ترکیب‌ها یا قالب‌بندی‌ها باشد.

اتصال یک جریان مشترک به یک هوک جریان

برای اتصال یک جریان مشترک به یک هوک جریان، باید مدیر سازمانی باشید که جریان مشترک در آن قرار دارد.

  1. همانطور که در زیر توضیح داده شده است، به صفحه Flow Hooks دسترسی پیدا کنید.

    لبه

    برای دسترسی به صفحه Flow Hooks با استفاده از رابط کاربری Edge:

    1. وارد apigee.com/edge شوید.
    2. سازمانی که جریان اشتراکی شما در آن قرار دارد را انتخاب کنید. به بخش جابجایی بین سازمان‌هایتان مراجعه کنید.

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

    3. در نوار ناوبری سمت چپ، Admin > Environments > Flow Hooks را انتخاب کنید.

    لبه کلاسیک (ابر خصوصی)

    برای دسترسی به صفحه Flow Hooks با استفاده از رابط کاربری کلاسیک اج:

    1. وارد آدرس http:// ms-ip :9000 شوید، که در آن ms-ip آدرس IP یا نام DNS گره سرور مدیریت است.
    2. سازمانی که جریان اشتراکی شما در آن قرار دارد را انتخاب کنید. به بخش جابجایی بین سازمان‌هایتان مراجعه کنید.

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

    3. در نوار ناوبری بالا، APIها > پیکربندی محیط > هوک‌های جریان را انتخاب کنید.
  2. در لیست هوک‌های جریان، هوک جریانی را که می‌خواهید جریان مشترک به آن متصل شود، بر اساس مکانی که می‌خواهید جریان مشترک اجرا شود، مشخص کنید.
    محل قلاب جریان توضیحات
    قلاب جریان پیش پروکسی قبل از اجرای یک نقطه پایانی پروکسی
    قلاب جریان پیش هدف قبل از اینکه یک نقطه پایانی هدف اجرا شود
    قلاب جریان پس از هدف پس از اجرای پاسخ هدف
    قلاب جریان پس از پروکسی بعد از نقطه پایانی پروکسی و درست قبل از ارسال پاسخ به کلاینت
  3. مکان‌نمای خود را روی هوک جریان در لیست قرار دهید تا ستون اقدامات نمایش داده شود.
  4. کلیک .
  5. در پنجره‌ی Shared Flow، جریان اشتراکی که می‌خواهید پیوست کنید را از منوی کشویی Shared flow انتخاب کنید.
  6. روی تأیید کلیک کنید.
  7. در صورت نیاز، جریان‌های مشترک را به قلاب‌های جریان دیگر متصل کنید.