Cách người dùng cổng thông tin tương tác với cổng thông tin của bạn

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

Ngay từ đầu, cổng thông tin dành cho nhà phát triển cho phép người dùng cổng thông tin tạo tài khoản người dùng, đăng nhập và quản lý các ứng dụng sẽ sử dụng API của bạn.

Các phần sau đây mô tả cách người dùng cổng tương tác với cổng của bạn.

Đăng nhập vào cổng thông tin

Các phần sau đây mô tả cách người dùng cổng đăng nhập vào cổng tích hợp bằng thông tin xác thực người dùng (nhà cung cấp danh tính tích hợp) hoặc bằng SAML (thử nghiệm).

Nếu bạn bật cả nhà cung cấp danh tính tích hợp và SAML, thì người dùng cổng thông tin sẽ có thể chọn phương thức đăng nhập mà họ muốn.

Đăng nhập vào cổng thông tin bằng thông tin xác thực của người dùng (nhà cung cấp danh tính tích hợp)

Khi nhà cung cấp danh tính tích hợp được bật, người dùng cổng thông tin có thể đăng nhập vào cổng thông tin tích hợp bằng thông tin xác thực người dùng (tên người dùng và mật khẩu), như mô tả trong các phần sau:

Tạo tài khoản người dùng trên cổng thông tin tích hợp

Với trình cung cấp danh tính tích hợp, trước khi có thể sử dụng API của bạn, người dùng cổng thông tin phải tạo tài khoản người dùng trên cổng thông tin tích hợp.

Người dùng cổng thông tin tạo tài khoản người dùng trên cổng thông tin tích hợp như sau:

  1. Chuyển đến cổng thông tin.

  2. Nhấp vào Đăng nhập.

    Trang Đăng nhập sẽ xuất hiện.

  3. Nhấp vào Tạo tài khoản.

    Trang Tạo tài khoản sẽ xuất hiện.

    Hộp thoại tạo tài khoản

  4. Hoàn thành biểu mẫu.

    Bạn phải nhập giá trị cho tất cả các trường bắt buộc. Mật khẩu phải có ít nhất 8 ký tự và chứa ít nhất một trong các ký tự sau: số, chữ cái viết thường, chữ cái viết hoa và ký tự đặc biệt.

  5. Xem xét và đồng ý với các điều khoản.

  6. Nhấp vào Tạo tài khoản.

  7. Hoàn tất biểu mẫu CAPTCHA rồi nhấp vào Xác minh (nếu có).

    Tài khoản người dùng được tạo và email xác nhận được gửi.

  8. Trong vòng 10 phút, hãy nhấp vào đường liên kết trong email xác nhận để hoàn tất quy trình đăng ký.

    Nếu không nhấp vào đường liên kết trong vòng 10 phút, bạn phải lặp lại các bước trong quy trình này để tạo tài khoản và được nhắc lại.

  9. Đăng nhập vào cổng tích hợp (như mô tả bên dưới).

Đăng nhập vào cổng tích hợp

Với nhà cung cấp danh tính tích hợp, sau khi người dùng trang web đăng ký trên trang web tích hợp và được phê duyệt, họ sẽ đăng nhập bằng thông tin xác thực (tên người dùng và mật khẩu).

Người dùng Portal đăng nhập như sau:

  1. Chuyển đến cổng thông tin.
  2. Nhấp vào Đăng nhập. Trang Đăng nhập sẽ hiển thị: Trang đăng nhập
  3. Nhập địa chỉ email và mật khẩu.
  4. Nhấp vào Đăng nhập.

Thay đổi mật khẩu

Với nhà cung cấp danh tính tích hợp, người dùng cổng thay đổi mật khẩu như sau:

  1. Chuyển đến cổng thông tin.
  2. Nhấp vào Đăng nhập.
  3. Nhấp vào Đặt lại mật khẩu.
  4. Nhập địa chỉ email của tài khoản cần đặt lại.

  5. Nhấp vào Gửi đường liên kết đặt lại mật khẩu.

    Đường liên kết đặt lại mật khẩu sẽ được gửi đến email đó.

  6. Nhấp vào đường liên kết trong email xác nhận.

  7. Nhập mật khẩu mới rồi xác nhận.

    Mật khẩu phải có ít nhất 8 ký tự và chứa ít nhất một trong các ký tự sau: số, chữ cái viết thường, chữ cái viết hoa và ký tự đặc biệt.

  8. Nhấp vào Tạo mật khẩu mới.

Đăng nhập vào cổng thông tin bằng phương thức xác thực SAML (thử nghiệm)

