Đính kèm một quy trình được chia sẻ bằng hook flow

Bạn đang xem tài liệu về Apigee Edge.
Chuyển đến tài liệu về Apigee X.
thông tin

Bạn có thể yêu cầu các luồng dùng chung thực hiện việc xử lý trước yêu cầu nguyên mẫu hoặc xử lý hậu kỳ phản hồi trên một tập hợp API. Với hook hook, bạn đính kèm một flow được chia sẻ để có thể thực thi ở cùng một nơi cho tất cả các proxy API được triển khai trong một môi trường cụ thể. Thao tác này cung cấp cho bạn một trình tự logic được triển khai và triển khai riêng không thuộc mã triển khai của proxy.

Vì mã được đính kèm với hook luồng nằm ngoài ngữ cảnh của logic lõi proxy API, nên một số hành vi của mã này khác với proxy API. Những điều cần lưu ý:

  • Bạn phải có quyền đính kèm một flow dùng chung vào một flow hook. Bạn phải là quản trị viên tổ chức.
  • Bạn chỉ có thể đính kèm một luồng dùng chung vào mỗi hook luồng.
  • Bạn có thể đính kèm cùng một quy trình dùng chung vào nhiều hook của luồng.
  • Nếu luồng dùng chung đính kèm với một hook dùng chung gây ra lỗi hoặc có lỗi xảy ra trong quá trình thực thi luồng dùng chung, thì thông báo sẽ bị từ chối và lỗi sẽ được gửi lại cho phương thức gọi.
  • Nếu một thông báo bị từ chối trong quá trình thực thi hook luồng, thông tin chi tiết sẽ được ghi lại vào Analytics trong bối cảnh proxy được gọi. Luồng dùng chung cũng có thể gửi lỗi với một mã tuỳ chỉnh và thông báo lỗi

Video sau đây minh hoạ cách kết nối một luồng dùng chung với một hook của luồng, sau đó theo dõi luồng đó trong giao diện người dùng Classic Edge.

Video sau đây minh hoạ cách kết nối một luồng dùng chung với một hook luồng, sau đó theo dõi luồng đó trong giao diện người dùng trải nghiệm New Edge.

Một luồng dùng chung được đính kèm với một proxy thông qua hook luồng là một nơi tuyệt vời cho logic thực thi các yêu cầu rộng lớn của chính sách. Ví dụ: hãy tưởng tượng rằng bạn có một nhóm quản lý một bộ yêu cầu về bảo mật cho nhiều nhóm đại diện cho nhiều lĩnh vực kinh doanh (LOB). Mỗi nhóm LOB có thể phát triển API theo yêu cầu riêng mà không cần phải tính đến những yêu cầu rộng hơn về bảo mật. Nhóm bảo mật có thể triển khai các yêu cầu bảo mật đó trong một quy trình dùng chung, sau đó đính kèm quy trình này vào môi trường Apigee Edge bằng một hook luồng. Vì luồng được chia sẻ không phải là một phần của mã proxy, nên nhóm bảo mật có thể sửa đổi luồng đó nếu cần mà không can thiệp vào mã LOB.

Các luồng dùng chung được đính kèm thông qua hook luồng sẽ thực thi tại vị trí đó cho mọi proxy API được triển khai đến môi trường của hook proxy. Vì lý do này, chỉ quản trị viên của một tổ chức Apigee Edge mới có thể sử dụng hook luồng.

Để biết thêm thông tin về luồng dùng chung, hãy xem phần Luồng dùng chung có thể tái sử dụng.

