Bạn đang xem tài liệu về Apigee Edge.
Truy cập vào
tài liệu Apigee X. thông tin
Bạn có thể để các luồng dùng chung thực hiện quy trình xử lý trước yêu cầu hoặc xử lý sau phản hồi tiêu chuẩn trên một nhóm API. Với flow hook, bạn sẽ đính kèm một luồng dùng chung để luồng đó thực thi ở cùng một vị trí cho tất cả các proxy API được triển khai cho một môi trường cụ thể. Điều này mang đến cho bạn một chuỗi logic được triển khai và triển khai riêng biệt, không phải là một phần của mã triển khai của proxy.
Vì mã được đính kèm vào một lệnh gọi lại luồng nằm ngoài ngữ cảnh của logic cốt lõi của 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 luồng dùng chung vào một lệnh gọi luồng. 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 điểm móc luồng.
- Bạn có thể đính kèm cùng một luồng dùng chung vào nhiều hook luồng.
- Nếu luồng dùng chung được đính kèm vào một lệnh gọi luồng sẽ gây ra lỗi hoặc có lỗi 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 một lệnh gọi hook của quy trình, thì thông tin chi tiết sẽ được ghi vào số liệu phân tích trong bối cảnh của proxy được gọi. Luồng dùng chung cũng có thể gửi một lỗi có 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 lệnh gọi 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 lệnh gọi luồng, sau đó theo dõi luồng đó trong giao diện người dùng của New Edge.
Một quy trình dùng chung được đính kèm vào một proxy thông qua một lệnh gọi quy trình là nơi lý tưởng cho logic thực thi các yêu cầu theo chính sách chung. 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 bảo mật duy nhất cho nhiều nhóm đại diện cho các lĩnh vực kinh doanh (LOB) khác nhau. Mỗi nhóm LOB có thể phát triển API theo yêu cầu riêng của họ mà không cần phải tính đến các yêu cầu bảo mật rộng hơn. Nhóm bảo mật có thể triển khai các yêu cầu bảo mật đó trong một luồng dùng chung, sau đó đính kèm luồng vào môi trường Apigee Edge bằng một lệnh gọi luồng. Vì quy trình dùng chung không thuộc mã proxy, nên nhóm bảo mật có thể sửa đổi quy trình này khi cần mà không ảnh hưởng đến mã LOB.
Các luồng dùng chung được đính kèm thông qua các lệnh gọi luồng sẽ thực thi tại vị trí đó cho mọi API proxy được triển khai vào môi trường của lệnh gọi 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 các lệnh gọi hook luồng.
Để biết thêm về luồng dùng chung, hãy xem phần Luồng dùng chung có thể sử dụng lại.
Bạn đính kèm một luồng dùng chung vào một điểm móc luồng 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 lệnh gọi luồng ở mỗi vị trí sau đây:
-
Pre-proxy Flow Hook cho logic cần được thực thi TRƯỚC khi một điểm cuối proxy thực thi.
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.
-
Pre-target Flow Hook cho logic cần được thực thi TRƯỚC khi một mục tiêu được gọi.
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 được phần phụ trợ. Bạn cũng có thể thực thi hoạt động dàn xếp bằng cách xoá một số trường khỏi yêu cầu.
-
Post-target Flow Hook cho logic cần được thực thi SAU khi phản hồi mục tiêu thực thi.
Quy tắc này sẽ được thực thi ngay sau khi phản hồi được trả về từ phần phụ trợ. Bạn có thể dùng phương thức này để ghi lại 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ợ.
-
Post-proxy Flow Hook cho logic cần được thực thi SAU điểm cuối của 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 hoặc định dạng.
Đính kèm một luồng được chia sẻ vào một lệnh gọi luồng
Để đính kèm một luồng dùng chung vào một lệnh gọi luồng, bạn phải là quản trị viên trong tổ chức chứa luồng dùng chung đó.
- Truy cập vào trang Flow Hooks (Các lệnh gọi lại của luồng), như mô tả bên dưới.
Edge
Cách truy cập vào trang Flow Hooks (Các lệnh gọi lại luồng) bằng giao diện người dùng Edge:
- Đăng nhập vào apigee.com/edge.
- Chọn tổ chức có chứa quy trình công việc được chia sẻ. Xem phần Chuyển đổi giữa các tổ chức.
Mọi API proxy và quy trình dùng chung được triển khai cho một môi trường từ tổ chức này đều có thể sử dụng quy trình dùng chung. Ứng dụng này sẽ không hoạt động bên ngoài tổ chức này.
- Chọn Quản trị > Môi trường > Lệnh gọi lại luồng trong thanh điều hướng bên trái.
Classic Edge (Private Cloud)
Cách truy cập vào trang Flow Hooks bằng giao diện người dùng Edge cổ điển:
- Đă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ý. - Chọn tổ chức có chứa quy trình công việc được chia sẻ. Xem phần Chuyển đổi giữa các tổ chức.
Mọi API proxy và quy trình dùng chung được triển khai cho một môi trường từ tổ chức này đều có thể sử dụng quy trình dùng chung. Ứng dụng này sẽ không hoạt động bên ngoài tổ chức này.
- Chọn APIs > Environment Configuration > Flow Hooks (API > Cấu hình môi trường > Lệnh gọi lại luồng) trong thanh điều hướng trên cùng.
- Trong danh sách các lệnh gọi luồng, hãy xác định lệnh gọi luồng mà bạn muốn đính kèm luồng dùng chung dựa trên vị trí bạn muốn thực thi luồng dùng chung.
Vị trí móc dòng chảy Mô tả Lệnh gọi trước proxy TRƯỚC KHI một điểm cuối proxy thực thi Pre-target Flow Hook TRƯỚC khi một điểm cuối mục tiêu thực thi Post-target Flow Hook SAU KHI phản hồi mục tiêu thực thi Post-proxy Flow Hook SAU điểm cuối của proxy và ngay trước khi phản hồi được gửi đến ứng dụng khách - Đặt con trỏ lên móc quy trình trong danh sách để hiển thị cột thao tác.
- Nhấp vào
. - Trong hộp thoại Shared Flow (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 Shared flow (Luồng chia sẻ).
- Nhấp vào OK.
- Đính kèm các luồng dùng chung vào các điểm móc luồng khác nếu cần.