Zef tarjoaa kaikille lisenssikäyttäjilleen SSO-kirjautumismahdollisuuden
Mikä on SSO-kirjautuminen?
SSO-kirjautuminen (Single Sign On) tarkoittaa, että organisaationne käyttäjät kirjautuvat Zeffiin samoilla tunnuksilla, joilla he kirjautuvat muihinkin työpaikan järjestelmiin. Kirjautuminen tapahtuu organisaationne identiteetintarjoajan, kuten Microsoft Entran tai Google Workspacen, kautta. Näin voitte hallita keskitetysti, kuka pääsee kirjautumaan Zeffiin.
Tämä poistaa tarpeen kutsua käyttäjiä erikseen ja huolehtia Zeffin salasanoista. Uudet käyttäjät voidaan liittää organisaatioonne automaattisesti ensimmäisellä kirjautumisella valitsemallanne oikeustasolla.
Palvelu kuuluu kaikkiin maksullisiin lisenssitasoihin.
Miten SSO on toteutettu?
ZEF tukee tällä hetkellä kahta eri tapaa toteuttaa SSO-kirjautuminen:
- SAML 2.0
- OIDC
Tässä dokumentissa ohjeistetaan SAML 2.0 -pohjainen kirjautuminen. Zeffi toimii SAML-kirjautumisessa palveluntarjoajana (Service Provider, SP), ja kirjautuminen alkaa aina Zeffistä.
Jos haluatte käyttää OIDC-pohjaista SSO:ta, olkaa yhteydessä tukeemme, support@zef.fi sillä sen asetuksia ei vielä löydy Zeffin käyttöliittymästä.
Mitä tarvitsen SSO:n käyttöönottoon?
- Organisaatiolle yhteisen identiteetintarjoajan (Identity Provider, IdP), kuten Microsoft Entran tai Google Workspacen.
- Pääkäyttäjäoikeudet identiteetintarjoajaan. Microsoft Entrassa tarvitaan vähintään Cloud Application Administrator -rooli ja Google Workspacessa super administrator -oikeudet.
- Omistaja- tai ylläpitäjäoikeudet Zeffin organisaatioonne.
Identiteetintarjoajaan tarvitsette Zeffin palveluntarjoajatiedot, jotka löytyvät osoitteesta: https://app.zef.fi/ssoLogin/saml/metadata
Jos identiteetintarjoajanne ei tue metadatalinkkiä, syöttäkää tiedot käsin:
|
Asetus |
Arvo |
|
Entity ID (Identifier) |
|
|
ACS URL (Reply URL) |
|
|
NameID-muoto |
urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress |
Vaihe 1: Lisää Zeffi identiteetintarjoajaanne
Microsoft Entra
Zeffiä ei löydy Microsoft Entran sovellusgalleriasta, joten se lisätään omana sovelluksena (non-gallery).
- Kirjaudu Microsoft Entra -hallintakeskukseen (entra.microsoft.com) vähintään Cloud Application Administrator -roolilla.
- Siirry kohtaan Entra ID > Enterprise apps > All applications ja valitse New application.
- Valitse sivun yläreunasta Create your own application.
- Anna sovellukselle nimi, esimerkiksi Zef. Valitse Integrate any other application you don't find in the gallery (Non-gallery) ja sitten Create.
- Valitse sovelluksen valikosta Single sign-on ja kirjautumistavaksi SAML.
- Valitse kohdassa Basic SAML Configuration > Edit ja syötä seuraavat tiedot:
- Identifier (Entity ID): https://app.zef.fi/ssoLogin
- Reply URL (Assertion Consumer Service URL): https://app.zef.fi/ssoLogin/api/oauth/saml
- Tallenna valitsemalla Save.
- Kopioi kohdasta SAML Certificates arvo App Federation Metadata Url. Tarvitsette sitä Zeffin asetuksissa vaiheessa 2. Osoite on muotoa https://login.microsoftonline.com/<tenant-id>/federationmetadata/2007-06/federationmetadata.xml?appid=<app-id>.
- Lisää kohdassa Users and groups käyttäjät tai ryhmät, joiden halutaan pääsevän Zeffiin.
Microsoftin oma dokumentaatio
How to register a SAML app: https://learn.microsoft.com/en-us/entra/external-id/customers/how-to-register-saml-app
SAML token claims: https://learn.microsoft.com/en-us/entra/identity-platform/saml-claims-customization
Claim Mapping: https://learn.microsoft.com/en-us/entra/external-id/claims-mapping
Assigning users and groups: https://learn.microsoft.com/en-us/entra/identity/enterprise-apps/assign-user-or-group-access-portal?pivots=portal
Google Workspace
- Kirjaudu Google Admin -konsoliin super administrator -oikeuksilla.
- Siirry kohtaan Apps > Web and mobile apps ja valitse Add app > Add custom SAML app.
- Anna sovellukselle nimi, esimerkiksi Zef, ja valitse Continue.
- Valitse Google Identity Provider details -sivulla Download metadata ja tallenna XML-tiedosto. Tarvitsette sitä Zeffin asetuksissa vaiheessa 2. Valitse Continue.
- Syötä Service provider details -sivulle seuraavat tiedot:
- ACS URL: https://app.zef.fi/ssoLogin/api/oauth/saml
- Entity ID: https://app.zef.fi/ssoLogin
- Name ID format: EMAIL
- Name ID: Basic Information > Primary email
Googlen oma dokumentaatio
Set up your own custom SAML app: https://knowledge.workspace.google.com/admin/apps/set-up-your-own-custom-saml-app
Vaihe 2: Määritä SSO-asetukset Zeffissä
SSO-asetukset löytyvät Zeffistä kohdasta Organisaatioasetukset > Asetukset > SSO-asetukset. Asetukset näkyvät organisaation omistajille ja ylläpitäjille.
- SSO-nimi: Nimi määrittää organisaationne kirjautumisosoitteen https://app.zef.fi/login/<SSO-nimi>. Nimen on oltava yksilöllinen, ja se kirjoitetaan pienillä kirjaimilla ilman välilyöntejä tai erikoismerkkejä.
- Sähköpostin verkkotunnukset: Lisätkää verkkotunnukset, joiden sähköpostiosoitteilla kirjaudutaan tämän SSO:n kautta, esimerkiksi yritys.fi. Verkkotunnuksia voi olla useita.
- Uloskirjautumisosoite: Osoite, johon käyttäjä ohjataan hänen kirjautuessaan ulos. Oletuksena se on https://zef.fi, mutta sen voi vaihtaa esimerkiksi intranettinne osoitteeksi.
- Uusien käyttäjien oletusoikeudet: Oikeustaso, jolla uusi käyttäjä liitetään organisaatioon hänen kirjautuessaan ensimmäistä kertaa.
- Ei mitään: Uusia käyttäjiä ei lisätä automaattisesti. Käyttäjät kutsutaan Zeffin tiimikutsulla, minkä jälkeen he pääsevät sisään SSO:lla ilman erillisen tunnuksen luomista.
- Jäsen: Kuka tahansa, jolla on organisaationne verkkotunnuksen sähköpostiosoite, liitetään organisaatioon jäsenoikeuksilla. Tämä on yleisin valinta.
- Istunnon aikakatkaisu: Aika tunteina, jonka käyttäjä voi olla kirjautuneena ilman toimintaa ennen kuin hänet kirjataan automaattisesti ulos. Oletus on yksi viikko, eli 168 tuntia.
- IDP-metatiedot: Valitkaa muoto ja syöttäkää identiteetintarjoajanne metatiedot. Microsoft Entrasta liitetään App Federation Metadata Url (URL). Google Workspacesta liitetään ladatun metatietotiedoston sisältö (XML) suoraan.
Tallentakaa asetukset valitsemalla Tallenna. Tämän jälkeen SSO-kirjautuminen on käytössä.
Vaihe 3: Testaa kirjautuminen
- Avaa app.zef.fi/login uudessa selainikkunassa ja valitse Login with SSO.
- Syötä sähköpostiosoite joka kuuluu aiempaan määritykseen, esimerkiksi en.sn@ritys.fi.
- Zeffi ohjaa teidät identiteetintarjoajanne kirjautumissivulle ja onnistuneen kirjautumisen jälkeen takaisin Zeffiin.
Jos kirjautuminen ei onnistu, tarkistakaa sähköpostin verkkotunnukset, metatiedot ja se, että käyttäjällä on pääsy sovellukseen identiteetintarjoajassa.
Näin käyttäjät kirjautuvat SSO:lla
- Kirjautumissivun kautta (suositeltu): Käyttäjä valitsee osoitteessa app.zef.fi/login Login with SSO ja syöttää työsähköpostinsa.
- Suoralla kirjautumisosoitteella: Osoitteessa app.zef.fi/login/<SSO-nimi> kirjautuminen tapahtuu suoraan ilman kirjautumissivua. Osoitteen voi linkittää esimerkiksi intranetiin.
- https://www.zef.fi Kirjaudu Zeffiin-napin kautta. Tämä vie teidät app.zef.fi/login sivulle, josta voitte jatkaa normaaliin tapaan.
Käyttäjä tunnistetaan sähköpostiosoitteen perusteella. Jos käyttäjä on jo Zeffissä samalla sähköpostiosoitteella, hänen tietonsa säilyvät ennallaan. Käyttäjä voi kirjautua samaan tiliin sekä SSO:lla että esimerkiksi Kirjaudu Googlella -toiminnolla.
Käyttäjien ja oikeuksien hallinta
- Oletusoikeustaso koskee vain hetkeä, jolloin käyttäjä liitetään organisaatioon ensimmäisen kirjautumisen yhteydessä. Tämä pätee myös Zeffin nykyisiin käyttäjiin, jotka eivät ole aiemmin kuuluneet organisaatioonne.
- Tämän jälkeen oikeuksia muutetaan Zeffissä tavalliseen tapaan, eikä SSO-kirjautuminen muuta niitä.
- Kun SSO otetaan käyttöön, olemassa olevien käyttäjien oikeudet eivät muutu.
- Jos oletusoikeutena on Ei mitään eikä käyttäjällä ole kutsua, kirjautuminen ei onnistu.
Kun käyttäjä poistetaan identiteetintarjoajasta
Kun käyttäjän tunnus poistetaan tai suljetaan identiteetintarjoajassa, hän ei pääse enää kirjautumaan Zeffiin SSO:lla. Huomioikaa kuitenkin seuraavat asiat:
- Zeffi ei saa tietoa poistosta, eikä käyttäjä poistu automaattisesti Zeffin organisaatiosta.
- Jos käyttäjä on jo kirjautuneena, hänen istuntonsa pysyy voimassa, kunnes istunnon aikakatkaisu kirjaa hänet ulos.
- Jos oikeuksien täytyy poistua nopeasti, suosittelemme asettamaan istunnon aikakatkaisun mahdollisimman lyhyeksi. Tarvittaessa käyttäjä kannattaa poistaa myös Zeffin organisaatiosta.
Käyttäjätietojen välittäminen
SSO-kirjautumisen yhteydessä Zeffiin välitetään vähintään käyttäjän sähköpostiosoite. Lisäksi välitetään yleensä etunimi ja sukunimi.
Myös muita tietoja, kuten käyttäjän oikeustason, on mahdollista välittää Zeffiin. Näitä asetuksia ei kuitenkaan voi tehdä käyttöliittymän kautta. Jos tarvitsette näitä ominaisuuksia, olkaa yhteydessä tukeemme support@zef.fi