Személyes hozzáférési tokenek

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.

A token egyszer jön létre, a frissítő tokent új tokenpárra lehet cserélni, a hozzáférési token pedig minden API hívással megy.

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.

Az oldal elmagyarázza a két tokent, és curl példákkal megmutatja a telepítés frissítési végpontjait.

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.

Nem találta, amit keresett?

Írjon nekünk, vagy foglaljon időpontot. Válaszolunk a funkciókkal, a telepítéssel és a licenceléssel kapcsolatos kérdésekre.

Kapcsolat