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 đưa ra hướng dẫn về cách lập kế hoạch và tiến hành di chuyển tài sản cổng thông tin Drupal 7 sang cổng thông tin tích hợp.
Bước 1: Tạo một cổng thông tin tích hợp
Trước khi di chuyển tài sản 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 một cổng thông tin tích hợp:
- Đảm bảo rằng bạn có vai trò cổng thông tin thích hợp để quản lý cổng thông tin tích hợp.
- Tạo một 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 các trang dành cho người mới bắt đầu sẽ được cung cấp để bạn sử dụng làm điểm bắt đầu. Các trang khởi đầu chứa nội dung minh hoạ để giúp bạn có cảm hứng phát triển cổng thông tin của riêng mình bằng cách 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 phần 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 của bạn
Xây dựng cổng thông tin tích hợp của bạn như mô tả trong Các bước xây dựng cổng thông tin.
Ít nhất, bạn cần phải thực hiện các bước được liệt kê trong bảng sau.
| Bước | Nội dung mô tả |
|---|---|
| Phát triển nội dung trên 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 chỉ đườ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 tại của bạn. |
| Tuỳ chỉnh giao diện của bạ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 xây dựng thương hiệu của bạn: |
| 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 của bạn và nội dung thông báo qua email. Lưu ý: Hiện tại, chúng tôi chưa hỗ trợ cấu hình thông báo qua email cho cổng thông tin tích hợp kết hợp của 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 | Thiết lập chính sách bảo mật nội dung (CSP) cho mọi trang trong cổng thông tin của bạn để ngăn chặn các cuộc tấn công tập lệnh trên nhiều trang web (XSS) cũng như các cuộc tấn công chèn mã khác, nếu muốn.
Lưu ý: Hiện tại, chúng tôi không cung cấp tính năng này cho cổng thông tin tích hợp kết hợp của 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 thông tin tích hợp dựa vào loại xác thực, như được nêu trong bảng sau.
| Xác thực | Nội dung mô tả |
|---|---|
| Trình cung cấp danh tính tích hợp sẵn (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 sẵn 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 (Beta) 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 cách sử dụ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 khóa API cho một sản phẩm API, bạn có thể có được 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 cách sử dụng đối tượng:
- Các trang trong cổng thông tin của bạn
- Các sản phẩm API đã xuất bản
Để thêm một đối tượng và quản lý việc chỉ định 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 một 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ư được mô tả trong phần Quản lý việc chỉ định 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 của bạn theo các vai trò trên Drupal mà họ sẽ thay thế.
- Quản lý tư cách thành viên của đối tượng thông qua 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ý tư cách thành viên trong nhóm.
Bước 5: Xuất bản các API
Để xuất bản 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 được liên kết với API.
Mặc dù bạn có thể đã sử dụng Thông số kỹ thuật OpenAPI để tự động tạo SmartDocs trong Drupal 7, nhưng cuối cùng, nội dung sẽ được lưu trữ ở một định dạng nội bộ mà không liên kết với bất kỳ thông số kỹ thuật OpenAPI ban đầu nào. Các nhóm API sử dụng Apigee Edge thường lưu trữ Thông số kỹ thuật OpenAPI trong cửa hàng thông số kỹ thuật của Apigee Edge.
Sau đó, hãy phát hành API lên cổng thông tin của bạn. Hãy chuẩn bị để:
- Chỉ định Bản đặc tả OpenAPI để dùng làm nguồn tài liệu, từ kho lưu trữ thông số kỹ thuật, thư mục cục bộ của bạn hoặc một 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 đã chọn)
- Định cấu hình URL của lệnh gọi lại, nếu cần
- Thêm hình ảnh vào màn hình trong danh mục API của bạn nếu muốn
Bước 6: Chia sẻ trách nhiệm của một ứng dụng thông qua các nhóm nhà phát triển
Nếu nhà phát triển của bạn sử dụng ứng dụng của công ty trong Drupal 7 để chia sẻ trách nhiệm cho một ứng dụng, họ có thể thực hiện chức năng tương tự thông qua nhóm nhà phát triển trên cổng thông tin tích hợp.
Nhà phát triển của bạn tạo các nhóm nhà phát triển để chia sẻ trách nhiệm về ứ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 đối với ứng dụng bằng cách sử dụng nhóm nhà phát triển (Beta).
Bạn có thể hướng dẫn cộng đồng nhà phát triển về các nhóm nhà phát triển và khuyến khích họ di chuyển ứng dụng của họ để sử dụng các nhóm nhà phát triển để chia sẻ trách nhiệm và chuyển 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ấu phần phần mềm liên quan bằng Edge API.
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 cộng đồng sau: 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 bạn ra mắt cổng thông tin tích hợp cho phiên bản chính thức, hãy cân nhắc thực hiện các bước được xác định trong bảng sau.
| Bước | Mô tả |
| Tuỳ chỉnh miền của bạ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 ý: Hiện tại, chúng tôi không cung cấp tính năng này cho cổng thông tin tích hợp kết hợp của 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 Analytics bằng cách sử dụng Google Analytics hoặc dịch vụ theo dõi Analytics tuỳ chỉnh của riêng bạn. |
| Tạo trang tìm kiếm tuỳ chỉnh | Tạo một trang tìm kiếm tuỳ chỉnh và nhúng công cụ tìm kiếm tuỳ chỉnh của Google. |