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 quá trình xử lý trước yêu cầu nguyên mẫu hoặc xử lý sau phản hồi trên một tập hợp API. Với lệnh gọi lại flow, bạn đính kèm một flow dùng chung để thực thi tại cùng một vị trí cho tất cả proxy API được triển khai cho một môi trường cụ thể. Điều này cung cấp cho bạn một trình tự logic được triển khai và triển khai riêng biệt không thuộc mã triển khai của proxy.
Vì mã đính kèm với trình bổ trợ flow 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 sẽ 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 flow dùng chung vào mỗi hook flow.
- Bạn có thể đính kèm cùng một flow dùng chung vào nhiều hook flow.
- Nếu luồng dùng chung được đính kèm vào một trình nối luồng 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 trình bổ trợ luồng, thì thông tin chi tiết sẽ được ghi vào phân tích trong ngữ cảnh của proxy được gọi. Luồng dùng chung cũng có thể gửi lỗi bằng mã tuỳ chỉnh và thông báo lỗi
Video sau đây minh hoạ cách kết nối một flow dùng chung với một hook flow, sau đó theo dõi flow đó trong giao diện người dùng Edge cổ điển.
Video sau đây minh hoạ cách kết nối một flow dùng chung với một hook flow, sau đó theo dõi flow đó trong giao diện người dùng trải nghiệm Edge mới.
Luồng dùng chung được đính kèm vào proxy thông qua một trình nối luồng là nơi lý tưởng cho logic thực thi các yêu cầu chính sách rộng rãi. Ví dụ: hãy tưởng tượng bạn có một nhóm quản lý một bộ yêu cầu bảo mật cho nhiều nhóm đại diện cho nhiều ngành kinh doanh (LOB). 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 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 trình nối luồng. Vì luồng dùng chung 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 ảnh hưởng đến mã LOB.
Các luồng dùng chung được đính kèm thông qua các trình bổ trợ luồng sẽ thực thi ở vị trí đó cho mọi proxy API được triển khai vào môi trường của trình bổ trợ 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 trình bổ trợ flow.
Để 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 flow dùng chung vào một hook flow bằng cách sử dụng bảng điều khiển quản lý Apigee Edge. Bạn có thể đính kèm tối đa một flow dùng chung vào một hook flow tại mỗi vị trí sau:
-
Đường dẫn luồng trước proxy cho logic cần được thực thi TRƯỚC khi điểm cuối proxy thực thi.
Ví dụ: bạn có thể có logic để thực thi bảo mật trên tất cả các API trong một môi trường.
-
Đường dẫn câu lệnh trước mục tiêu cho logic cần được thực thi TRƯỚC khi 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 phần phụ trợ. Bạn cũng có thể thực thi tính năng dàn xếp bằng cách xoá một số trường nhất định khỏi yêu cầu.
-
Đường dẫn sau mục tiêu cho logic cần được thực thi SAU khi phản hồi mục tiêu thực thi.
Điều 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ể sử dụng hàm 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ợ.
-
Đường dẫn sau proxy Hook cho logic cần được thực thi SAU đ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ố hoạt động kết hợp hoặc định dạng.
Đính kèm một flow dùng chung vào một hook flow
Để đính kèm một flow dùng chung vào một hook flow, bạn phải là quản trị viên trong tổ chức chứa flow dùng chung đó.
- Truy cập vào trang Flow Hooks (Đường liên kết trong luồng), như mô tả bên dưới.
Edge
Cách truy cập vào trang Flow Hooks (Đường dẫn nố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 chứa luồng được chia sẻ. Xem phần Chuyển đổi giữa các tổ chức.
Luồng dùng chung sẽ có sẵn cho mọi proxy API và luồng dùng chung được triển khai cho một môi trường của tổ chức này. Người dùng bên ngoài tổ chức này sẽ không truy cập được vào ứng dụng này.
- Chọn Quản trị > Môi trường > Lệnh gọi hàm trong luồng trong thanh điều hướng bên trái.
Edge phiên bản cũ (Đám mây riêng)
Cách truy cập vào trang Flow Hooks (Đường liên kết trong luồng) bằng giao diện người dùng Edge cũ:
- Đă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 chứa luồng được chia sẻ. Xem phần Chuyển đổi giữa các tổ chức.
Luồng dùng chung sẽ có sẵn cho mọi proxy API và luồng dùng chung được triển khai cho một môi trường của tổ chức này. Người dùng bên ngoài tổ chức này sẽ không truy cập được vào ứng dụng này.
- Chọn API > Cấu hình môi trường > Lệnh gọi hàm trong luồng trong thanh điều hướng trên cùng.
- Trong danh sách các trình bổ trợ flow, hãy xác định trình bổ trợ flow mà bạn muốn đính kèm flow dùng chung dựa trên vị trí bạn muốn thực thi flow dùng chung.
Vị trí của móc luồng Mô tả Lệnh gọi Luồng trước proxy TRƯỚC khi điểm cuối proxy thực thi Lệnh gọi hàm trong luồng trước mục tiêu TRƯỚC khi điểm cuối mục tiêu thực thi Hook luồng sau mục tiêu SAU khi phản hồi mục tiêu thực thi Lệnh gọi Luồng sau proxy SAU điểm cuối proxy và ngay trước khi phản hồi được gửi đến ứng dụng khách - Đặt con trỏ lên hook flow trong danh sách để hiển thị cột hành động.
- Nhấp vào
. - Trong hộp thoại Shared Flow (Luồng dùng chung), hãy chọn luồng dùng chung mà bạn muốn đính kèm trong trình đơn thả xuống Shared flow (Luồng dùng chung).
- Nhấp vào OK.
- Đính kèm các luồng dùng chung vào các trình kích hoạt luồng khác nếu cần.