Canva 관리자 API 설정 및 사용

Canva Admin API를 사용하면 자체 시스템에서 조직 관리를 자동화할 수 있습니다. 사용자를 관리하고, 팀과 그룹 및 멤버십을 관리하며, Canva에서 직접 수동으로 처리하지 않고도 감사 로그 이벤트를 가져올 수 있습니다.

• Canva Enterprise, Canva Districts 및 대학용 Canva에서 사용할 수 있습니다.
• 조직 관리자만 사용할 수 있습니다.
• 단일 팀 및 여러 팀으로 구성된 조직에서 사용할 수 있습니다.

Admin API를 설정하기 전에 조직이 다음 요구 사항을 충족하는지 확인하세요:

• 조직 수준: Admin API는 조직 단위로 적용됩니다. Canva Enterprise, Canva Districts 및 대학용 Canva 요금제를 사용하는 단일 팀 및 여러 팀으로 구성된 조직에서 사용할 수 있습니다.
• 조직 관리자 계정: 조직 관리자만 Canva 설정에서 Admin API 클라이언트를 만들고 관리할 수 있습니다.
• 내부 또는 외부 엔지니어링 리소스: 조직에서 통합을 구축하고 유지 관리할 수 있는 엔지니어링 리소스를 확보해야 합니다. Canva는 구현 지원을 제공하지 않습니다.
  • 팀에서 API 기반 통합을 구축할 수 없다면, 조직의 사용자 관리를 자동화하는 데는 SCIM 프로비저닝이 더 적합합니다.
• Canva 조직 구조에 대한 이해: 통합을 구축하기 전에 Canva에서 조직, 팀, 그룹이 어떻게 구성되어 있는지 명확히 파악하세요.
• 다중 인증(MFA) 또는 통합 인증(SSO) 관리 계정: Admin API를 설정하는 조직 관리자는 MFA를 사용 설정했거나 SSO로 관리되는 계정을 사용해야 합니다. 해당 계정은 관리자를 대신해 작업을 수행하는 조직에서 관리하거나 소유해야 합니다.

Admin API는 다음 작업을 위한 엔드포인트를 제공합니다.

• 사용자, 팀, 그룹: 만들기, 조회, 업데이트, 삭제
• 멤버십: 팀과 그룹에 팀원을 추가하거나 제거하고 역할을 설정합니다.
• 감사 로그: 감사 로그 이벤트를 예약해 가져옵니다.
• 팀 초대: 팀에 팀원을 초대하고(조직 외부의 팀원 포함), 대기 중인 초대를 확인하고, 정확한 이메일 주소로 기존 초대 링크를 가져오고, 초대를 취소합니다.

조직 관리자가 Admin API 클라이언트를 만들고 이를 사용해 API를 호출합니다.

클라이언트 자격 증명을 액세스 토큰으로 교환하고 API 요청을 시작하려면 Canva Admin API 문서화를 따르세요.

API 요청 인증 및 OAuth 2.0 전달자 토큰 사용에 관한 기술 세부 정보를 확인하려면 Canva Admin API 인증 문서를 엔지니어링 팀과 공유하세요.

Admin API를 통해 수행된 작업은 해당 API 클라이언트를 호출한 개별 관리자가 아니라 Admin API 클라이언트의 작업으로 기록됩니다.

감사 로그의 Actor 필드에는 Admin API 클라이언트 이름과 클라이언트 ID가 표시됩니다. 이를 통해 어떤 통합 기능이 작업을 수행했는지 확인할 수 있습니다.

특정 API 클라이언트를 만들거나 업데이트하거나 삭제한 조직 관리자도 확인할 수 있습니다.

자세한 내용은 Canva 감사 로그 정보를 참조하세요.

조직 관리자는 Admin API를 사용해 조직 외부의 협업자를 포함한 팀원을 팀에 초대할 수 있습니다.

알아둘 점

• 초대 하나는 팀 하나와 이메일 주소 하나에만 해당합니다.
• 초대는 한 번만 사용할 수 있으며, 30일 후 만료됩니다.
• 설정에 따라 Canva가 초대 대상자에게 이메일을 자동으로 보내지 않을 수 있습니다. 필요한 경우 초대 링크를 초대 대상자에게 직접 공유하세요.
• 초대 링크를 비공개로 유지하세요. 초대 링크는 해당 링크를 만든 이메일 주소로만 사용할 수 있습니다.
• 초대하는 팀원에게도 팀의 기존 초대 및 도메인 설정이 적용됩니다.
• 초대 대상자에게 대기 중인 초대가 이미 있는 경우 새 초대를 만들면 기존 초대 기록이 반환됩니다. 만료일은 요청일로부터 30일 후로 재설정되고, 초대 역할은 요청한 역할로 업데이트됩니다.

엔드포인트 세부 정보는 Canva Admin API 문서를 참조하세요.

Admin API와 SCIM 모두 사용자 프로비저닝을 지원합니다.

Admin API는 사용자 프로비저닝 외에도 팀, 그룹, 멤버십, 감사 로그 등 Canva 조직 관리를 지원합니다.

SCIM은 표준 프로비저닝과 프로비저닝 해제를 지원합니다. 표준 사용자 프로비저닝만 필요하거나 팀에서 맞춤 API 통합을 구축할 수 없다면 SCIM이 더 적합합니다.

Admin API를 사용하려면 조직에 개발자가 있어야 하나요?

예. Admin API를 사용하려면 조직에서 통합을 구축하고 유지 관리할 수 있는 내부 또는 외부 엔지니어링 리소스를 확보해야 합니다. Canva는 구현 지원을 제공하지 않습니다. 팀에서 API 기반 통합을 구축할 수 없다면, 조직의 사용자 관리를 자동화하는 데는 SCIM 프로비저닝이 더 적합합니다.

조직의 모든 구성원이 Admin API를 사용하기 위해 MFA 또는 SSO를 사용해야 하나요?

아니요. Admin API를 설정하는 조직 관리자만 MFA를 사용 설정했거나 SSO로 관리되는 계정을 사용해야 합니다. 해당 계정은 관리자를 대신해 작업을 수행하는 조직에서 관리하거나 소유해야 합니다. 다른 조직 구성원은 Admin API를 사용하기 위해 별도로 MFA나 SSO를 사용할 필요가 없습니다.

조직에서 Admin API를 사용해 외부 협업자를 초대할 수 있나요?

예. 조직 관리자는 Admin API를 사용해 외부 협업자를 포함한 팀원을 팀에 초대할 수 있습니다. 초대하는 팀원에게도 팀의 기존 초대 및 도메인 설정이 적용됩니다.

새 초대를 만들지 않고 기존 초대 링크를 다시 가져올 수 있나요?

예. 새 초대를 만들지 않고 초대 대상자의 정확한 이메일 주소를 사용해 기존 초대 링크를 가져올 수 있습니다.