Google OAuth 2.0 on ilmainen avoimen lähdekoodin tuote, joka tarjoaa federoidun identiteettiratkaisun, jolla käyttäjät yhdistetään erilaisiin sovelluksiin sekä oppilaitosten sisällä että niiden ulkopuolella. Videoalustan joustava SSO Module Provider -kehys on suunniteltu tukemaan monenlaisia identiteettiratkaisuja, minkä ansiosta Google OAuth 2.0 voidaan integroida täysimääräisesti infrastruktuuriisi.
Tämä ohje opastaa käyttäjiä integroimaan videoalustan sovelluksena Google API OAuth 2.0 -järjestelmäänsä. Kun määritys on tehty, käyttäjät voivat antaa suostumuksensa ja valtuuttaa videoalustan käyttämään Google-tilinsä perustietoja, jotta heidät voidaan kirjata videoalustalle uutena tai olemassa olevana käyttäjänä.
Määritys
Määritykseen kuuluu videoalustan uudelleenohjaus-URI:n lisääminen projektiisi Google API Consolessa ja sen jälkeen JSON-metatietotiedoston hankkiminen, joka sisältää kaikki videoalustan puolen määrittämiseen tarvittavat tiedot. JSON-tiedoston avulla videoalustan määrittäminen vaatii vain muutaman parametrin antamisen ja testikirjautumisen. Kun SSO:n toimivuus on varmistettu, viimeisenä vaiheena on todennuksen aktivoiminen kaikille oppilaitoksesi käyttäjille.
Joissakin vaiheissa <organization> korvataan videoalustaan liittyvän organisaation wildcard-DNS-nimellä. Esimerkiksi osoitteessa ”https://hudson.yuja.com” <organization> korvattaisiin tekstillä ”hudson”.
Videoalustan uudelleenohjaus-URI:n lisääminen Google API Consoleen
Ohjeet projektien luomiseen Google API Consolessa löytyvät täältä: https://developers.google.com/identity/sign-in/web/devconsole-project
- Valitse tai luo Google API Consolessa videoalustaan liittyvä projekti. Lisää seuraava arvo kenttään Valtuutetut uudelleenohjaus-URI:t: https://<organization>.yuja.com/D/OauthAuthentication
- Lataa JSON-metatietotiedosto Google API Consolesta. Se sisältää YuJan määrittämiseen tarvittavat parametrit.
Google OAuth -integraation määrittäminen videoalustalla
- Kirjaudu YuJa-vyöhykkeellesi IT-päällikkönä ja siirry kohtaan Hallintapaneeli → Integraatiot.
- Valitse kohdassa Valitse integraatio vaihtoehto SSO - Google OAuth 2.0.
- Anna seuraavat määritysparametrit:
Parametri
Arvo
Client ID
Google API Consolesta saatu client ID.
https://console.developers.google.com
Löytyy myös projektisi JSON-tiedoista ”client_id”-attribuutin arvona.
Client Secret
Google API Consolesta saatu client secret. https://console.developers.google.com
Löytyy myös projektisi JSON-tiedoista ”client_secret”-attribuutin arvona.
Auth URI
Löytyy projektisi JSON-tiedoista ”auth_uri”-attribuutin arvona.
Token URI
Löytyy projektisi JSON-tiedoista ”token_uri”-attribuutin arvona.
- Napsauta Luo määritykset.
- Napsauta vahvistusikkunassa OK.
- Voit testata määrityksen oikeellisuuden napsauttamalla Testaa OAuth sisäänkirjautumista. Tämän pitäisi avata uusi välilehti ja ohjata Googleen, joka hoitaa todennuksen ja käyttäjän suostumuksen.
- Jos yhtään Google-käyttäjää ei ole kirjautuneena, anna kelvolliset kirjautumistiedot ja valitse Sisäänkirjautuminen. Muussa tapauksessa valitse Google-tili.
- Napsauta Salli, jotta annat videoalustalle suostumuksen käyttää käyttäjän perustietoja.
- Sinut pitäisi ohjata takaisin videoalustalle uutena käyttäjänä kirjautuneena.
Uutena käyttäjänä kirjautuminen voi kirjata alkuperäisen tilin ulos. Jos näin käy, kirjaudu ulos vasta luodusta tilistä ja kirjaudu takaisin sisään IT-päällikkönä ja siirry sitten takaisin kohtaan Hallintapaneeli → Integraatiot → SSO – Google OAuth 2.0.
- Kun olet varmistanut, että OAuth SSO toimii, voit halutessasi ottaa uuden todennustavan käyttöön organisaatiossasi napsauttamalla Aktivoi.
Aktivoi uusi todennustapa vasta, kun olet onnistuneesti tehnyt testikirjautumisen ja olet valmis tekemään sen käytettäväksi kaikille organisaatiosi käyttäjille.
(Valinnainen) Kaksoisintegraatio LTI:n kanssa
Jos organisaatiossasi on otettu käyttöön sekä LTI että Google OAuth SSO -käyttö, voit halutessasi yhdistää nämä kaksi integraatiota. Oletuksena käyttäjä, joka kirjautuu sekä LTI:n että OAuthin kautta, saa kummallekin kirjautumiselle erillisen videoalustan tilin. Jos LTI-palveluntarjoajasi on määritetty todentamaan käyttäjät heidän Google-tilinsä tunnuksilla, nämä kaksi tiliä voidaan yhdistää, koska LTI-palveluntarjoaja antaa videoalustalle käyttäjän yksilöllisen tunnisteen OAuth-järjestelmässä.
- Määritä LMS välittämään mukautettu LTI-parametri nimeltä lis_person_sourcedid, joka sisältää ristiin täsmäytettävän SSO-arvon. Tämä voi olla sähköposti, työntekijätunnus tai jokin muu kenttä. Videoalusta käyttää tätä ominaisuutta yhdistääkseen molemmat kirjautumistavat samaan tiliin.
- Hanki sen attribuutin nimi, jonka arvo vastaa LTI-palveluntarjoajan käyttämää yksilöllistä tunnistetta. Käytettävissä olevat arvot määräytyvät Google API:n mukaan. Koska videoalusta pyytää vain tietyn käyttäjän perusprofiilitietoja, ainoa kelvollinen attribuutti on 'email'.
- Syötä tämä arvo kohtaan Hallintapaneeli → Integraatiot → Valitse integraatio → SSO - Google OAuth 2.0 → Linkityksen määrite ja valitse Tallenna ristikkäisintegraatio.
- Kun käyttäjä kirjautuu ensimmäistä kertaa Google OAuthin kautta, videoalusta etsii linkkiä LTI-tiliin linkityksen määritteen arvon avulla. Jos linkki löytyy, Google-tili yhdistetään olemassa olevaan tiliin. Muussa tapauksessa uusi tili luodaan tavalliseen tapaan. Kaikki ensimmäisen kirjautumisen jälkeiset kirjautumiset linkittyvät edelleen ensimmäisellä kirjautumisella luotuun tai löydettyyn videoalustan tiliin.
Käyttö
Kun Google API Console ja videoalusta on määritetty oikein ja OAuth SSO on aktivoitu, organisaatiosi videoalustan verkkotunnukseen siirtyvät käyttäjät todennetaan Google OAuth 2.0:n kautta videoalustan tavallisen sisäänkirjautumisen sijaan. Voit helposti varmistaa, että kaikki on tehty oikein, noudattamalla alla olevia vaiheita:
- Siirry organisaation videoalustan vyöhykkeelle.
- Paina Sisäänkirjautuminen. Tämän pitäisi ohjata käyttäjä Googleen, jossa hän valitsee käytettävän tilin ja antaa suostumuksensa siihen, että videoalusta saa käyttää hänen perustietojaan.
- Kun valtuutus on annettu, käyttäjän pitäisi ohjautua takaisin videoalustalle ja olla kirjautuneena sisään.