Khi bạn bật Nhà cung cấp danh tính SAML, người dùng cổng thông tin sẽ đăng nhập vào cổng thông tin tích hợp bằng phương thức xác thực SAML như sau:

  1. Chuyển đến cổng thông tin.
  2. Nhấp vào Đăng nhập.

  3. Nhấp vào đăng nhập bằng SAML.

    Bạn sẽ được chuyển hướng đến nhà cung cấp SAML.

  4. Nếu được nhắc, hãy nhập thông tin xác thực của bạn cho nhà cung cấp danh tính SAML.

Xem tài liệu tham khảo API

Người dùng cổng thông tin có thể xem tài liệu tham khảo API mà bạn đã xuất bản cho cổng thông tin của mình như sau:

  1. Chuyển đến cổng thông tin.

  2. Nhấp vào API trong thanh điều hướng trên cùng. Trang API sẽ xuất hiện. Ví dụ:

    Trang API

  3. Lọc danh sách API theo danh mục, tiêu đề hoặc nội dung mô tả (nếu muốn) bằng cách sử dụng các công cụ trong ngăn bên trái.

  4. Nhấp vào một thẻ API để xem tài liệu tham khảo về API. Tài liệu tham khảo API sẽ hiển thị.

Người dùng Cổng thông tin có thể tìm hiểu và thử các API hoặc tải tài liệu dùng để hiển thị tài liệu tham khảo API xuống. Hãy xem phần Xuất bản API để biết thêm thông tin về cách hiển thị tài liệu tham khảo API.

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 (thử nghiệm)

Nhóm nhà phát triển cho phép người dùng cổng chia sẻ trách nhiệm đối với một ứng dụng với người dùng cổng khác. Các phần sau đây mô tả cách tạo và quản lý nhóm nhà phát triển.

Giới thiệu về vai trò của nhóm nhà phát triển

Bảng sau đây tóm tắt các vai trò có thể được chỉ định cho thành viên nhóm nhà phát triển:

Vai trò Mô tả
Quản trị viên ứng dụng
  • Đặc quyền chỉ đọc đối với thành viên nhóm nhà phát triển và thông tin chi tiết về nhóm nhà phát triển.
  • Quyền đọc và ghi cho ứng dụng.
Chủ sở hữu Quyền đọc và ghi đầy đủ đối với thành viên nhóm nhà phát triển, thông tin chi tiết về nhóm nhà phát triển và ứng dụng.
Người xem Đặc quyền chỉ có thể đọc đối với thành viên nhóm nhà phát triển, thông tin chi tiết về nhóm nhà phát triển và ứng dụng.

Xem trang Nhóm

Trang Nhóm hiển thị các nhóm nhà phát triển mà bạn là thành viên.

Cách truy cập vào trang Nhóm:

  1. Đăng nhập vào cổng.
  2. Chọn Nhóm trong trình đơn thả xuống về tài khoản người dùng trong cổng thông tin.

Trang Nhóm sẽ xuất hiện để bạn có thể:

Thêm nhóm nhà phát triển

Cách thêm nhóm nhà phát triển:

  1. Đăng nhập vào cổng.
  2. Chọn Teams trong trình đơn thả xuống về tài khoản người dùng trong cổng thông tin.
  3. Nhấp vào + Nhóm mới.
  4. Nhập tên và nội dung mô tả.

  5. Để thêm thành viên vào nhóm nhà phát triển, hãy nhấp vào + Thêm thành viên khác, nhập địa chỉ email của người dùng cổng thông tin rồi chọn vai trò trong nhóm nhà phát triển.

    Lặp lại để thêm thành viên khác.

  6. Để xoá một thành viên khỏi nhóm nhà phát triển, hãy nhấp vào biểu tượng biểu tượng xoá bên cạnh thành viên nhóm nhà phát triển mà bạn muốn xoá.

  7. Nhấp vào Tạo.

Chỉnh sửa vai trò và danh sách thành viên trong nhóm nhà phát triển

Cách chỉnh sửa vai trò và thành viên trong nhóm nhà phát triển:

  1. Đăng nhập vào cổng.
  2. Chọn Teams trong trình đơn thả xuống về tài khoản người dùng trong cổng thông tin.
  3. Nhấp vào hàng của nhóm nhà phát triển mà bạn muốn chỉnh sửa và bạn là chủ sở hữu của nhóm đó.

  4. Thực hiện một hoặc nhiều bước sau:

    • Chỉnh sửa tên, nội dung mô tả và người liên hệ chính.
    • Thêm hoặc xoá thành viên nhóm nhà phát triển.
    • Cập nhật vai trò của thành viên nhóm nhà phát triển.

  5. Nhấp vào Lưu.

Xoá chính bạn khỏi nhóm nhà phát triển

