Személyes hozzáférési tokenek

Scriptekhez és saját, egy emberhez tartozó integrációhoz a legegyszerűbb út a személyes hozzáférési token (PAT). A tokent a felhasználó maga adja ki a saját nevére; a tenant API-t legfeljebb a felhasználó jogaival hívja.

Kiadás

A Vecton-fiókban (https://identity.vecton.hu) az Alkalmazások és tokenek oldalon:

1. Név — hogy később felismerd (pl. „Készlet-export script”).
2. Szervezet — a token egyetlen szervezetre szól; csak olyan szervezet választható, amelynek aktív tagja vagy.
3. Hozzáférés
   • Csak olvasás (read) — a tenant API-n csak GET, HEAD, OPTIONS kérés megy át; minden más 403 personal_token_read_only.
   • A szerepköröm szerint (role) — olvasás és írás, a szerepköröd jogaival.
4. Lejárat — 30, 90 vagy 365 nap, vagy egyedi dátum legfeljebb egy évre. Lejárat nélküli token nem adható ki.

A token értéke csak egyszer, a kiadás után látszik. A kiadás válasza a szervezet API-címét is megadja (api_base_url), például https://acme.app.vecton.hu/api.

Használat

curl https://acme.app.vecton.hu/api/warehouse/warehouses \
  -H "Authorization: Bearer $VECTON_PAT" \
  -H "Accept: application/json"

A token csak a kiadáskor választott szervezet hostján érvényes; más szervezet hostján 403. A jogaid a hívás pillanatában számítanak: ha a szerepköröd szűkül, a token is kevesebbet ér el, ha a tagságod megszűnik, a token használhatatlan.

Az identityben a személyes tokennel csak a saját adataid olvashatók (GET /api/user, GET /api/me); fiókot kezelni, újabb tokent kiadni vele nem lehet (403 personal_token_not_allowed).

Lista és visszavonás

Az Alkalmazások és tokenek oldal mutatja a tokenjeidet a legutóbbi használat idejével és helyével; a lejártak még 30 napig látszanak. Egy token visszavonása azonnal hat: a következő hívása 401 unauthenticated.

Mikor ne ezt használd

Ha az integráció nem egy emberhez tartozik (például egy ERP-összekötő, ami akkor is fut, ha a kolléga kilép a cégből), a szervezet API-kulcsát használd: Szolgáltatásfiókok.