Giao tiếp giữa cổng thông tin dựa trên Drupal và Edge

Cách xem thông tin kết nối:

1. Trong trình đơn quản trị Drupal, hãy chọn Configuration > Dev Portal > Application Settings (Cấu hình > Cổng thông tin dành cho nhà phát triển > Cài đặt ứng dụng).

Cách thay đổi cấu hình:

Cách bạn thay đổi cấu hình phụ thuộc vào cách cài đặt và phiên bản cổng thông tin:

• Cài đặt dựa trên đám mây của cổng phiên bản 15.01.06 trở lên: Bạn phải gửi yêu cầu đến Nhóm hỗ trợ Apigee Edge để thay đổi thông tin kết nối. Ví dụ: nếu bạn muốn thay đổi tên của tổ chức.
• Cài đặt tại chỗ và cổng thông tin dựa trên đám mây trước phiên bản 15.01.06: Thay đổi thông tin kết nối như mô tả bên dưới:

1. Trong trình đơn quản trị Drupal, hãy chọn Configuration > Dev Portal Settings (Cấu hình > Cài đặt Cổng thông tin dành cho nhà phát triển).
2. Nhập tên tổ chức của bạn trong phần Tổ chức API quản lý.
3. Nhập URL của điểm cuối Edge trong URL điểm cuối API quản lý.
4. Nhập thông tin đăng nhập của quản trị viên tổ chức trong phần Người dùng đã xác thực điểm cuối và Mật khẩu của người dùng đã xác thực.
5. Chọn Kiểm tra kết nối để đảm bảo bạn đã kết nối thành công.
6. Chọn Save Configuration (Lưu cấu hình).

Đảm bảo quyền truy cập vào Edge từ cổng thông tin

Vì phần lớn thông tin mà cổng sử dụng được lưu trữ trên Edge, nên bạn phải đảm bảo rằng cổng có thể truy cập vào Edge. Cổng thông tin bắt đầu giao tiếp với Edge bằng cách tạo các yêu cầu REST qua HTTP và HTTPS. Ví dụ: khi nhà phát triển đăng ký một ứng dụng mới trên cổng thông tin, cổng thông tin sẽ đưa ra yêu cầu gửi thông tin về ứng dụng đó đến Edge.

Bạn có thể triển khai cả Edge và cổng thông tin trên đám mây hoặc tại chỗ, đồng thời có thể kết hợp các loại triển khai. Ví dụ: bạn có thể triển khai cả trên đám mây, cả tại chỗ hoặc triển khai một phiên bản trên đám mây và một phiên bản tại chỗ:

• Nếu cả cổng thông tin và Edge đều do Apigee triển khai trên đám mây, thì bạn sẽ không gặp vấn đề gì khi gửi yêu cầu từ cổng thông tin đến Edge.
• Nếu triển khai cổng trên máy chủ cục bộ, thì bạn phải đảm bảo rằng cổng có thể gửi yêu cầu đến Edge, bất kể Edge được triển khai trên đám mây hay trên máy chủ cục bộ.
• Nếu triển khai Edge tại chỗ, thì bạn phải đảm bảo rằng cổng có quyền truy cập vào Edge. Điều đó có nghĩa là máy chủ Edge phải chấp nhận các yêu cầu từ cổng thông tin bất kể cổng thông tin được triển khai trên đám mây hay tại chỗ.

Quản lý ứng dụng và khoá API trên cổng thông tin

Khi nhà phát triển hoàn tất quy trình đăng ký ứng dụng trên cổng thông tin, cổng thông tin sẽ gửi thông tin về ứng dụng đó đến Edge, bao gồm tên ứng dụng và các sản phẩm API liên kết với ứng dụng.

Nếu Edge đăng ký ứng dụng thành công, Edge sẽ trả về một khoá API duy nhất cho cổng thông tin. Sau đó, nhà phát triển sử dụng khoá API đó để truy cập vào các sản phẩm API liên kết với ứng dụng.

Không có thông tin nào về ứng dụng và khoá API được lưu trữ trên cổng thông tin. Thay vào đó, tất cả thông tin đó sẽ được lưu trữ trên Edge. Do đó, mỗi khi nhà phát triển sử dụng cổng thông tin để xem thông tin về một ứng dụng, cổng thông tin sẽ gửi yêu cầu đến Edge để truy cập thông tin đó. Bất cứ khi nào nhà phát triển sửa đổi một ứng dụng, cổng thông tin sẽ tự động gửi các nội dung sửa đổi đó đến Edge.

Ví dụ: một nhà phát triển đăng nhập vào cổng thông tin và chuyển đến trang Ứng dụng của tôi. Để điền trang Ứng dụng của tôi, cổng thông tin sẽ gửi yêu cầu đến Edge để truy xuất thông tin về ứng dụng và khoá API của nhà phát triển. Sau đó, thông tin đó sẽ xuất hiện trên trang Ứng dụng của tôi của nhà phát triển trong cổng thông tin:

