Do rozhraní API Orchestrator můžete přistupovat prostřednictvím tokenů namísto používání autentizace vycházející z relace. Jako podnikový primární uživatel můžete spravovat tokeny API. U každého uživatele můžete vytvořit více tokenů API.

Poznámka:
  • U uživatelů s oprávněním pouze ke čtení podniku a podnikových specialistů MSP není povoleno ověřování na základě tokenů.
  • Podnikový primární uživatel by měl ručně odstranit uživatele neaktivního poskytovatele identity (IdP) z nástroje Orchestrator, aby se zabránilo neautorizovanému přístupu prostřednictvím tokenu API.

Uživatelé mohou vytvářet, odvolávat a stahovat tokeny na základě svých rolí.

Správa tokenů API:
  1. Na podnikovém portálu rozbalte na globálním navigačním panelu rozevírací nabídku Podnikové aplikace (Enterprise Applications).
  2. Vyberte službu Globální nastavení (Global Settings).
  3. Přejděte na možnost Správa uživatelů (User Management) > Uživatelé (Users).
  4. Vyberte uživatele a klikněte na možnost Modifikovat (Modify) nebo klikněte na odkaz na uživatelské jméno. Přejděte do části Tokeny API (API Tokens).
  5. Klikněte na možnost Nový token API (New API Token).
  6. V okně Nový token (New Token) zadejte Název (Name) a Popis (Description) tokenu a poté z rozbalovací nabídky vyberte parametr Životnost (Lifetime).
  7. Klikněte na tlačítko Uložit (Save). Nový token se zobrazí v tabulce Tokeny API (API Tokens). Zpočátku se použije stav tokenu Čeká na vyřízení (Pending). Po stažení se stav změní na Povoleno (Enabled).
  8. Chcete-li stáhnout token, vyberte token a klikněte na možnost Stáhnout token API (Download API Token).
  9. Chcete-li token deaktivovat, vyberte token a poté klikněte na možnost Odvolat token API (Revoke API Token). Stav tokenu se změní na Odvoláno (Revoked).
  10. Kliknutím na možnost CSV stáhnete kompletní seznam tokenů API ve formátu souboru .csv.
  11. Po vypršení platnosti tokenu se stav změní na Prošlý (Expired).
Poznámka: Token může stáhnout pouze uživatel, kterému je token přiřazen, a po stažení bude možné zobrazit pouze ID tokenu. Token je možné stáhnout pouze jednou. Po stažení tokenu jej uživatel může odeslat jako součást autorizačního záhlaví požadavku na přístup k rozhraní API aplikace Orchestrator.
Následující příklad popisuje vzorový fragment kódu pro přístup k rozhraní API.
curl -k -H "Authorization: Token <Token>"
  -X POST https://vco/portal/
  -d '{ "id": 1, "jsonrpc": "2.0", "method": "enterprise/getEnterpriseUsers", "params": { "enterpriseId": 1 }}'
Následují další možnosti dostupné v oblasti Tokeny API (API Tokens):
Možnost Popis
Vyhledat (Search) Zadejte výraz pro vyhledání odpovídajícího textu v tabulce. Pomocí možnosti rozšířeného vyhledávání můžete zúžit výsledky vyhledávání.
Sloupce (Columns) Klikněte a vyberte sloupce, které se mají na stránce zobrazit nebo skrýt.
Obnovit (Refresh) Kliknutím obnovíte stránku a zobrazíte nejaktuálnější data.