Bạn đang xem tài liệu về Apigee Edge.
Chuyển đến tài liệu về
Apigee X. thông tin
Phần này hướng dẫn cách lập kế hoạch và thực hiện việc di chuyển các thành phần của cổng thông tin Drupal 7 sang cổng thông tin tích hợp.
Bước 1: Tạo cổng thông tin tích hợp
Trước khi di chuyển các thành phần của cổng thông tin Drupal 7, bạn phải tạo một cổng thông tin tích hợp.
Cách tạo cổng thông tin tích hợp:
- Đảm bảo rằng bạn có vai trò trên cổng thông tin phù hợp để quản lý cổng thông tin tích hợp.
- Tạo cổng thông tin tích hợp.
Khi bạn tạo một cổng thông tin tích hợp, một nhóm trang khởi động sẽ được cung cấp để bạn sử dụng làm điểm xuất phát. Các trang khởi động chứa nội dung minh hoạ để giúp bạn phát triển cổng thông tin của riêng mình khi thay thế văn bản và hình ảnh bằng nội dung độc đáo. Để biết thêm thông tin, hãy xem bài viết Giới thiệu về cổng thông tin mẫu.
Bước 2: Xây dựng cổng thông tin tích hợp
Tạo cổng thông tin tích hợp, như mô tả trong phần Các bước để tạo cổng thông tin.
Ở mức tối thiểu, bạn cần thực hiện các bước được liệt kê trong bảng sau.
| Bước | Mô tả |
|---|---|
| Phát triển nội dung cổng thông tin | Chẳng hạn như thông tin khái niệm và thông tin bắt đầu. Bạn có thể chọn tạo trang, sau đó sao chép và dán nội dung trang ngay từ cổng thông tin Drupal 7 hiện có. |
| Thiết lập tính năng điều hướng | Tạo thành phần điều hướng cần thiết để phù hợp với cấu trúc hiện có. |
| Tuỳ chỉnh giao diện | Ở mức tối thiểu, hãy tuỳ chỉnh các thành phần sau đây cho phù hợp với yêu cầu về thương hiệu: |
| Thêm tập lệnh tuỳ chỉnh | Thêm mã JavaScript tuỳ chỉnh vào cổng thông tin của bạn (nếu cần). |
| Định cấu hình email | Định cấu hình máy chủ SMTP và nội dung của thông báo qua email. Lưu ý: Hiện tại, bạn không thể định cấu hình thông báo qua email cho các cổng tích hợp kết hợp Apigee. |
| Quản lý chế độ hiển thị mặc định | Quản lý chế độ hiển thị mặc định cho các tài nguyên cụ thể. |
| Định cấu hình chính sách bảo mật nội dung | Định cấu hình chính sách bảo mật nội dung (CSP) cho tất cả các trang trong cổng thông tin của bạn để bảo vệ khỏi các cuộc tấn công thông qua tập lệnh trên nhiều trang web (XSS) và các cuộc tấn công chèn mã khác (nếu muốn).
Lưu ý: Tính năng này hiện chưa có trên các cổng tích hợp kết hợp Apigee. |
Bước 3: Định cấu hình nhà cung cấp danh tính
Định cấu hình nhà cung cấp danh tính trên cổng tích hợp dựa trên loại xác thực, như được nêu trong bảng sau.
| Xác thực | Mô tả |
|---|---|
| Nhà cung cấp danh tính tích hợp (tên người dùng/mật khẩu) | Định cấu hình nhà cung cấp danh tính tích hợp trên cổng thông tin tích hợp. |
| Đăng nhập một lần (SSO) bằng SAML | Định cấu hình nhà cung cấp danh tính SAML (Thử nghiệm) trên cổng thông tin tích hợp.
Lưu ý:
|
Sau khi nhà phát triển đăng nhập vào cổng thông tin, bạn có thể quản lý tài khoản của họ như mô tả trong phần Quản lý tài khoản nhà phát triển.
Bước 4: Kiểm soát quyền truy cập vào tài nguyên bằng đối tượng
Nếu sử dụng vai trò trong Drupal 7 để kiểm soát quyền truy cập vào một nhóm tài nguyên, chẳng hạn như tài liệu API hoặc tạo khoá API cho một sản phẩm API, thì bạn có thể thực hiện chức năng tương tự bằng cách sử dụng đối tượng trên cổng thông tin tích hợp.
Cụ thể, bạn có thể kiểm soát quyền truy cập vào tài nguyên sau trên cổng thông tin tích hợp bằng đối tượng:
- Các trang trong cổng thông tin
- Các sản phẩm API đã phát hành
Để thêm đối tượng và quản lý các nhiệm vụ của từng người dùng và nhóm nhà phát triển, hãy xem bài viết Quản lý đối tượng. Khi người dùng mới tạo tài khoản và đăng nhập vào cổng thông tin của bạn, bạn cần chỉ định họ cho một hoặc nhiều đối tượng (nếu cần), như mô tả trong phần Quản lý các chỉ định cho một đối tượng.
Để đơn giản hoá quá trình di chuyển, bạn có thể cân nhắc các mẹo sau:
- Đặt tên cho đối tượng theo vai trò Drupal mà đối tượng đó thay thế.
- Quản lý tư cách thành viên đối tượng bằng nhóm nhà phát triển. Nhà phát triển tạo nhóm để chia sẻ trách nhiệm về ứng dụng và quản lý thành viên trong nhóm.
Bước 5: Xuất bản API
Để phát hành API và tự động tạo tài liệu tham khảo API bằng SmartDocs trên cổng thông tin tích hợp, bạn cần có quyền truy cập vào Thông số kỹ thuật OpenAPI liên kết với API.
Mặc dù bạn có thể đã sử dụng Quy cách OpenAPI để tự động tạo SmartDocs trong Drupal 7, nhưng cuối cùng, nội dung sẽ được lưu trữ bằng một định dạng nội bộ mà không liên kết với Quy cách OpenAPI ban đầu. Các nhóm API sử dụng Apigee Edge thường lưu trữ Thông số kỹ thuật OpenAPI trong kho thông số kỹ thuật Apigee Edge.
Sau đó, hãy xuất bản API lên cổng thông tin của bạn. Hãy chuẩn bị sẵn sàng để:
- Chỉ định Thông số kỹ thuật OpenAPI để dùng làm nguồn tài liệu, từ kho thông số kỹ thuật, thư mục cục bộ hoặc URL
- Thiết lập chế độ hiển thị cho tài liệu (công khai, người dùng xác thực hoặc đối tượng được chọn)
- Định cấu hình URL gọi lại (nếu cần)
- Thêm hình ảnh vào màn hình trong danh mục API (nếu muốn)
Bước 6: Chia sẻ trách nhiệm cho một ứng dụng bằng cách sử dụng các nhóm nhà phát triển
Nếu nhà phát triển sử dụng ứng dụng công ty trong Drupal 7 để chia sẻ trách nhiệm cho một ứng dụng, thì họ có thể thực hiện chức năng tương tự bằng cách sử dụng nhóm nhà phát triển trên cổng tích hợp.
Nhà phát triển của bạn tạo nhóm nhà phát triển để chia sẻ trách nhiệm cho ứng dụng của họ và quản lý thành viên nhóm, như mô tả trong bài viết Chia sẻ trách nhiệm cho một ứng dụng bằng cách sử dụng nhóm nhà phát triển (Bản thử nghiệm).
Bạn nên hướng dẫn cộng đồng nhà phát triển về nhóm nhà phát triển và khuyến khích họ di chuyển ứng dụng của mình để sử dụng nhóm nhà phát triển nhằm chia sẻ trách nhiệm và chuyển đổi sang sử dụng khoá API mới. Sau đó, bạn có thể xoá tất cả ứng dụng của công ty và các cấu phần phần mềm có liên quan bằng API Edge.
Ngoài ra, bạn có thể di chuyển ứng dụng của công ty sang ứng dụng của nhóm nhà phát triển, như mô tả trong bài viết sau đây trên cộng đồng: Di chuyển ứng dụng do công ty sở hữu sang nhóm nhà phát triển.
Bước 7: Chuẩn bị ra mắt cổng thông tin tích hợp
Trước khi phát hành cổng thông tin tích hợp công khai, hãy cân nhắc thực hiện các bước được xác định trong bảng sau.
| Bước | Nội dung mô tả |
| Tuỳ chỉnh miền | Cung cấp tên miền tuỳ chỉnh của riêng bạn để cá nhân hoá trang web. Lưu ý: Tính năng này hiện chưa có trên các cổng tích hợp kết hợp Apigee. |
| Định cấu hình tính năng theo dõi số liệu phân tích | Định cấu hình tính năng theo dõi số liệu phân tích bằng Google Analytics hoặc dịch vụ theo dõi số liệu phân tích tuỳ chỉnh của riêng bạn. |
| Tạo trang tìm kiếm tuỳ chỉnh | Tạo trang tìm kiếm tuỳ chỉnh và nhúng công cụ tìm kiếm tuỳ chỉnh của Google. |