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

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

Cổng dịch vụ dành cho nhà phát triển đóng vai trò là khách hàng của Apigee Edge. Điều đó có nghĩa là cổng thông tin không hoạt động như một hệ thống độc lập. Thay vào đó, phần lớn thông tin mà cổng sử dụng thực sự được lưu trữ trên Edge. Khi cần, cổng thông tin sẽ thực hiện một yêu cầu HTTP hoặc HTTPS để truy xuất thông tin từ Edge hoặc để gửi thông tin đến Edge.

Edge không gửi yêu cầu đến cổng thông tin mà chỉ phản hồi các yêu cầu được đưa ra từ cổng thông tin. Do đó, tất cả hoạt động tương tác giữa cổng thông tin và Edge đều được cổng thực hiện.

Định cấu hình kết nối giữa cổng thông tin và Edge

Có 3 thông tin mà cổng thông tin cần giao tiếp với Edge, như được nêu bên dưới.

• URL của điểm cuối
  
  Điểm cuối mặc định cho phiên bản dựa trên đám mây của Edge là https://api.enterprise.apigee.com/v1.
  
  Đối với việc cài đặt Đám mây riêng tư, URL có dạng: http://EdgePrivateCloudIp:8080/v1 hoặc https://EdgePrivateCloudIp:EdgePrivateCloudIp/v1.
  
  Trong đó EdgePrivateCloudIp là địa chỉ IP của máy chủ Máy chủ quản lý Edge và TLSport là cổng TLS/SSL cho API quản lý Edge. Ví dụ: 8443.
• Tên tổ chức API
  
  Đây là tên tổ chức của bạn trên Edge. Bạn thiết lập tổ chức khi tạo tài khoản trên Edge.
• Tên người dùng và mật khẩu của quản trị viên nhà phát triển
  
  Các lệnh gọi từ cổng thông tin đến Edge được xác thực và cần người dùng có đặc quyền của Quản trị viên nhà phát triển. Khi Cổng thông tin cho nhà phát triển được cấp phép cho bạn, vai trò Quản trị viên của nhà phát triển sẽ được thêm vào tổ chức của bạn. Vai trò này (bao gồm một người dùng duy nhất có tên là devadmin+{org_name}@apigee.com) chỉ nhằm mục đích kết nối Cổng thông tin dành cho nhà phát triển với tổ chức Edge của bạn. Vì cổng hiển thị các ứng dụng dành cho nhà phát triển Edge, sản phẩm API, v.v., nên cổng đó phải luôn đồng bộ với tổ chức của bạn trên Edge bằng cách thực hiện các lệnh gọi API quản lý yêu cầu xác thực. "Người dùng" quản trị viên nhà phát triển có các quyền cần thiết.
  

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

1. Trong trình đơn quản trị Drupal, hãy chọn Cấu hình > Cổng 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 tuỳ thuộc vào chế độ cài đặt cổng thông tin và phiên bản cổng thông tin:

• Cài đặt trên đám mây cho cổng thông tin phiên bản 15.01.06 trở lên: Bạn phải gửi yêu cầu tới Bộ phận hỗ trợ Apigee để 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 cơ sở và cổng 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 Cấu hình > Cài đặt cổng thông tin cho nhà phát triển.
2. Nhập tên tổ chức của bạn trong 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 được 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 đã 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ì hầu hết 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 thực hiện 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 này sẽ yêu cầu Edge gửi thông tin về ứng dụng cho Edge.

Cả Edge và cổng thông tin đều có thể được triển khai trên đám mây hoặc tại chỗ, đồng thời bạn có thể kết hợp các loại triển khai. Ví dụ: bạn có thể triển khai cả hai trên đám mây, cả trên cơ sở hạ tầng riêng hoặc triển khai một giải pháp trên đám mây và một trên cơ sở hạ tầng riêng:

• Nếu cả cổng thông tin và Edge đều được Apigee triển khai trên đám mây, thì sẽ không có vấn đề gì khi gửi yêu cầu từ cổng thông tin sang Edge.
• Nếu triển khai cổng tại cơ sở hạ tầng riêng, 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 tại địa điểm.
• Nếu triển khai Edge tại cơ sở, bạn phải đảm bảo rằng cổng thông tin có quyền truy cập vào Edge. Điều đó có nghĩa là máy chủ Edge của bạn phải chấp nhận các yêu cầu từ cổng thông tin bất kể cổng đó được triển khai trên đám mây hay tại địa điểm.

Quản lý ứng dụng và khoá API từ 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 này sẽ gửi thông tin về ứng dụng cho Edge, bao gồm cả 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 thực sự đượ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 đó, bất cứ khi nào 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 những nội dung sửa đổi đó tới Edge.

Ví dụ: một nhà phát triển đăng nhập vào cổng thông tin và điều hướng tới trang Ứng dụng của tôi. Để điền sẵn trang Ứng dụng của tôi, cổng thông tin sẽ gửi yêu cầu tới Edge để truy xuất thông tin về các khoá API và ứng dụng 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:

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 những nội dung sửa đổi đó đến Edge.

Vì tất cả thông tin về các ứ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 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 của ứng dụng

Dưới đây là hình ảnh một ứng dụng tương tự có tên "My Weather App" (Ứng dụng thời tiết của tôi), vì quản trị viên nhìn thấy ứng dụng này trên giao diện người dùng Edge:

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

Khi nhà phát triển đăng ký làm người dùng mới trên 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 tương tự như Edge nhưng cũng lưu trữ thêm các thông tin khác, bao gồm:

• Mật khẩu cổng thông tin
• Trạng thái tài khoả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, người dùng 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 cổng thông tin

Khi nhà phát triển đăng nhập vào cổng thông tin, cổng này 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ề nhà phát triển, nên hãy coi cổng thông tin là hệ thống hồ sơ cho thông tin 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 đổ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ì thông tin đó chỉ được lưu trữ trên cổng thông tin.

Để 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. Là một quản trị viên Edge, nếu bạn, với tư cách là quản trị viên Edge, chỉnh sửa thông tin về nhà phát triển trong giao diện người dùng Edge, thì chúng tôi không thể đảm bảo về thời điểm thông tin đó sẽ đượ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 cổng thông tin để 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ộ hóa giữa cổng thông tin và Edge để tải thông tin xuống cổng 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, bạn sẽ không bao giờ phải thực hiện quá trình đồng bộ hoá này. Ngoài ra, vì Edge không cho phép bạn đặt mật khẩu khi bạn tạo nhà phát triển, nên mọi nhà phát triển tạo trên Edge đều đặt mật khẩu cổng thông tin của họ 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 trước khi có thể đăng nhập vào cổng thông tin.

Để đồ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 của quản trị viên hoặc tạo nội dung.
• Chọn Mọi người trong trình đơn quản trị của Drupal.
• Chọn nút Phát triển cổng nhà phát triển đồng bộ hóa ở đầu trang để đồng bộ hóa với các nhà phát triển ứng dụng trên Edge.