Configura e usa l'API di amministrazione di Canva

Puoi usare l’Admin API di Canva 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 queste attività manualmente su Canva.

• Disponibile per Canva Aziende, Canva Distretti e Canva Università.
• Accessibile a chi amministra l’organizzazione.
• Disponibile per organizzazioni con un solo team o con più team.

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

• Livello dell’organizzazione: L’Admin API è circoscritta all’organizzazione. È disponibile per le organizzazioni con un solo team o con più team che hanno un piano Canva Aziende, Canva Distretti o Canva Università.
• Account di chi amministra l’organizzazione: Solo chi amministra l’organizzazione può creare e gestire i client dell’Admin API nelle impostazioni di Canva.
• Risorse tecniche interne o esterne: la tua organizzazione deve disporre di risorse tecniche per creare e mantenere l’integrazione. Canva non fornisce assistenza per l’implementazione.
  • Se il tuo team non è in grado di sviluppare un’integrazione con un’API, il provisioning SCIM è più adatto per automatizzare la gestione degli utenti nella tua organizzazione.
• Conoscenza della struttura Canva: prima di creare l’integrazione, assicurati di conoscere bene la struttura della tua organizzazione, dei team e dei gruppi su Canva.
• Autenticazione a più fattori (MFA) o account gestito tramite Single Sign-On (SSO): Chi amministra l’organizzazione e configura l’Admin API deve avere MFA attivata oppure un account gestito tramite SSO. L’account deve essere gestito o di proprietà dell’organizzazione per conto della quale agisce.

L’Admin API mette a disposizione endpoint per:

• Utenti, team e gruppi: creare, leggere, aggiornare ed eliminare.
• Appartenenze: aggiungere o rimuovere persone da team e gruppi e assegnare loro i ruoli.
• Log di controllo: recuperare gli eventi del log di controllo secondo una pianificazione.
• Inviti ai team: invitare persone in un team, comprese quelle esterne alla tua organizzazione, visualizzare gli inviti in attesa, recuperare il link di un invito esistente usando l’indirizzo email esatto e annullare gli inviti.

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

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

Per i dettagli tecnici sull’autenticazione delle richieste API e sull’uso dei token bearer OAuth 2.0, condividi la documentazione sull’autenticazione dell’Admin API di Canva con il tuo team tecnico.

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

Nei log di controllo, il campo Attore mostra il nome e l’ID del client dell’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 uno specifico client API.

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

Chi amministra l’organizzazione può usare l’Admin API per invitare persone in un team, comprese collaboratrici e collaboratori esterni alla tua organizzazione.

Informazioni importanti

• Ogni invito che crei è valido per un solo team e un solo indirizzo email.
• Ogni invito può essere utilizzato una sola volta e 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.
• Non condividere i link di invito: sono riservati. Un link funziona solo con l’indirizzo email per cui è stato creato.
• Le impostazioni esistenti del tuo team relative agli inviti e ai domini si applicano anche alle persone che inviti.
• Se esiste già un invito in attesa per la persona invitata, crearne uno nuovo restituisce lo stesso record dell’invito, reimposta la scadenza a 30 giorni dalla richiesta e aggiorna il ruolo dell’invito a quello richiesto.

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

Sia l’Admin API sia SCIM supportano il provisioning degli utenti.

L’Admin API consente di gestire gli aspetti dell’organizzazione Canva che vanno oltre il provisioning degli utenti, inclusi team, gruppi, appartenenze e log di controllo.

SCIM supporta il provisioning e il deprovisioning standard. Se hai bisogno solo del 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 una persona sviluppatrice per usare l’Admin API?

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

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

No. Solo chi amministra l’organizzazione e configura l’Admin API deve avere MFA attivata oppure un account gestito tramite SSO. L’account deve essere gestito o di proprietà dell’organizzazione per conto della quale agisce. Le altre persone dell’organizzazione non devono necessariamente usare MFA o SSO perché l’Admin API funzioni.

La mia organizzazione può invitare collaboratrici e collaboratori esterni usando l’Admin API?

Sì. Chi amministra l’organizzazione può usare l’Admin API per invitare persone nei team, comprese collaboratrici e collaboratori esterni. Le impostazioni esistenti del tuo team relative agli inviti e ai domini si applicano anche alle persone che inviti.

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

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