# Google’i sisselogimine Ühendus on ette valmistatud, kuid päris Google’i konto sisselogimine pole veel ühendatud ega vastu võetud. Google Cloud Console’is ei leidunud kaardiserveri projekti; uue projekti loomine avas projektikvoodi suurendamise lehe. Kasutajalt ei küsita olemasolevat kliendi ID-d uuesti. Olemasolevaid projekte ei kustutata ega teiste toodete kliente ei kasutata. ## Ühendamine 1. Loo eraldi tasuta Google Cloudi projekt `Kaardiserver.ee`, kui projektikvoot seda võimaldab. Ära ühenda arveldust ega aktiveeri Identity Platformi. 2. Google Auth Platform: seadista rakenduse nimi ja omaniku kontakt; alguses Testing koos omaniku testkontoga. Küsi ainult tavalisi identiteediandmeid. 3. Loo OAuth 2.0 veebiklient. Lubatud JavaScripti päritolud: `http://127.0.0.1:8194`, `http://localhost:8194`, `https://kaardiserver.ee`, `https://www.kaardiserver.ee`. Kasutame GIS-i popup-mudelit, mitte suunamise callback'i ega API võtit. Kliendisaladust pole vaja. 4. Sea serveris avalik `GOOGLE_CLIENT_ID` ja selle käivituse täpne `PUBLIC_ORIGIN`. Kohalik vaikepäritolu on `http://127.0.0.1:8194`. Alternatiiv on ignoreeritud `.runtime/auth-config.json`: `client_id` ja `origin`. Ära lisa runtime-faile Giti. 5. Ava menüüst Konto. Testi päris Google’i konto valikut, katkestamist, aegumist, uut katset, lehe taasavamist ja väljalogimist sisemises brauseris. Tee eraldi mobiili- ja arvutikontroll. Enne seda ühendust valmiks ei nimetata. ## Teostus ja piirid - Google’i ametlik nupp laaditakse kasutaja kontoavamisel ja ainult seadistatud ühenduse korral. Ühendamata olekul näeb lühikest teadet ja uuesti kontrollimise nuppu. - Server kontrollib Google’i allkirja, väljastajat, kliendi ID-d, aegumist, ühekordset nonce’i ja kinnitatud e-posti. Püsiv identifikaator on Google’i `sub`, mitte e-post. Sisselogimine ei anna halduri õigust. - Katse kestab viis minutit ja tarbitakse enne tokeni kontrolli; sama katse paralleelne kordus ei loo teist sessiooni. Katseid piiratakse serveris püsiva arvestusega. - Brauseris on juhuslik HttpOnly / SameSite=Lax sessiooniküpsis, HTTPS-is ka Secure. Tokenit ei säilitata. Sessioon kehtib kaheksa tundi. SQLite sisaldab nime, e-posti ja Google’i identifikaatorit; fail on privaatne ja Gitist väljas. Aegunud kirjed koristatakse järgmise sisselogimistegevusega. - Sisselogimise ja väljumise POST kontrollivad täpset päritolu ning CSRF-kinnitust. Päringukeha, Google’i sertifikaadipäring ja ooteaeg on piiratud. Sertifikaadid on vahemälus; tasulist teenust ei aktiveerita. - `npm run test:auth` kontrollib kohaliku RSA võtmega allkirjastatud tokenite päris Google’i verifikaatorit ja sessioonide veaharusid. See ei tõenda päris Google’i konto teekonda ega kliendi konfiguratsiooni. - Avaldamisel tuleb valida üks kanooniline HTTPS-päritolu, kontrollida proxy päritolu/IP käsitlust ning sõnastada kontoandmete privaatsus- ja kustutamisteekond. Kohalik prototüüp kuulab ainult loopback-aadressil. ## Allikad - [Google Identity Services: veebirakenduse ühendamine](https://developers.google.com/identity/gsi/web/guides/integrate) - [Google’i ametlik sisselogimisnupp](https://developers.google.com/identity/gsi/web/guides/display-button) - [ID tokeni kontroll serveris](https://developers.google.com/identity/gsi/web/guides/verify-google-id-token) - [Google Cloudi projekti loomine ja projektikvoot](https://docs.cloud.google.com/resource-manager/docs/creating-managing-projects)