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 riêng. Quản lý người dùng, đội, nhóm và tư cách thành viên, đồng thời truy xuất sự kiện trong nhật ký kiểm tra mà không cần thực hiện những việc này thủ công trong Canva.

• Dành cho Canva Doanh nghiệp lớn, Canva Districts và Canva cho Đại học.
• Quản trị viên tổ chức có thể truy cập.
• Dành 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 được giới hạn ở cấp tổ chức. API này dành 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 khách 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ì hoạt động tích hợp. Canva không cung cấp hỗ trợ triển khai.
  • Nếu đội của bạn không thể xây dựng tích hợp với 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 bạn: 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 trước khi xây dựng hoạt động tích hợp.
• 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.
• Tư cách thành viên: Thêm hoặc xóa thành viên khỏi đội và nhóm, đồng thời đặt vai trò cho họ.
• Nhật ký kiểm tra: Truy xuất sự kiện trong nhật ký kiểm tra theo lịch.
• Lời mời tham gia đội: Mời mọi người vào đội (kể cả những người 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 khách Admin API và dùng ứng dụng đó để gọi API.

Làm theo tài liệu Canva Admin API hướng dẫn để đổi thông tin xác thực ứng dụng khách lấy mã thông báo 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 được thực hiện thông qua Admin API sẽ được ghi nhận cho ứng dụng khách 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 khách Admin API. Nhờ đó, bạn có thể xác định hoạt động 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 khách API cụ thể.

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, kể 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 vào 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ọ.
• Hãy giữ riêng tư các liên kết lời mời. Mỗi liên kết chỉ dùng được với địa chỉ email đã tạo lời mờ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.
• Nếu đã có lời mời đang chờ xử lý cho người được mời, việc tạo lời mời mới 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ò của 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 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, bao gồm đội, nhóm, tư cách 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 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ó. Để sử dụng Admin API, 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ì hoạt động tích hợp. Canva không cung cấp hỗ trợ triển khai. Nếu đội của bạn không thể xây dựng tích hợp với 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 để sử dụng Admin API.

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, kể 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.