Cách xoá chính bạn khỏi một nhóm nhà phát triển:

  1. Đăng nhập vào cổng.
  2. Chọn Teams trong trình đơn thả xuống về tài khoản người dùng trong cổng thông tin.
  3. Nhấp vào hàng của nhóm nhà phát triển mà bạn muốn xoá mình.
  4. Nhấp vào Rời khỏi nhóm.

Xoá nhóm nhà phát triển

Cách xoá một nhóm nhà phát triển:

  1. Đăng nhập vào cổng.
  2. Chọn Teams trong trình đơn thả xuống về tài khoản người dùng trong cổng thông tin.
  3. Nhấp vào hàng của nhóm nhà phát triển mà bạn muốn xoá.
  4. Nhấp vào biểu tượng xoá.
  5. Nhấp vào Xác nhận để xác nhận việc xoá.

Đăng ký ứng dụng

Đăng ký ứng dụng dành cho nhà phát triển và ứng dụng dành cho nhóm nhà phát triển, như mô tả trong các phần sau.

Đăng ký ứng dụng của nhà phát triển

Người dùng Trang tổng quan có thể đăng ký ứng dụng để sử dụng các API mà bạn đã phát hành như sau:

  1. Chọn Ứng dụng trong trình đơn thả xuống về tài khoản người dùng.
  2. Nhấp vào + New App (+ Ứng dụng mới) để tạo ứng dụng mới.
  3. Nhập tên và nội dung mô tả cho ứng dụng trong hộp thoại Ứng dụng mới.

  4. Chọn chủ sở hữu của Ứng dụng trong danh sách thả xuống Chủ sở hữu.

    Theo mặc định, bạn là chủ sở hữu của ứng dụng. Nếu muốn, hãy chọn một nhóm nhà phát triển trong trình đơn thả xuống để chia sẻ trách nhiệm về ứng dụng với các thành viên khác trong nhóm nhà phát triển. Xem phần 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 (thử nghiệm).

  5. Trong mục Danh mục API, hãy chọn một hoặc nhiều API.

    Các API trong danh mục được phân loại là API đã xác thực, yêu cầu URL gọi lại hoặc API công khai. Bạn phải chọn ít nhất một API để tạo ứng dụng.

  6. Nếu bạn chọn một API trong mục API đã xác thực, hãy nhập URL gọi lại.

    Để biết thêm thông tin, hãy xem bài viết Giới thiệu về URL lệnh gọi lại.

  7. Nhấp vào Tạo.

Đăng ký ứng dụng của nhóm nhà phát triển

Các thành viên trong nhóm nhà phát triển có thể đăng ký ứng dụng cho một nhóm nhà phát triển để sử dụng các API mà bạn đã phát hành, như mô tả bên dưới.

Để tìm hiểu thêm về cách:

Cách đăng ký ứng dụng của nhóm nhà phát triển:

  1. Chọn Nhóm trong trình đơn thả xuống về tài khoản người dùng.
  2. Nhấp vào hàng của nhóm nhà phát triển mà bạn muốn đăng ký ứng dụng.
  3. Nhấp vào + New App (+ Ứng dụng mới) để tạo ứng dụng mới.
  4. Nhập tên và nội dung mô tả cho ứng dụng trong hộp thoại Ứng dụng mới.

  5. Chọn chủ sở hữu của Ứng dụng trong danh sách thả xuống Chủ sở hữu.

    Theo mặc định, nhóm nhà phát triển là chủ sở hữu của ứng dụng. Nếu muốn, hãy chọn một nhóm nhà phát triển khác hoặc chính bạn làm chủ sở hữu trong trình đơn thả xuống.

  6. Trong mục Danh mục API, hãy chọn một hoặc nhiều API.

    Các API trong danh mục được phân loại là API đã xác thực, yêu cầu URL gọi lại hoặc API công khai. Bạn phải chọn ít nhất một API để tạo ứng dụng.

  7. Nếu bạn chọn một API trong mục API đã xác thực, hãy nhập URL gọi lại.

    Để biết thêm thông tin, hãy xem bài viết Giới thiệu về URL lệnh gọi lại.

  8. Nhấp vào Tạo.

Quản lý các API trong ứng dụng

Là nhà sản xuất API, bạn phát hành API để cho phép người dùng cổng thông tin sử dụng các sản phẩm API của bạn.

Người dùng cổng thông tin quản lý những API mà ứng dụng của họ sử dụng. Các API được thêm vào trang chi tiết ứng dụng. Đối với một số API, việc phê duyệt không phải là tự động. Trạng thái Đang chờ phê duyệt cho biết một API đã được yêu cầu quyền truy cập nhưng chưa được cấp.

