Uživatelé získají přístup k rozhraní API Orchestrator formou tokenů namísto používání autentizace vycházející z relace. Primární uživatel partnera může spravovat tokeny API pro podnikové uživatele. U každého uživatele můžete vytvořit více tokenů API.
S výjimkou obchodních specialistů může každý z uživatelů vytvořit tokeny na základě oprávnění přiřazených jejich uživatelským rolím.
Uživatelé mohou na základě svých rolí provádět následující akce:
- Podnikoví uživatelé mohou tokeny vytvořit, stáhnout a odvolat.
- Primární uživatelé partnera mohou spravovat tokeny podnikových uživatelů za předpokladu, že podnikový uživatel partnerovi deleguje uživatelská oprávnění.
- Primární uživatelé partnera mohou tokeny vytvářet a odvolat pouze pro ostatní uživatele.
- Uživatelé mohou stahovat pouze své vlastní tokeny a nemohou stahovat tokeny ostatních uživatelů.
Správa tokenů API:
- Přihlaste se do systému SD-WAN Orchestrator jako partner a přejděte do nabídky .
- 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).
- Klikněte na možnost Nový token API (New API Token).
- V okně Nový token (New Token) zadejte Název (Name) a Popis (Description) tokenu a poté z rozbalovací nabídky vyberte parametr Životnost (Lifetime).
- 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).
- 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).
- Kliknutím na možnost CSV stáhnete kompletní seznam tokenů API ve formátu souboru .csv.
- 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. |