Co to je Přihlášení přes Seznam?
Tento článek představuje účel a koncepty používání Přihlášení přes Seznam. Je určen méně technicky zaměřeným uživatelům. Ti, kdo již znají protokol OAuth, mohou rovnou přejít na dokumentaci či ke správě služeb.
K čemu služba slouží
Účelem služby Přihlášení přes Seznam je nabídnout partnerským webům možnost identifikace uživatele. Partner tak nemusí udržovat vlastní databázi uživatelů, řešit jejich hesla a související zabezpečení. Každý provozovatel webových stránek může využít Přihlášení přes Seznam, ale neobejde se to bez jistého množství práce na straně poskytovatele webu. Objem této práce závisí na tom, zdali (a jak) již nějaké přihlašování provozuje.
Typický postup přihlášení
- Uživatel navštíví stránky partnera. Pokud chce partner nabídnout Přihlášení, musí na své stránky vložit nějakou formu přihlašovacího odkazu či tlačítka.
- Po kliku na přihlašovací tlačítko je uživatel přesměrován na stránky Seznamu, kde provede své ověření (uživ. jménem, heslem, případně vícefázovým ověřením). Tato část je zcela mimo režii a dosah partnera; vše probíhá výhradně na webech Seznamu.
- Jakmile je uživatel identifikován, Seznam jej přesměruje zpět na stránku partnera – konkrétně na adresu, kterou partner specifikoval jako tzv. redirect_uri. K této adrese je přidán jednorázový parametr
code, nutný pro dokončení předání uživatelských informací od Seznamu k partnerovi. - Partner nyní musí ze svého backendu provést HTTP požadavek na autorizační servery Seznamu, při kterém se prokáže jednorázovým kódem (z předchozího kroku) a dostane zpět přístupový token. Tento token pak může používat pro zjišťování informací o uživateli.
- Je zcela v režii partnera, aby se získanými informacemi naložil tak, jak potřebuje. Pokud si například přeje, aby uživatel zůstal přihlášený i při dalších interakcích na webu, musí sám zařídit persistenci této informace (například pomocí cookies a/nebo sessions).
Co služba neobsahuje
Přihlášení přes Seznam slouží výhradně jako zdroj jednorázové identifikace uživatele. Tato služba žádným způsobem nezasahuje do existujících stránek partnera. Na jeho zodpovědnosti pak zejména zůstává:
- Tvorba UI pro vstup do přihlašovacího procesu, tj. odkaz či tlačítko a jeho korektní nastavení tak, aby uživatele odvedlo do autorizačního procesu.
- Získání informací o uživateli serverovým voláním poté, co se uživatel ze Seznamu vrátí zpět na stránky partnera.
- Uložení identifikace uživatele do cookie tak, aby tato informace byla partnerovi k dispozici i při návštěvě dalších stránek.
Co musí partner udělat
Množství práce na webu partnera souvisí s tím, zdali již nějakou formu přihlášení provozuje:
- Pokud žádné přihlašování nemá, musí přidat tlačítko, implementovat serverové volání, vytvořit vlastní session.
- Pokud má přihlašování vlastním jménem a heslem, musí přidat tlačítko a naimplementovat serverové volání; lze použít existující session infrastrukturu.
- Pokud má přihlašování pomocí jiného poskytovatele autorizace, stačí přidat tlačítko a upravit/zkopírovat existující kód pro následné vyzvednutí tokenu.