Bạn đính kèm một quy trình dùng chung vào một hook flow bằng bảng điều khiển quản lý Apigee Edge. Bạn có thể đính kèm tối đa một luồng dùng chung vào một hook ở mỗi vị trí sau đây:

  • CHO Flow Hook trước proxy cho logic cần được thực thi TRƯỚC KHI thực thi điểm cuối proxy.

    Ví dụ: bạn có thể có logic để thực thi tính bảo mật trên tất cả các API trong một môi trường.

  • CHO Flow Hook nhắm mục tiêu trước cho logic cần được thực thi TRƯỚC KHI gọi mục tiêu.

    Ví dụ: bạn có thể triển khai tính năng ghi nhật ký trước khi yêu cầu đến phần phụ trợ. Bạn cũng có thể thực thi quy trình dàn xếp bằng cách xoá một số trường nhất định khỏi yêu cầu.

  • Móc khoá luồng sau mục tiêu cho logic cần được thực thi SAU KHI phản hồi mục tiêu được thực thi.

    Chúng tôi sẽ thực thi thao tác này ngay sau khi phần phụ trợ lấy thông tin phản hồi. Bạn có thể sử dụng phương thức này để ghi nhật ký phản hồi phụ trợ hoặc thực hiện một số hoạt động dàn xếp bằng cách xoá các trường nhạy cảm khỏi phản hồi phụ trợ.

  • Móc khoá luồng sau proxy cho logic cần được thực thi SAU khi có điểm cuối proxy và ngay trước khi phản hồi được gửi đến ứng dụng.

    Điều này có thể bao gồm một số logic thực thi cho CORS, ghi nhật ký phản hồi hoặc thực hiện một số kết hợp dữ liệu hoặc định dạng.

Đính kèm một luồng được chia sẻ vào một hook luồng

Để đính kèm một luồng dùng chung vào một hook dùng chung, bạn phải là quản trị viên trong tổ chức có chứa luồng dùng chung đó.

  1. Truy cập trang Flow Hooks (Móc khoá quy trình) như mô tả dưới đây.

    Edge

    Cách truy cập vào trang Flow Hooks bằng giao diện người dùng Edge:

    1. Đăng nhập vào apigee.com/edge.
    2. Chọn tổ chức chứa luồng mà bạn chia sẻ. Hãy xem phần Chuyển đổi giữa các tổ chức của bạn.

      Luồng dùng chung sẽ áp dụng cho mọi proxy API và luồng dùng chung được triển khai cho một môi trường từ tổ chức này. Dữ liệu đó sẽ không dùng được từ bên ngoài tổ chức này.

    3. Chọn Quản trị > Môi trường > Flow Hooks trong thanh điều hướng bên trái.

    Phiên bản cũ (Đám mây riêng tư)

    Cách truy cập vào trang Flow Hooks bằng giao diện người dùng Classic Edge:

    1. Đăng nhập vào http://ms-ip:9000, trong đó ms-ip là địa chỉ IP hoặc tên DNS của nút Máy chủ quản lý.
    2. Chọn tổ chức chứa luồng mà bạn chia sẻ. Hãy xem phần Chuyển đổi giữa các tổ chức của bạn.

      Luồng dùng chung sẽ áp dụng cho mọi proxy API và luồng dùng chung được triển khai cho một môi trường từ tổ chức này. Dữ liệu đó sẽ không dùng được từ bên ngoài tổ chức này.

    3. Chọn API > Environment Configuration > Flow Hooks (API > Cấu hình môi trường > Flow Hooks) trong thanh điều hướng trên cùng.
  2. Trong danh sách hook luồng, hãy xác định hook luồng mà bạn muốn đính kèm vào luồng được chia sẻ dựa trên vị trí bạn muốn thực thi luồng chia sẻ đó.
    Vị trí móc ống nước Nội dung mô tả
    Móc khoá luồng trước proxy TRƯỚC KHI một điểm cuối proxy thực thi
    Móc tạo luồng trước mục tiêu TRƯỚC KHI điểm cuối đích thực thi
    Móc nối luồng sau mục tiêu SAU KHI phản hồi mục tiêu thực thi
    Móc khoá luồng sau proxy SAU KHI điểm cuối proxy và ngay trước khi phản hồi được gửi đến ứng dụng
  3. Đặt con trỏ lên hook flow trong danh sách để hiển thị cột hành động.
  4. Nhấp vào .
  5. Trong hộp thoại Luồng chia sẻ, hãy chọn luồng chia sẻ mà bạn muốn đính kèm trong trình đơn thả xuống Luồng chia sẻ.
  6. Nhấp vào OK.
  7. Đính kèm các luồng được chia sẻ vào các hook khác của luồng khi cần.