Single Sign-On (SSO) on todennusmenetelmä, jonka avulla käyttäjät voivat kirjautua yhdellä käyttäjätunnuksella useisiin toisiinsa liittyviin mutta itsenäisiin ohjelmistojärjestelmiin. Tuemme seuraavia identiteetintarjoajia (IDP):
-
- EntraID (aiemmin Azure Active Directory). EntraID:tä varten meillä on sovellus Entra Galleryssa.
- nShiftMarketplace
- Ping Identity
- Okta
- OpenID – yleinen OpenID-palveluntarjoaja
Yleisiä huomioitavia asioita
- SSO:n voi aktivoida kuka tahansa käyttäjä, jolla on SSO Configuration -toiminnon käyttöoikeus. Aluksi tämä toiminto on käytettävissä vain Portal Owner -käyttäjällä.
- SSO voidaan ottaa käyttöön käyttäjäkohtaisesti.
- Kaikkien käyttäjätunnusten on vastattava asiakkaan identiteetintarjoajan (IDP) aktiivisten käyttäjien käyttäjätunnuksia.
- Kun SSO on käytössä, käyttäjät syöttävät käyttäjätunnuksensa ja heidät ohjataan asiakkaan identiteettipalvelimelle kirjautumaan sisään ilman, että heidän tarvitsee käyttää salasanaa nShift Portalissa.
- Jos käytät OpenID:tä, EntraID:tä, Pingiä tai Oktaa, varmista, että Redirect URI noudattaa seuraavaa muotoa:
- Uudelleenohjauksen URI-osoite on
https://account.nshiftportal.com/idp/federation/sample-name/signin - Uloskirjautumisen jälkeinen uudelleenohjauksen URI-osoite on
https://account.nshiftportal.com/idp/federation/sample-name/signout-callback -
Front channel -uloskirjautumisen URI-osoite on
https://account.nshiftportal.com/idp/federation/sample-name/signoutsample-name-arvon on myös vastattava lomakkeen Scheme-kentän nimeä.
- Uudelleenohjauksen URI-osoite on
Tärkeää tietoa Microsoft EntraID:stä (Azure AD) ja nShiftMarketplacesta
Entra-käyttäjällä (alkuperäisellä käyttäjällä) on oltava Azuren järjestelmänvalvojan oikeudet, jotta hän voi lisätä sovelluksia Entra Gallerysta. Jos tämä käyttäjä poistetaan integraation jälkeen, asiakkaan Entra-ympäristöstä on määritettävä uusi käyttäjä omistajaksi ja liitettävä hänet asennukseen. Sekä alkuperäisen että uuden omistajakäyttäjän SSO on määritettävä manuaalisesti. Kun omistaja on määritetty, kaikille käyttöliittymän kautta lisätyille käyttäjille määritetään SSO automaattisesti.
Suosittelemme luomaan asiakkaan Entra-ympäristöön kaksi käyttäjää: yhden omistajaksi ja toisen Entra Gallery -integraatiota varten. Määritä ensin omistajalle käyttäjätunnus ja salasana. Lisää sitten integraatiokäyttäjä omistajan alaisuuteen käyttäen SSO:ta (manuaalinen määritys). Integraation jälkeen vaihda omistaja käyttämään SSO:ta (manuaalinen määritys) ja lisää kaikki muut käyttäjät. Heille määritetään SSO automaattisesti.
SSO:n aktivointi
- Kirjaudu nShift Portaliin ja siirry kohtaan Settings > Company Management > Single Sign-On (SSO).
- Valitse palveluntarjoaja avattavasta luettelosta.
- Täytä valitun palveluntarjoajan mukaan näkyviin tulevat lisäkentät. Vaadittavat tiedot vaihtelevat palveluntarjoajan mukaan. Tärkeää: Jos palveluntarjoajasi käyttää Scheme-nimeä, sitä ei voi muuttaa. Valitse siksi sopiva nimi jo SSO:n ensimmäisen määrityksen yhteydessä.
Esimerkki:
- Napsauta Save.
- Siirry kohtaan Settings > Company Management > Users.
- Valitse käyttäjä, jolle haluat ottaa Single Sign-Onin käyttöön.
- Siirry General-välilehdelle, valitse ulkoinen palveluntarjoaja avattavasta luettelosta ja napsauta Save.
SSO:n määrittäminen hyväksyntäympäristössä
Voit määrittää SSO:n hyväksyntäympäristössä esimerkiksi testataksesi määrityksiä ennen niiden käyttöönottoa tuotannossa. Hyväksyntäympäristöllä on oma kirjautumisosoitteensa ja oma asiakassovelluksensa, joten se tarvitsee erillisen määrityksen identiteetintarjoajassasi.
Määritysvaiheet:
- Luo identiteetintarjoajassasi erillinen sovellusrekisteröinti hyväksyntäympäristöä varten.
- Lisää hyväksyntäympäristön uudelleenohjauksen URI-osoitteet. Käytä samaa rakennetta kuin tuotantoympäristössä, mutta hyväksyntäympäristön perusosoitetta.
- Syötä tämän sovellusrekisteröinnin asiakastunnus (client ID) ja asiakassalaisuus (client secret) hyväksyntäympäristön SSO-määrityksiin.
Älä käytä tuotantoympäristön sovellusrekisteröintiä uudelleen. Luo hyväksyntäympäristölle erillinen sovellusrekisteröinti tai vastaava määritys identiteetintarjoajassasi. Näin ympäristöt pysyvät erillään ja vältät eri verkkotunnusten uudelleenohjauksen URI-osoitteisiin liittyvät rajoitukset, joita esimerkiksi Microsoft Entra ID soveltaa.
Perusosoitteet (katso lisätiedot kohdasta Yleisiä huomioitavia asioita):
- Tuotanto:
account.nshiftportal.com/idp - Hyväksyntäympäristö:
account.acc.nshiftportal.com/idp
Lisätietoja
- nShift-ohje: Single Sign-On: nShift Marketplace
- nShift-ohje: Single Sign-On: EntraID
- Microsoftin ohje: https://learn.microsoft.com/en-us/entra/identity/enterprise-apps/add-application-portal