﻿# Személyes hozzáférési tokenek

> 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:

Source: https://workwise-solutions.net/hu/docs/features/personal-access-tokens/ · Language: hu · English version: https://workwise-solutions.net/docs/features/personal-access-tokens/

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.

![Személyes hozzáférési tokenek](https://workwise-solutions.net/docs/images/diagram-pat-hu.png)
*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.

![Személyes hozzáférési tokenek](https://workwise-solutions.net/docs/images/pat-list.png)
*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. |

![Token létrehozása](https://workwise-solutions.net/docs/images/pat-create.png)

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.

![Admin Token Menedzsment](https://workwise-solutions.net/docs/images/pat-admin.png)

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](https://workwise-solutions.net/hu/docs/api-usage/) oldal írja le.
