Thiết lập và sử dụng API quản trị viên của Canva

Bạn có thể dùng Canva Admin API để tự động hóa việc quản lý tổ chức từ các hệ thống của riêng mình. Quản lý người dùng, đội, nhóm và thành viên, đồng thời truy xuất sự kiện nhật ký kiểm tra mà không cần thực hiện thủ công các việc này trong Canva.

• Khả dụng với Canva Doanh nghiệp lớn, Canva Districts và Canva cho Đại học.
• Quản trị viên tổ chức có thể sử dụng.
• Khả dụng cho các tổ chức có một đội hoặc nhiều đội.

Trước khi thiết lập Admin API, hãy đảm bảo tổ chức của bạn đáp ứng các yêu cầu sau:

• Cấp độ tổ chức: Admin API áp dụng ở cấp tổ chức. Tính năng này khả dụng cho các tổ chức có một đội hoặc nhiều đội sử dụng gói Canva Doanh nghiệp lớn, Canva Districts và Canva cho Đại học.
• Tài khoản quản trị viên tổ chức: Chỉ quản trị viên tổ chức mới có thể tạo và quản lý ứng dụng Admin API trong phần cài đặt Canva.
• Đội ngũ kỹ thuật nội bộ hoặc thuê ngoài: Tổ chức của bạn cần có nguồn lực kỹ thuật để xây dựng và duy trì tích hợp. Canva không hỗ trợ triển khai.
  • Nếu đội của bạn không thể xây dựng tích hợp bằng API, cấp tài nguyên SCIM sẽ phù hợp hơn để tự động hóa việc quản lý người dùng trong tổ chức.
• Am hiểu cấu trúc Canva của tổ chức: Trước khi xây dựng tích hợp, hãy tìm hiểu rõ cách tổ chức, các đội và nhóm được thiết lập trong Canva.
• Tài khoản được quản lý bằng Xác thực đa yếu tố (MFA) hoặc Đăng nhập một lần (SSO): Quản trị viên tổ chức thiết lập Admin API phải bật MFA hoặc sử dụng tài khoản được quản lý bằng SSO. Tài khoản phải do tổ chức mà họ đại diện quản lý hoặc sở hữu.

Admin API cung cấp các điểm cuối để:

• Người dùng, đội và nhóm: Tạo, đọc, cập nhật và xóa.
• Thành viên: Thêm hoặc xóa người khỏi đội và nhóm, đồng thời thiết lập vai trò cho họ.
• Nhật ký kiểm tra: Định kỳ truy xuất các sự kiện nhật ký kiểm tra.
• Lời mời vào đội: Mời mọi người vào đội (bao gồm cả những người bên ngoài tổ chức), xem lời mời đang chờ xử lý, truy xuất liên kết lời mời hiện có bằng địa chỉ email chính xác và hủy lời mời.

Quản trị viên tổ chức tạo ứng dụng Admin API và dùng ứng dụng đó để gọi API.

Làm theo tài liệu về Canva Admin API để trao đổi thông tin xác thực ứng dụng lấy mã token truy cập và bắt đầu gửi yêu cầu API.

Để biết chi tiết kỹ thuật về cách xác thực yêu cầu API và sử dụng mã thông báo bearer OAuth 2.0, hãy chia sẻ tài liệu Xác thực Canva Admin API với đội ngũ kỹ thuật của bạn.

Các thao tác thực hiện thông qua Admin API được ghi nhận cho ứng dụng Admin API thay vì cho từng quản trị viên gọi ứng dụng đó.

Trong nhật ký kiểm tra, trường Actor hiển thị tên và mã ứng dụng của ứng dụng Admin API. Nhờ đó, bạn có thể xác định tích hợp nào đã thực hiện thao tác.

Bạn cũng có thể xác định quản trị viên tổ chức đã tạo, cập nhật hoặc xóa một ứng dụng API cụ thể.

Để biết thêm thông tin, hãy xem Giới thiệu về nhật ký kiểm tra của Canva.

Quản trị viên tổ chức có thể dùng Admin API để mời mọi người vào đội, bao gồm cả cộng tác viên bên ngoài tổ chức.

Những điều cần biết

• Mỗi lời mời bạn tạo dành cho một đội và một địa chỉ email.
• Mỗi lời mời chỉ dùng được một lần và sẽ hết hạn sau 30 ngày.
• Tùy theo thiết lập, Canva có thể không tự động gửi email cho người được mời. Nếu cần, hãy chia sẻ trực tiếp liên kết lời mời với họ.
• Giữ kín các liên kết lời mời. Mỗi liên kết chỉ có hiệu lực với địa chỉ email mà liên kết đó được tạo cho.
• Các thiết lập lời mời và tên miền hiện có của đội bạn vẫn áp dụng cho những người được mời.
• Nếu đã có lời mời đang chờ xử lý cho người được mời, khi tạo lời mời mới, hệ thống sẽ trả về cùng một bản ghi lời mời, đặt lại thời hạn thành 30 ngày kể từ khi gửi yêu cầu và cập nhật vai trò trong lời mời theo vai trò được yêu cầu.

Để biết chi tiết về điểm cuối, hãy xem tài liệu về Canva Admin API.

Cả Admin API và SCIM đều hỗ trợ cấp tài nguyên cho người dùng.

Admin API hỗ trợ quản lý tổ chức Canva ngoài việc cấp tài nguyên cho người dùng. Các nội dung này bao gồm đội, nhóm, thành viên và nhật ký kiểm tra.

SCIM hỗ trợ cấp và thu hồi tài nguyên theo tiêu chuẩn. Nếu bạn chỉ cần cấp tài nguyên cho người dùng theo tiêu chuẩn hoặc đội của bạn không thể xây dựng tích hợp API tùy chỉnh, SCIM sẽ phù hợp hơn với nhu cầu của bạn.

Tổ chức của tôi có cần nhà phát triển để sử dụng Admin API không?

Có. Tổ chức của bạn cần có nguồn lực kỹ thuật nội bộ hoặc thuê ngoài để xây dựng và duy trì tích hợp Admin API. Canva không hỗ trợ triển khai. Nếu đội của bạn không thể xây dựng tích hợp bằng API, cấp tài nguyên SCIM sẽ phù hợp hơn để tự động hóa việc quản lý người dùng trong tổ chức.

Mọi người trong tổ chức của tôi có cần MFA hoặc SSO để sử dụng Admin API không?

Không. Chỉ quản trị viên tổ chức thiết lập Admin API mới cần bật MFA hoặc sử dụng tài khoản được quản lý bằng SSO. Tài khoản phải do tổ chức mà họ đại diện quản lý hoặc sở hữu. Các thành viên khác trong tổ chức không cần MFA hoặc SSO để Admin API hoạt động.

Tổ chức của tôi có thể dùng Admin API để mời cộng tác viên bên ngoài không?

Có. Quản trị viên tổ chức có thể dùng Admin API để mời mọi người vào đội, bao gồm cả cộng tác viên bên ngoài. Các thiết lập lời mời và tên miền hiện có của đội bạn vẫn áp dụng cho những người được mời.

Chúng tôi có thể truy xuất lại liên kết lời mời hiện có mà không cần tạo lời mời mới không?

Có. Bạn có thể truy xuất liên kết lời mời hiện có bằng địa chỉ email chính xác của người được mời mà không cần tạo lời mời mới.