Single Sign-On (SSO) is een authenticatiemethode waarmee gebruikers met één gebruikers-ID kunnen inloggen op meerdere gerelateerde, maar onafhankelijke softwaresystemen. Wij ondersteunen de volgende identiteitsproviders (IDP):
-
- EntraID (voorheen Azure Active Directory). Voor EntraID hebben we een app in de Entra Gallery.
- nShiftMarketplace
- Ping Identity
- Okta
- OpenID – generieke OpenID-provider
Algemene aandachtspunten
- SSO kan worden geactiveerd door elke gebruiker die toegang heeft tot de functionaliteit SSO Configuration. Aanvankelijk heeft alleen de Portal Owner-gebruiker toegang tot deze functionaliteit.
- SSO kan per gebruiker worden ingeschakeld.
- Alle gebruikersnamen moeten identiek zijn aan die van actieve gebruikers bij de identiteitsprovider (IDP) van de klant.
- Wanneer SSO is ingeschakeld, voeren gebruikers hun gebruikersnaam in en worden ze doorgestuurd naar de identiteitsserver van de klant om in te loggen, zonder een wachtwoord in nShift Portal te gebruiken.
- Als je OpenID, EntraID, Ping of Okta gebruikt, zorg er dan voor dat de Redirect URI de volgende indeling heeft:
- De redirect URI moet zijn:
https://account.nshiftportal.com/idp/federation/sample-name/signin - De post logout redirect URI moet zijn:
https://account.nshiftportal.com/idp/federation/sample-name/signout-callback -
De front channel logout URI moet zijn:
https://account.nshiftportal.com/idp/federation/sample-name/signoutsample-name moet ook de naam zijn die is ingevuld in het veld Scheme van het formulier.
- De redirect URI moet zijn:
Belangrijke informatie over Microsoft EntraID (Azure AD) en nShiftMarketplace
De Entra-gebruiker (de oorspronkelijke gebruiker) moet over beheerdersrechten in Azure beschikken om applicaties vanuit de Entra Gallery toe te voegen. Als deze gebruiker na de integratie wordt verwijderd, moet een nieuwe gebruiker uit de Entra-omgeving van de klant als eigenaar worden toegewezen en aan de installatie worden gekoppeld. Zowel voor de oorspronkelijke als voor de nieuwe eigenaar is een handmatige SSO-configuratie vereist. Zodra de eigenaar is ingesteld, wordt SSO automatisch geconfigureerd voor alle extra gebruikers die via de gebruikersinterface worden toegevoegd.
We raden aan om twee gebruikers aan te maken in de Entra-omgeving van de klant: één als eigenaar en één voor de integratie met Entra Gallery. Stel eerst de eigenaar in met een gebruikersnaam en wachtwoord en voeg vervolgens de integratiegebruiker onder de eigenaar toe met SSO (handmatige configuratie). Schakel na de integratie de eigenaar over naar SSO (handmatige configuratie) en voeg alle overige gebruikers toe. Voor deze gebruikers wordt SSO automatisch ingesteld.
SSO activeren
- Log in op nShift Portal en ga naar Settings > Company Management > Single Sign-On (SSO).
- Selecteer een provider in de vervolgkeuzelijst.
- Vul de aanvullende velden in die verschijnen, afhankelijk van de geselecteerde provider. Welke gegevens moeten worden ingevuld, verschilt per provider. Belangrijk: Als je provider een Scheme-naam gebruikt, kan deze niet worden gewijzigd. Kies daarom direct een geschikte naam wanneer je SSO voor het eerst configureert.
Voorbeeld:
- Klik op Save.
- Ga naar Settings > Company Management > Users.
- Selecteer de gebruiker voor wie je Single Sign-On wilt inschakelen.
- Ga naar het tabblad General, selecteer de externe provider in de vervolgkeuzelijst en klik op Save.
SSO instellen in de acceptatieomgeving
Je kunt SSO instellen in de acceptatieomgeving, bijvoorbeeld om je configuratie te testen voordat je deze in productie gebruikt. De acceptatieomgeving heeft een eigen inlogadres en een eigen client. Daarom is een afzonderlijke configuratie bij je identiteitsprovider nodig.
Stappen voor de configuratie:
- Maak bij je identiteitsprovider een afzonderlijke appregistratie aan voor de acceptatieomgeving.
- Voeg de redirect URI's voor de acceptatieomgeving toe. Gebruik hetzelfde patroon als voor de productieomgeving, maar met het basisadres van de acceptatieomgeving.
- Voer de client-ID en het clientgeheim van deze appregistratie in bij de SSO-configuratie voor de acceptatieomgeving.
Gebruik de appregistratie van de productieomgeving niet opnieuw. Maak voor de acceptatieomgeving een afzonderlijke appregistratie of een gelijkwaardige configuratie aan bij je identiteitsprovider. Zo blijven de twee omgevingen gescheiden en voorkom je problemen met de beperkingen voor redirect URI's over verschillende domeinen die identiteitsproviders zoals Microsoft Entra ID hanteren.
Basisadressen (zie de details onder Algemene aandachtspunten):
- Productie:
account.nshiftportal.com/idp - Acceptatie:
account.acc.nshiftportal.com/idp
Bronnen
- nShift-handleiding: Single Sign-On: nShift Marketplace
- nShift-handleiding: Single Sign-On: EntraID
- Handleiding van Microsoft: https://learn.microsoft.com/en-us/entra/identity/enterprise-apps/add-application-portal