Người dùng cổng thông tin có thể quản lý các API trong một ứng dụng từ cổng thông tin của bạn như sau:

  1. Chọn Ứng dụng trong trình đơn thả xuống về tài khoản người dùng.
  2. Nhấp vào ứng dụng trong danh sách.
  3. Trong phần API, hãy nhấp vào biểu tượng bật hoặc biểu tượng tắt để bật hoặc tắt quyền truy cập vào một API từ ứng dụng.
  4. Đối với API đã xác thực, hãy thêm hoặc chỉnh sửa URL gọi lại (nếu cần).

Xem khoá API và khoá bí mật cho một ứng dụng

Người dùng cổng thông tin có thể quản lý khoá API cho một ứng dụng trên cổng thông tin của bạn như sau:

  1. Chọn Ứng dụng trong trình đơn thả xuống về tài khoản người dùng.
  2. Nhấp vào ứng dụng trong danh sách.
  3. Xem khoá API trong mục Khoá API.
  4. Xác nhận rằng trạng thái của khoá API là Đang hoạt động. Nếu khoá API của bạn cần được phê duyệt và chưa được phê duyệt, thì trạng thái sẽ là Đang chờ phê duyệt.
  5. Nhấp vào Hiện mã thông báo bí mật để xem mã thông báo bí mật.
  6. Đặt con trỏ lên khoá API hoặc khoá bí mật rồi nhấp vào delete-icon để sao chép khoá đó vào bảng nhớ tạm.

Xoay khoá API cho một ứng dụng

Người dùng cổng thông tin có thể xoay vòng khoá API của ứng dụng theo định kỳ hoặc để phản hồi một sự cố rò rỉ hoặc xâm phạm tiềm ẩn. Khi người dùng cổng thông tin xoay vòng khoá API, một khoá API mới sẽ được tạo với các quyền API giống như khoá ban đầu. Khoá API ban đầu vẫn hoạt động trong khi bạn chuyển sang không sử dụng khoá đó. Bạn phải thu hồi khoá API cũ để không chấp nhận thông tin xác thực của khoá đó, như mô tả trong phần Thu hồi khoá API cho ứng dụng.

Người dùng cổng thông tin có thể xoay vòng khoá API cho một ứng dụng trên cổng thông tin của bạn như sau:

  1. Chọn Ứng dụng trong trình đơn thả xuống về tài khoản người dùng.
  2. Nhấp vào ứng dụng trong danh sách.
  3. Trong phần Khoá API, hãy nhấp vào Thêm khoá.
  4. Nhấp vào Xác nhận trong hộp thoại để xác nhận thao tác.
  5. Bạn có thể thu hồi khoá API cũ (không bắt buộc), như mô tả bên dưới.

Thu hồi khoá API cho một ứng dụng

Khi người dùng cổng thông tin xoay vòng khoá API, như mô tả trong phần trước, khoá API vẫn hoạt động trong khi bạn chuyển đổi khoá đó sang trạng thái không sử dụng. Bạn phải thu hồi khoá API để thông tin xác thực của khoá đó không được chấp nhận.

Người dùng cổng thông tin có thể thu hồi khoá API cho một ứng dụng khỏi cổng thông tin của bạn như sau:

  1. Chọn Ứng dụng trong trình đơn thả xuống về tài khoản người dùng.
  2. Nhấp vào tên ứng dụng.
  3. Trong mục Khoá API, hãy nhấp vào biểu tượng biểu tượng thu hồi trong cột Thao tác liên kết với khoá API mà bạn muốn thu hồi.

  4. Nhấp vào Xác nhận để xác nhận thao tác.

    Trạng thái của khoá được cập nhật thành Bị thu hồi.

Chỉnh sửa thông tin chi tiết về ứng dụng

Người dùng Cổng thông tin có thể chỉnh sửa thông tin chi tiết về ứng dụng như sau:

  1. Chọn Ứng dụng trong trình đơn thả xuống về tài khoản người dùng.
  2. Nhấp vào ứng dụng trong danh sách.
  3. Chỉnh sửa trường Tên hoặc Nội dung mô tả trên thẻ Chi tiết ứng dụng.
  4. Quản lý các API trong ứng dụng (nếu cần).
  5. Nhấp vào Lưu.

Xóa ứng dụng

Người dùng cổng thông tin có thể xoá một ứng dụng khỏi cổng thông tin của bạn như sau:

  1. Chọn Ứng dụng trong trình đơn thả xuống về tài khoản người dùng.
  2. Nhấp vào ứng dụng trong danh sách.
  3. Nhấp vào XOÁ.
  4. Nhấp vào Xác nhận để xác nhận thao tác.

Ứng dụng sẽ bị xoá và bị xoá khỏi danh sách Ứng dụng.