Személyes hozzáférési tokenek
Ezen az oldalon
A személyes hozzáférési token (PAT) segítségével szkriptek és integrációk hívhatják a WorkSmartHub REST API-ját egy felhasználó nevében. A PAT egy tokenpár:
- a hozzáférési token (access token): rövid élettartamú (alapértelmezetten 8 óra), minden API-hívással el kell küldeni;
- a frissítő token (refresh token): hosszú élettartamú, csak új hozzáférési token kérésére szolgál. Minden csere új tokenpárt ad, és a korábbi frissítő token érvényét veszti, ezért mindig az újat tárolja el.
A PAT kizárólag API-hívásokra használható. Böngészős munkamenetet soha nem indít, és PAT-tal nem lehet újabb PAT-ot létrehozni.
Menü: Hozzáférési Token → Személyes Hozzáférési Tokenek. Azok a felhasználók, akiknek csak Public jogosultságuk van, csak akkor látják az oldalt, ha az App Konfiguráció → Oldal Láthatóságok alatt engedélyezve van.
Token létrehozása#
A Token létrehozása gomb megnyitja a párbeszédablakot:
| Mező | Megjegyzés |
|---|---|
| PAT neve | A token neve, például az integrációé, amelyhez készül. |
| Lejárati mód | Abszolút: a frissítő token egy rögzített időpontban (UTC) jár le. Gördülő: a frissítő token élettartama minden frissítéssel újraindul. A gördülő tokenek az App Konfigurációban letilthatók. |
| Access Token Lejár | A hozzáférési token élettartama nn.óó:pp:mm formátumban. |
| Lejárati figyelmeztetések | Opcionális figyelmeztetések a lejárat előtt: válasszon egy alkalmazásszintű értesítési csatornát és a napok számát. |
Létrehozás után egy ablak egyszer megmutatja a frissítő és a hozzáférési tokent. Másolja ki őket, később nem jeleníthetők meg újra.
Az alapértelmezett és a maximális élettartamot az App Konfiguráció → Hozzáférési tokenek alatt lehet beállítani: alapértelmezetten a frissítő token 90 napig (legfeljebb 730), a hozzáférési token 8 óráig (legfeljebb 48) él.
Tokenek kezelése#
A lista mutatja a nevet, az állapotot (Aktív, Érvénytelen, Lejárt), a létrehozás idejét, a lejárati módot, valamint a frissítő és a hozzáférési token lejáratát. Műveletek:
- Lejárati figyelmeztetés szerkesztése: a lejárati figyelmeztetések módosítása;
- Érvénytelenítés: a token körülbelül egy percen belül minden szerveren érvényét veszti;
- Törlés: csak már nem aktív tokenre, ezért előbb érvénytelenítse.
Adminisztráció#
A Super adminok az Admin Token Menedzsment oldalon (Személyes hozzáférési token admin felület) minden felhasználó tokenjét látják a tulajdonossal együtt, és érvényteleníthetik vagy törölhetik őket. A Felhasználók (és a Profilok) oldal soraiból tokent is létrehozhatnak egy felhasználónak, vagy listázhatják a tokenjeit.
Az appsettings.json LoginSettings.JwtAuthenticationSettings.SymmetricSecurityKey értékének megváltoztatása egyszerre megszüntet minden tokent és munkamenetet.
Az API hívásának módját az API használata oldal írja le.