Sau đó, nếu nhà phát triển thêm, xoá hoặc sửa đổi một ứng dụng, thì cổng thông tin sẽ gửi các nội dung sửa đổi đó đến Edge.

Vì tất cả thông tin về ứng dụng và khoá API đều được lưu trữ trên Edge, nên quản trị viên Edge có thể thao tác với thông tin đó bằng cách sử dụng giao diện người dùng Edge. Ví dụ: quản trị viên có thể:

• Thêm, xoá hoặc sửa đổi ứng dụng của nhà phát triển
• Thu hồi hoặc phê duyệt khoá API cho một ứng dụng

Dưới đây là cùng một ứng dụng, "Ứng dụng thời tiết của tôi", như hiển thị với quản trị viên trên giao diện người dùng Edge:

Quản lý nhà phát triển trên cổng thông tin

Khi một nhà phát triển đăng ký làm người dùng mới của cổng thông tin, nhà phát triển đó sẽ được tạo trên Edge và trên cổng thông tin. Do đó, không giống như ứng dụng và khoá API, thông tin về nhà phát triển thực sự được lưu trữ trên cả Edge và cổng thông tin.

Thông tin nhà phát triển được lưu trữ trên Edge bao gồm:

• Tên
• Họ
• Địa chỉ email
• Thông tin bổ sung không bắt buộc được gửi từ cổng thông tin

Cổng thông tin này lưu trữ thông tin giống như Edge, nhưng cũng lưu trữ thông tin bổ sung, bao gồm:

• Mật khẩu của Cổng thông tin
• Trạng thái tài khoản trên Cổng thông tin: đang hoạt động hoặc bị chặn
• Vai trò trên cổng thông tin: người dùng đã xác thực, quản trị viên, khác
• Quyền dựa trên vai trò: xác định những hành động mà nhà phát triển được phép thực hiện trên trang web

Khi nhà phát triển đăng nhập vào cổng thông tin, cổng thông tin sẽ chịu trách nhiệm xác thực nhà phát triển và thực thi các quyền dựa trên vai trò.

Vì cổng thông tin lưu trữ tất cả thông tin về một nhà phát triển, nên hãy coi cổng thông tin là hệ thống ghi nhận thông tin về nhà phát triển, chứ không phải Edge. Khi nhà phát triển sửa đổi thông tin của họ trên cổng thông tin, thông tin đó sẽ được lưu trữ trên cổng thông tin và được gửi đến Edge (nếu có). Ví dụ: nếu nhà phát triển thay đổi tên, thông tin đó sẽ được gửi đến Edge. Tuy nhiên, nếu nhà phát triển thay đổi mật khẩu, thông tin đó chỉ được lưu trữ cục bộ trên trang web.

Để biết thêm thông tin, hãy xem bài viết Thêm và quản lý tài khoản người dùng.

Đồng bộ hoá nhà phát triển ứng dụng giữa cổng thông tin và Edge

Edge không bắt đầu giao tiếp với cổng thông tin. Nếu bạn là quản trị viên Edge, thì việc bạn thao tác thông tin về một nhà phát triển trong giao diện người dùng Edge không đảm bảo thời điểm thông tin đó được đẩy xuống cổng thông tin. Do đó, hãy sử dụng các tính năng quản trị của trang web để tạo, sửa đổi và xoá nhà phát triển, chứ không phải Edge.

Quản trị viên cổng thông tin có thể buộc đồng bộ hoá giữa cổng thông tin và Edge để tải thông tin xuống cổng thông tin từ Edge. Tuy nhiên, nếu chỉ sửa đổi nhà phát triển trên cổng thông tin chứ không phải trên Edge, thì bạn sẽ không bao giờ phải thực hiện việc đồng bộ hoá này. Ngoài ra, vì Edge không cho phép bạn đặt mật khẩu khi tạo nhà phát triển, nên mọi nhà phát triển được tạo trên Edge đều có mật khẩu cổng thông tin được đặt thành một giá trị ngẫu nhiên. Do đó, nhà phát triển phải trải qua quy trình khôi phục mật khẩu thì mới có thể đăng nhập vào cổng thông tin.

Cách đồng bộ hoá cổng thông tin với nhà phát triển ứng dụng trên Edge

• Đăng nhập vào cổng thông tin của bạn với tư cách là người dùng có đặc quyền quản trị hoặc tạo nội dung.
• Chọn Người dùng trong trình đơn quản trị Drupal.
• Chọn nút Dev Portal Developer Sync (Đồng bộ hoá nhà phát triển trên Dev Portal) ở đầu trang để đồng bộ hoá với các nhà phát triển ứng dụng trên Edge.