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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    لبه

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

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

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

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

    Classic Edge (ابر خصوصی)

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

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

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

    3. APIs > Environment Configuration > Flow Hooks را در نوار پیمایش بالا انتخاب کنید.
  2. در لیست قلاب‌های جریان، قلاب جریانی را که می‌خواهید جریان مشترک را به آن وصل کنید، بر اساس جایی که می‌خواهید جریان مشترک اجرا شود، شناسایی کنید.
    موقعیت قلاب جریان توضیحات
    فلو هوک پیش از پروکسی قبل از اجرای یک نقطه پایانی پروکسی
    فلو هوک قبل از هدف قبل از اینکه یک نقطه پایانی هدف اجرا شود
    فلو هوک پس از هدف پس از اجرای پاسخ هدف
    فلو هوک پس از پروکسی بعد از نقطه پایانی پروکسی و درست قبل از ارسال پاسخ به مشتری
  3. مکان نما خود را روی قلاب جریان در لیست قرار دهید تا ستون اقدامات نمایش داده شود.
  4. کلیک کنید .
  5. در گفتگوی جریان مشترک، جریان مشترکی را که می‌خواهید در منوی کرکره‌ای جریان اشتراک‌گذاری پیوست کنید، انتخاب کنید.
  6. روی OK کلیک کنید.
  7. جریان های مشترک را در صورت نیاز به سایر قلاب های جریان وصل کنید.