Cách nhà phát triển ứng dụng tương tác với cổng thông tin của bạn (phiên bản gốc)

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 lập tức, cổng thông tin dành cho nhà phát triển cho phép nhà phát triển ứng dụng của bạn đăng ký, đăng nhập và quản lý những ứng dụng sẽ sử dụng API của bạn.

Các phần sau đây mô tả cách nhà phát triển ứng dụng tương tác với cổng của bạn:

Cách theo dõi hoạt động đăng ký và đăng nhập của nhà phát triển ứng dụng trong Edge

Bạn có thể theo dõi quy trình đăng ký nhà phát triển và đăng nhập cổng thông tin bằng thuộc tính tuỳ chỉnh _apiportal trong Edge.

Khi nhà phát triển tự đăng ký, thuộc tính tuỳ chỉnh _apiportal sẽ được thêm vào cấu hình nhà phát triển và trạng thái nhà phát triển được đặt thành unverified để cho biết nhà phát triển chưa đăng nhập vào cổng thông tin. Ví dụ: {"status":"unverified","portals":{}}

Lần đầu tiên nhà phát triển đăng nhập vào một cổng thông tin, thuộc tính tuỳ chỉnh _apiportal sẽ được cập nhật để theo dõi tên cổng thông tin và thời gian truy cập, đồng thời đặt trạng thái nhà phát triển thành active. Mỗi lần nhà phát triển đăng nhập vào cổng thông tin, thuộc tính tùy chỉnh được cập nhật để đặt lại giá trị lastVisit (ở định dạng thời gian bắt đầu của hệ thống) cho cổng đó. Ví dụ: {"status":"active","portals":{"myorg-myportal":{"lastVisit":1480972935}}}

Đăng ký tài khoản nhà phát triển ứng dụng

Trước khi có thể sử dụng API của bạn, nhà phát triển ứng dụng phải đăng ký bằng cách tạo tài khoản.

Khi nhà phát triển ứng dụng đăng ký qua cổng thông tin của bạn:

Ngoài ra, bạn có thể thay mặt họ đăng ký nhà phát triển ứng dụng bằng cách sử dụng giao diện người dùng Edge, như mô tả trong phần Đăng ký nhà phát triển ứng dụng.

Nhà phát triển ứng dụng mới có thể tự đăng ký qua cổng thông tin của bạn 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 ký.
    Hộp thoại sau đây sẽ xuất hiện.

    Tạo tài khoản

  4. Nhập thông tin bắt buộc (họ, tên và địa chỉ email).

  5. Nhấp vào Tạo.
    Hộp thoại sau đây sẽ xuất hiện.

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

  6. Nhấp vào đường liên kết bảo mật trong email để mở cổng thông tin và thiết lập phiên được xác thực.

Đăng nhập vào cổng thông tin của bạn

Sau khi nhà phát triển ứng dụng đăng ký bằng cổng thông tin của bạn, họ sẽ đăng nhập bằng trang Đăng nhập.

Mỗi lần nhà phát triển ứng dụng đăng nhập vào một cổng thông tin, thay vì sử dụng thông tin bí mật dùng chung như mật khẩu để xác thực nhà phát triển, một đường liên kết bảo mật sẽ được gửi để xác minh danh tính và thiết lập một phiên với cổng thông tin.

Nhà phát triển ứng dụng có thể đăng nhập vào cổng thông tin của bạn bằng cách làm như sau:

  1. Chuyển đến cổng thông tin.
  2. Nhấp vào Đăng nhập.
  3. Nhập địa chỉ email liên kết với tài khoản đó.
  4. Nhấp vào Đăng nhập.
    Hộp thoại sau đây sẽ xuất hiện.

    Đăng nhập vào cổng

  5. Nhấp vào đường liên kết bảo mật trong email để mở cổng thông tin và thiết lập phiên được xác thực.

Đăng ký ứng dụng

Sau khi đăng nhập vào cổng thông tin, nhà phát triển ứng dụng có thể đăng ký ứng dụng để sử dụng các sản phẩm API mà bạn đã phát hành, cụ thể như sau:

  1. Chọn Ứng dụng của tôi từ trình đơn thả xuống người dùng.
  2. Nhấp vào + Ứng dụng để tạo ứng dụng mới.
  3. Nhập tên và thông tin mô tả cho ứng dụng trong hộp thoại Create App (Tạo ứng dụng).
  4. Nhấp vào Tạo.
  5. Quản lý các sản phẩm API trong ứng dụng theo mô tả dưới đây.

Quản lý các sản phẩm API trong ứng dụng

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

