Configurar e usar a API do Canva Admin

Você pode usar a API Admin do Canva para automatizar o gerenciamento da organização pelos seus próprios sistemas. Gerencie usuários, equipes, grupos e associações, além de recuperar eventos do registro de auditoria, sem precisar realizar essas tarefas manualmente no Canva.

• Disponível para Canva Enterprise, Canva Distritos e Canva Universidades.
• Acessível para administradores da organização.
• Disponível para organizações com uma ou várias equipes.

Antes de configurar a API Admin, verifique se sua organização atende a estes requisitos:

• Camada da organização: A API Admin é vinculada à organização. Ela está disponível para organizações com uma ou várias equipes nos planos Canva Enterprise, Canva Distritos e Canva Universidades.
• Conta de administrador da organização: Somente administradores da organização podem criar e gerenciar clientes da API Admin nas configurações do Canva.
• Equipe de engenharia interna ou terceirizada: sua organização precisa de recursos de engenharia para desenvolver e manter a integração. O Canva não oferece suporte à implementação.
  • Se sua equipe não puder desenvolver uma integração com uma API, o provisionamento SCIM é mais adequado para automatizar o gerenciamento de usuários na sua organização.
• Familiaridade com a estrutura do Canva: antes de desenvolver a integração, entenda claramente como sua organização, suas equipes e seus grupos estão estruturados no Canva.
• Autenticação multifator (MFA) ou conta gerenciada por início único de sessão (SSO): o administrador da organização que configurar a API Admin precisa ter a MFA ativada ou usar uma conta gerenciada por SSO. A conta precisa ser gerenciada ou pertencer à organização que representa.

A API Admin oferece endpoints para:

• Usuários, equipes e grupos: criar, consultar, atualizar e excluir.
• Associações: adicionar ou remover pessoas de equipes e grupos e definir suas funções.
• Registros de auditoria: recuperar eventos do registro de auditoria de forma programada.
• Convites para equipes: convidar pessoas para uma equipe (inclusive pessoas de fora da sua organização), visualizar convites pendentes, recuperar um link de convite existente usando o endereço de e-mail exato e cancelar convites.

Um administrador da organização cria um cliente da API Admin e o usa para fazer chamadas à API.

Siga a documentação da API Admin do Canva para trocar as credenciais do cliente por um token de acesso e começar a fazer solicitações à API.

Para conferir detalhes técnicos sobre a autenticação de solicitações à API e o uso de tokens de acesso do OAuth 2.0, compartilhe a documentação de autenticação da API Admin do Canva com sua equipe de engenharia.

As ações realizadas pela API Admin são registradas em nome do cliente da API Admin, e não do administrador que o acionou.

Nos registros de auditoria, o campo Ator mostra o nome e o ID do cliente da API Admin. Isso ajuda você a identificar qual integração realizou uma ação.

Você também pode identificar o administrador da organização que criou, atualizou ou excluiu um cliente específico da API.

Para saber mais, consulte Sobre os registros de auditoria do Canva.

Administradores da organização podem usar a API Admin para convidar pessoas para uma equipe, inclusive colaboradoras externas à organização.

O que você precisa saber

• Cada convite criado é para uma equipe e um endereço de e-mail.
• Cada convite pode ser usado uma vez e expira após 30 dias.
• Dependendo da sua configuração, o Canva talvez não envie o convite automaticamente por e-mail. Se necessário, compartilhe o link do convite diretamente com a pessoa convidada.
• Mantenha os links de convite privados. Cada link só funciona para o endereço de e-mail para o qual foi criado.
• As configurações atuais de convite e domínio da sua equipe também se aplicam às pessoas convidadas.
• Se já houver um convite pendente para a pessoa, criar um novo convite retornará o mesmo registro, redefinirá o prazo de validade para 30 dias a partir da solicitação e atualizará a função da pessoa para a função solicitada.

Para ver os detalhes dos endpoints, consulte a documentação da API Admin do Canva.

Tanto a API Admin quanto o SCIM podem oferecer suporte ao provisionamento de usuários.

A API Admin permite gerenciar outros aspectos da organização no Canva, além do provisionamento de usuários, como equipes, grupos, associações e registros de auditoria.

O SCIM oferece suporte ao provisionamento e desprovisionamento padrão. Se você precisa apenas do provisionamento padrão de usuários ou se sua equipe não pode desenvolver uma integração de API personalizada, o SCIM é mais adequado às suas necessidades.

Minha organização precisa de uma pessoa desenvolvedora para usar a API Admin?

Sim. Para usar a API Admin, sua organização precisa de recursos de engenharia internos ou terceirizados para desenvolver e manter a integração. O Canva não oferece suporte à implementação. Se sua equipe não puder desenvolver uma integração com uma API, o provisionamento SCIM é mais adequado para automatizar o gerenciamento de usuários na sua organização.

Todas as pessoas da minha organização precisam usar MFA ou SSO para usar a API Admin?

Não. Apenas o administrador da organização que configurar a API Admin precisa ter a MFA ativada ou usar uma conta gerenciada por SSO. A conta precisa ser gerenciada ou pertencer à organização que representa. As outras pessoas da organização não precisam usar MFA ou SSO especificamente para que a API Admin funcione.

Minha organização pode convidar colaboradoras externas usando a API Admin?

Sim. Administradores da organização podem usar a API Admin para convidar pessoas para equipes, inclusive colaboradoras externas. As configurações atuais de convite e domínio da sua equipe também se aplicam às pessoas convidadas.

É possível recuperar um link de convite existente sem criar um novo convite?

Sim. Você pode recuperar um link de convite existente usando o endereço de e-mail exato da pessoa convidada, sem gerar um novo convite.