Configura e usa l'API di amministrazione di Canva

Puoi usare Canva Admin API per automatizzare la gestione dell'organizzazione dai tuoi sistemi. Gestisci utenti, team, gruppi e appartenenze, e recupera gli eventi del log di controllo senza dover svolgere manualmente queste attività in Canva.

• Disponibile con Canva Aziende, Canva Districts e Canva Università.
• Accessibile a chi amministra l'organizzazione.
• Disponibile per le organizzazioni con un solo team e per quelle con più team.

Prima di configurare Admin API, assicurati che la tua organizzazione soddisfi questi requisiti:

• Livello organizzazione: Admin API opera a livello di organizzazione. È disponibile per le organizzazioni con un solo team e per quelle con più team che utilizzano i piani Canva Aziende, Canva Districts e Canva Università.
• Account di chi amministra l'organizzazione: Solo chi amministra l'organizzazione può creare e gestire i client Admin API nelle impostazioni di Canva.
• Competenze tecniche interne o esterne: la tua organizzazione deve disporre di risorse tecniche per creare e gestire l'integrazione. Canva non fornisce assistenza per l'implementazione.
  • Se il tuo team non è in grado di sviluppare un'integrazione tramite API, il provisioning SCIM è una soluzione più adatta per automatizzare la gestione degli utenti nella tua organizzazione.
• Conoscenza della struttura di Canva: prima di creare l'integrazione, assicurati di conoscere bene la configurazione della tua organizzazione, dei team e dei gruppi in Canva.
• Autenticazione a più fattori (MFA) o account gestito tramite Single Sign-On (SSO): chi amministra l'organizzazione e configura Admin API deve aver attivato l'MFA oppure disporre di un account gestito tramite SSO. L'account deve essere gestito o di proprietà dell'organizzazione per conto della quale opera.

Admin API mette a disposizione endpoint per:

• Utenti, team e gruppi: creare, leggere, aggiornare ed eliminare.
• Appartenenze: aggiungere o rimuovere persone dai team e dai gruppi e assegnare loro dei ruoli.
• Log di controllo: recuperare gli eventi del log di controllo in base a una pianificazione.
• Inviti ai team: invitare persone in un team, anche se non fanno parte della tua organizzazione, visualizzare gli inviti in sospeso, recuperare un link di invito esistente usando l'indirizzo email esatto e annullare gli inviti.

Chi amministra l'organizzazione crea un client Admin API e lo usa per effettuare chiamate all'API.

Segui la documentazione di Canva Admin APIne per scambiare le credenziali del client con un token di accesso e iniziare a inviare richieste API.

Per informazioni tecniche sull'autenticazione delle richieste API e sull'uso dei token bearer OAuth 2.0, condividi la documentazione sull'autenticazione di Canva Admin API con il tuo team tecnico.

Le azioni eseguite tramite Admin API vengono registrate a nome del client Admin API, non della singola persona che lo ha utilizzato.

Nei log di controllo, il campo Actor mostra il nome e l'ID del client Admin API. Questo ti aiuta a identificare quale integrazione ha eseguito un'azione.

Puoi anche identificare chi amministra l'organizzazione e ha creato, aggiornato o eliminato un determinato client API.

Per saperne di più, consulta Informazioni sui log di controllo di Canva.

Chi amministra l'organizzazione può usare Admin API per invitare persone in un team, anche collaboratori esterni all'organizzazione.

Informazioni importanti

• Ogni invito creato è valido per un team e un indirizzo email.
• Puoi usare ogni invito una sola volta e questo scade dopo 30 giorni.
• A seconda della configurazione, Canva potrebbe non inviare automaticamente un'email alla persona invitata. Se necessario, condividi direttamente con lei il link di invito.
• Mantieni privati i link di invito. Un link di invito funziona solo per l'indirizzo email per cui è stato creato.
• Alle persone che inviti si applicano le impostazioni esistenti del tuo team relative agli inviti e ai domini.
• Se esiste già un invito in sospeso per la persona invitata, crearne uno nuovo restituisce lo stesso record di invito, reimpostando la scadenza a 30 giorni dalla richiesta e aggiornando il ruolo assegnato con quello richiesto.

Per i dettagli sugli endpoint, consulta la documentazione di Canva Admin API.

Sia Admin API sia SCIM supportano il provisioning degli utenti.

Admin API supporta la gestione dell'organizzazione Canva oltre al provisioning degli utenti. Include team, gruppi, appartenenze e log di controllo.

SCIM supporta il provisioning e il deprovisioning standard. Se ti serve solo il provisioning standard degli utenti o il tuo team non è in grado di creare un'integrazione API personalizzata, SCIM è la soluzione più adatta alle tue esigenze.

La mia organizzazione ha bisogno di uno sviluppatore per usare Admin API?

Sì. Per usare Admin API, la tua organizzazione deve disporre di risorse tecniche interne o esterne per creare e gestire l'integrazione. Canva non fornisce assistenza per l'implementazione. Se il tuo team non è in grado di sviluppare un'integrazione tramite API, il provisioning SCIM è una soluzione più adatta per automatizzare la gestione degli utenti nella tua organizzazione.

Tutte le persone della mia organizzazione devono usare l'MFA o l'SSO per utilizzare Admin API?

No. Solo chi amministra l'organizzazione e configura Admin API deve aver attivato l'MFA oppure disporre di un account gestito tramite SSO. L'account deve essere gestito o di proprietà dell'organizzazione per conto della quale opera. Gli altri membri dell'organizzazione non devono usare l'MFA o l'SSO perché Admin API funzioni.

La mia organizzazione può invitare collaboratori esterni usando Admin API?

Sì. Chi amministra l'organizzazione può usare Admin API per invitare persone nei team, inclusi collaboratori esterni. Alle persone che inviti si applicano le impostazioni esistenti del tuo team relative agli inviti e ai domini.

Possiamo recuperare di nuovo un link di invito esistente senza crearne uno nuovo?

Sì. Puoi recuperare un link di invito esistente usando l'indirizzo email esatto della persona invitata, senza generarne uno nuovo.