Nastavte a používajte rozhranie Canva API správcu

Pomocou rozhrania Canva Admin API môžete automatizovať správu organizácie z vlastných systémov. Spravujte používateľov, tímy, skupiny a členstvá a získavajte udalosti z auditového protokolu bez toho, aby ste tieto úlohy museli vykonávať manuálne v Canve.

• Dostupné pre Canva Podniky, Canva pre školské obvody a Canva Kampusy.
• Prístup majú správcovia organizácie.
• Dostupné pre organizácie s jedným aj viacerými tímami.

Pred nastavením rozhrania Admin API sa uistite, že vaša organizácia spĺňa tieto požiadavky:

• Úroveň organizácie: Rozhranie Admin API je určené pre celú organizáciu. Je dostupné pre organizácie s jedným aj viacerými tímami v rámci plánov Canva Podniky, Canva pre školské obvody a Canva Kampusy.
• Účet správcu organizácie: Klientov rozhrania Admin API môžu v nastaveniach Canvy vytvárať a spravovať iba správcovia organizácie.
• Interné alebo externé technické kapacity: Vaša organizácia potrebuje technické kapacity na vytvorenie a údržbu integrácie. Canva neposkytuje podporu pri implementácii.
  • Ak váš tím nedokáže vytvoriť integráciu pomocou rozhrania API, na automatizáciu správy používateľov vo vašej organizácii sa lepšie hodí spravovanie cez SCIM.
• Znalosť štruktúry vašej Canvy: Pred vytvorením integrácie si ujasnite, ako sú v Canve nastavené vaša organizácia, tímy a skupiny.
• Účet spravovaný pomocou viacfaktorového overenia (MFA) alebo jediného prihlásenia (SSO): Správca organizácie, ktorý nastavuje rozhranie Admin API, musí mať zapnuté MFA alebo účet spravovaný cez SSO. Účet musí spravovať alebo vlastniť organizácia, v mene ktorej správca koná.

Rozhranie Admin API poskytuje koncové body na:

• Používateľov, tímy a skupiny: vytváranie, zobrazovanie, aktualizáciu a odstraňovanie.
• Členstvá: pridávanie a odoberanie ľudí z tímov a skupín a nastavovanie ich rolí.
• Auditové protokoly: plánované získavanie udalostí z auditového protokolu.
• Pozvánky do tímov: pozývanie ľudí do tímu (vrátane ľudí mimo vašej organizácie), zobrazovanie čakajúcich pozvánok, získavanie existujúceho prepojenia na pozvánku podľa presnej e-mailovej adresy a rušenie pozvánok.

Správca organizácie vytvorí klienta rozhrania Admin API a používa ho na volanie rozhrania API.

Podľa dokumentácie k rozhraniu Canva Admin API vymeňte prihlasovacie údaje klienta za prístupový token a začnite odosielať požiadavky rozhraniu API.

Technické podrobnosti o overovaní požiadaviek rozhrania API a používaní nosných tokenov OAuth 2.0 zdieľajte so svojím technickým tímom prostredníctvom dokumentácie k overovaniu v rozhraní Canva Admin API.

Akcie vykonané prostredníctvom rozhrania Admin API sa zaznamenávajú pod klientom rozhrania Admin API, nie pod správcom, ktorý klienta použil.

V auditových protokoloch sa v poli „Aktér“ zobrazuje názov a ID klienta rozhrania Admin API. Vďaka tomu zistíte, ktorá integrácia vykonala danú akciu.

Môžete tiež zistiť, ktorý správca organizácie vytvoril, aktualizoval alebo odstránil konkrétneho klienta rozhrania API.

Ďalšie informácie nájdete v článku Informácie o auditových protokoloch Canvy.

Správcovia organizácie môžu pomocou rozhrania Admin API pozývať ľudí do tímu vrátane externých spolupracovníkov mimo organizácie.

Čo treba vedieť

• Každá pozvánka, ktorú vytvoríte, platí pre jeden tím a jednu e-mailovú adresu.
• Každú pozvánku možno použiť iba raz a platnosť jej vyprší po 30 dňoch.
• V závislosti od vašich nastavení nemusí Canva pozvanému automaticky poslať e-mail. V prípade potreby mu prepojenie na pozvánku pošlite priamo.
• Prepojenia na pozvánky uchovávajte v súkromí. Prepojenie na pozvánku funguje iba pre e-mailovú adresu, pre ktorú bolo vytvorené.
• Na pozývaných ľudí sa naďalej vzťahujú existujúce nastavenia pozvánok a domény vášho tímu.
• Ak už pre pozvanú osobu existuje čakajúca pozvánka, vytvorením novej pozvánky sa vráti ten istý záznam pozvánky. Jej platnosť sa obnoví na 30 dní od odoslania požiadavky a rola v pozvánke sa aktualizuje na požadovanú rolu.

Podrobnosti o koncových bodoch nájdete v dokumentácii k rozhraniu Canva Admin API.

Rozhrania Admin API aj SCIM podporujú spravovanie používateľov.

Rozhranie Admin API umožňuje spravovať v organizácii Canva viac než len používateľov. Zahŕňa tímy, skupiny, členstvá a auditové protokoly.

SCIM podporuje štandardné spravovanie a rušenie prístupu. Ak potrebujete iba štandardné spravovanie používateľov alebo váš tím nedokáže vytvoriť vlastnú integráciu rozhrania API, SCIM bude pre vás vhodnejšou voľbou.

Potrebuje moja organizácia na používanie rozhrania Admin API vývojára?

Áno. Vaša organizácia potrebuje interné alebo externé technické kapacity na vytvorenie a údržbu integrácie rozhrania Admin API. Canva neposkytuje podporu pri implementácii. Ak váš tím nedokáže vytvoriť integráciu pomocou rozhrania API, na automatizáciu správy používateľov vo vašej organizácii sa lepšie hodí spravovanie cez SCIM.

Potrebujú všetci členovia mojej organizácie na používanie rozhrania Admin API MFA alebo SSO?

Nie. Iba správca organizácie, ktorý nastavuje rozhranie Admin API, musí mať zapnuté MFA alebo účet spravovaný cez SSO. Účet musí spravovať alebo vlastniť organizácia, v mene ktorej správca koná. Ostatní členovia organizácie nepotrebujú MFA ani SSO na to, aby rozhranie Admin API fungovalo.

Môže naša organizácia pozývať externých spolupracovníkov pomocou rozhrania Admin API?

Áno. Správcovia organizácie môžu pomocou rozhrania Admin API pozývať ľudí do tímov vrátane externých spolupracovníkov. Na pozývaných ľudí sa naďalej vzťahujú existujúce nastavenia pozvánok a domény vášho tímu.

Môžeme znova získať prepojenie na existujúcu pozvánku bez vytvorenia novej?

Áno. Existujúce prepojenie na pozvánku môžete získať zadaním presnej e-mailovej adresy pozvanej osoby bez vytvorenia novej pozvánky.