Po úspešnom prihlásení používateľa do ABRA Flexi vzniká autentifikačná relácia.
Následne po výbere firmy si systém zakladá ku každému používateľovi kontextové informácie o pripojení k danej firme. Kontext obsahuje užitočné dáta, ktoré sa nemenia príliš často. Napríklad základnú menu, nastavenie firmy alebo oprávnenia používateľa. Prípadná zmena týchto údajov ovplyvní iba nové prihlásenie používateľa.
Ak potrebujete zabezpečiť propagáciu zmien aj k dlhodobo prihláseným používateľom, nezostáva iné, než vynútiť ukončenie ich relácií. Na to možno využiť službu na adrese:
POST /status/user/{přihlašovací jméno}/logoutPozn.: Rovnaká metóda sa používa aj pre WUI, preto v prípade API požadujte formát JSON alebo XML, čím zabránite finálnemu presmerovaniu.
Momentálne je možné týmto spôsobom ukončovať relácie používateľov prihlásených prostredníctvom webového rozhrania alebo API relácií vytvorených JSON autentifikáciou. Pre API požiadavky využívajúce HTTP autentifikáciu relácia nevzniká.
Požiadavku možno odoslať metódou POST, pričom existujú 2 možnosti použitia:
Odhlásenie používateľa zo všetkých firiem + zrušenie všetkých autentifikačných relácií
Odhlásenie používateľa z konkrétnej firmy (všetky autentifikačné relácie zostávajú v platnosti) – k URL doplňte parameter:
company=
Odhlásenie používateľa z firmy vykoná iba zahodenie kontextových informácií. K obnoveniu kontextu a jeho opätovnému uloženiu do vyrovnávacej pamäte dôjde automaticky s ďalšou požiadavkou používateľa.
Úspešné volanie vracia HTTP status 200 (API volanie), prípadne presmerovanie (HTTP status 303) na URL /status/user (HTML volanie).
Ak nechcete dostávať HTTP chybu 404 pri odhlasovaní používateľa, ktorý nie je prihlásený, pripojte voliteľný parameter ?ignore-not-found=true. Chybový status sa vracia aj v prípade, že došlo k zahodeniu kontextových informácií, ale autentifikačná relácia neexistovala (API volanie s HTTP autentifikáciou).
Využitie služby je umožnené používateľovi s právom prístupu do všetkých firiem a súčasne s právom spravovať licenciu. Prípadne možno využiť serverovú autorizáciu, alebo sa môže odhlásiť aj sám používateľ.
Príklady
Odhlásenie používateľa novak zo všetkých firiem a ukončenie platnosti autentifikácie:
POST /status/user/novak/logout
Odhlásenie používateľa franta z firmy nejlepsi_firma_a_s_ (bez zrušenia autentifikácie):
POST /status/user/franta/logout?company=nejlepsi_firma_a_s_