eKooliga sisselogimine võimaldab kasutajal siseneda teise ettevõtte teenusesse oma eKooli kontoga. Nii saab näiteks sisse logida e-Koolikotti ja Opiqusse. Sisselogimine põhineb OAuth 2.0 standardil.
Kuidas taotleda OAuth 2.0 klienti
Kirjuta aadressile [email protected] või võta meiega ühendust Teadmusbaasi vestlusakna kaudu. Lisa kirja:
ettevõtte või asutuse nimi
kontaktisiku nimi, e-posti aadress ja telefoninumber
teenuse nimi ja lühikirjeldus
miks soovid, et kasutaja saaks sinu teenusesse eKooli kontoga sisse logida
ümbersuunamise aadress (
redirect_uri), näitekshttps://sinu-teenus.ee/oauth/callback
Ilma kooli nõusolekuta saab teenus ainult sisse logiva kasutaja põhiandmed. Kui teenus vajab õppeinfot, loe allpool, kuidas kool saab lubada seda jagada.
Kui taotlus on kinnitatud, sab teenus kliendi tnnuse (client_id) ja lubatud õigused. Kliendi salajase võtme (client_secret) edastab eKool turvaliselt eraldi. Autoriseerimiseserveri aadress on https://login.ekool.eu.
Hoia salajst võtit turvalises kohas. Äraa lisa seda veebilehe ega mobiilrakenduse koodi ja ära jaga seda teistega.
Mida OAuth 2.0 klient võimaldab
Kui kasutaja annab sisselogimisel nõusoleku, saab teenus tema eKooli konto põhiandmed, rollid ja koolid.
Õppeinfole klient automaatselt ligipääsu ei anna. Näiteks kodutöid, hindeid ja päevikuid teenus ainult sisselogimise kaudu ei näe.
Õppeinfo jagamine teise teenusega
Õppeinfo eest vastutab kool ja eKool töötleb neid andmeid kooli nimel. Seepärast peab õppeinfo jagamise lubama kool. Kasutaja nõusolekust sisselogimisel üksi ei piisa.
Selleks kinnitab kooli administraator, et kool soovib teenust kasutada. Praegu saab kool kinnituse saata aadressile [email protected]. Seejärel lülitab eKool ligipääsu selles koolis sisse.
Teenus näeb ainult neid andmeid, mida integratsioon vajab ja mida kool on lubanud jagada. Kui olemasolev liides soovitud andmeid ei sisalda, on vaja eKooli arendust.
Kui kool soovib uut integratsiooni, saab ta soovi lisada eKooli Mõttekojas. Kui oled ettevõte, kirjuta aadressile [email protected] koos kooliga, mis integratsiooni soovib. Soovis kirjelda:
milliseid andmeid teenus vajab ja milleks
kuidas kool seda tööd praegu teeb
mis võiks selles töös paremini minna