Nhà phát triển ứng dụng có thể quản lý các sản phẩm API trong ứng dụng trên cổng thông tin của bạn như sau:

  1. Chọn Ứng dụng của tôi từ trình đơn thả xuống người dùng.
  2. Nhấp vào tên ứng dụng.
  3. Nhấp vào Quản lý sản phẩm.
  4. Nhấp vào nút bật/tắt Quyền truy cập để bật hoặc tắt quyền truy cập vào một sản phẩm API trong ứng dụng.

    Lưu ý: Nếu nhà phát triển ứng dụng vô hiệu hoá quyền truy cập vào sản phẩm API Chỉ riêng tư hoặc Nội bộ, thì sản phẩm API đó sẽ bị xoá khỏi ứng dụng và phải được quản trị viên cổng thêm lại theo cách thủ công, như mô tả trong phần Đăng ký ứng dụng và quản lý khoá API.

  5. Nhấp vào Yêu cầu để yêu cầu phê duyệt cho một sản phẩm API chưa được cho phép.

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

Xem khoá API của một ứng dụng

Nhà phát triển ứng dụng 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 của tôi từ trình đơn thả xuống người dùng.
  2. Nhấp vào tên ứng dụng.
  3. Xem khoá API trong phần Khoá.
  4. Nhấp vào Xem khoá bí mật để hiển thị khoá bí mật API.
  5. Xác nhận rằng trạng thái của khoá API là Đã phê duyệt.

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

Nhà phát triển ứng dụng có thể xoay vòng khoá API của ứng dụng theo định kỳ hoặc để ứng phó với nguy cơ rò rỉ hoặc xâm phạm. Khi nhà phát triển ứng dụng xoay vòng khoá API, khoá API mới sẽ được tạo có cùng các quyền đối với sản phẩm API như khoá ban đầu. Khoá API gốc được đánh dấu là không dùng nữa, nhưng vẫn hoạt động trong khi bạn chuyển đổi. Bạn phải huỷ kích hoạt khoá không dùng nữa để ngăn thông tin xác thực của khoá đó được chấp nhận, như mô tả trong bài viết Huỷ kích hoạt khoá API cho ứng dụng.

Nhà phát triển ứng dụng có thể xoay vòng khoá API chính cho ứng dụng trên cổng thông tin của bạn như sau:

  1. Chọn Ứng dụng của tôi từ trình đơn thả xuống người dùng.
  2. Nhấp vào tên ứng dụng.
  3. Trong phần Khoá, hãy đặt con trỏ lên khoá API hiện tại để hiển thị trình đơn thao tác.
  4. Nhấp vào Biểu tượng mở rộng để mở rộng trình đơn thao tác.
  5. Nhấp vào Xoay.
  6. Nhấp vào Tạo trong hộp thoại để xác nhận thao tác.
  7. Nếu muốn, hãy huỷ kích hoạt khoá API, theo mô tả dưới đây.

Huỷ kích hoạt khoá API cho ứng dụng

Khi nhà phát triển ứng dụng xoay vòng khoá API, như mô tả trong phần trước, khoá API đó được đánh dấu là không dùng nữa, nhưng vẫn hoạt động trong khi bạn chuyển đổi. Bạn phải huỷ kích hoạt một khoá không dùng nữa để ngăn thông tin xác thực của khoá đó được chấp nhận.

Nhà phát triển ứng dụng có thể huỷ kích hoạt khoá API cho một ứng dụng qua cổng thông tin của bạn bằng cách làm như sau:

  1. Chọn Ứng dụng của tôi từ trình đơn thả xuống người dùng.
  2. Nhấp vào tên ứng dụng.
  3. Trong phần Khoá, hãy nhấp vào Nhật ký phím để xem danh sách các phím không dùng nữa.
  4. Đặt con trỏ lên khoá API không dùng nữa mà bạn muốn huỷ kích hoạt để hiển thị trình đơn thao tác.
  5. Nhấp vào Biểu tượng mở rộng để mở rộng trình đơn thao tác.
  6. Nhấp vào Hủy kích hoạt.
  7. Nhấp vào Huỷ kích hoạt để xác nhận thao tác.
    Trạng thái của khoá được cập nhật thành Đã thu hồi.

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

Nhà phát triển ứng dụng có thể chỉnh sửa thông tin chi tiết về ứng dụng như sau:

  1. Chọn Ứng dụng của tôi từ trình đơn thả xuống người dùng.
  2. Nhấp vào tên ứng dụng.
  3. Chỉnh sửa trường Tên hoặc Mô tả.
  4. Nhấp vào Lưu.

Ứng dụng đó sẽ bị xoá và loại bỏ khỏi danh sách Ứng dụng của tôi.

Xóa ứng dụng

Nhà phát triển ứng dụng có thể xoá ứng dụng khỏi cổng thông tin của bạn bằng cách làm như sau:

  1. Chọn Ứng dụng của tôi từ trình đơn thả xuống người dùng.
  2. Nhấp vào tên ứng dụng.
  3. Nhấp vào xoá ở góc trên bên phải của trang.

Ứng dụng đó sẽ bị xoá và loại bỏ khỏi danh sách Ứng dụng của tôi.