Single Sign-On (SSO) ist eine Authentifizierungsmethode, mit der sich Benutzer mit einer einzigen Benutzerkennung bei mehreren miteinander verbundenen, aber unabhängigen Softwaresystemen anmelden können. Wir unterstützen die folgenden Identitätsanbieter (IDP):
-
- EntraID (ehemals Azure Active Directory). Für EntraID steht eine App in der Entra Gallery zur Verfügung.
- nShiftMarketplace
- Ping Identity
- Okta
- OpenID – generischer OpenID-Anbieter
Allgemeine Hinweise
- SSO kann von jedem Benutzer aktiviert werden, für den die Funktion SSO Configuration freigeschaltet ist. Anfangs steht diese Funktion nur dem Portal Owner-Benutzer zur Verfügung.
- SSO kann für jeden Benutzer einzeln aktiviert werden.
- Alle Benutzernamen müssen mit denen aktiver Benutzer beim Identitätsanbieter (IDP) des Kunden übereinstimmen.
- Wenn SSO aktiviert ist, geben Benutzer ihren Benutzernamen ein und werden zur Anmeldung an den Identitätsserver des Kunden weitergeleitet. Dabei ist kein Passwort im nShift Portal erforderlich.
- Wenn Sie OpenID, EntraID, Ping oder Okta verwenden, stellen Sie sicher, dass die Redirect URI dem folgenden Format entspricht:
- Die Weiterleitungs-URI lautet:
https://account.nshiftportal.com/idp/federation/sample-name/signin - Die Weiterleitungs-URI nach der Abmeldung lautet:
https://account.nshiftportal.com/idp/federation/sample-name/signout-callback -
Die Front-Channel-Abmelde-URI lautet:
https://account.nshiftportal.com/idp/federation/sample-name/signoutsample-name muss außerdem dem Namen im Feld Scheme des Formulars entsprechen.
- Die Weiterleitungs-URI lautet:
Wichtige Informationen zu Microsoft EntraID (Azure AD) und nShiftMarketplace
Der Entra-Benutzer (ursprünglicher Benutzer) benötigt Azure-Administratorrechte, um Anwendungen aus der Entra Gallery hinzuzufügen. Wenn dieser Benutzer nach der Integration gelöscht wird, muss ein neuer Benutzer aus der Entra-Umgebung des Kunden als Eigentümer zugewiesen und mit der Installation verknüpft werden. Sowohl für den ursprünglichen als auch für den neuen Eigentümer ist eine manuelle SSO-Einrichtung erforderlich. Sobald der Eigentümer eingerichtet ist, wird SSO für alle weiteren Benutzer, die über die Benutzeroberfläche hinzugefügt werden, automatisch konfiguriert.
Wir empfehlen, in der Entra-Umgebung des Kunden zwei Benutzer anzulegen: einen als Eigentümer und einen weiteren für die Integration mit der Entra Gallery. Richten Sie zunächst den Eigentümer mit einem Benutzernamen und einem Passwort ein. Fügen Sie anschließend den Integrationsbenutzer unter dem Eigentümer mit SSO hinzu (manuelle Einrichtung). Stellen Sie nach der Integration den Eigentümer auf SSO um (manuelle Einrichtung) und fügen Sie alle weiteren Benutzer hinzu. Für diese wird SSO automatisch eingerichtet.
So aktivieren Sie SSO
- Melden Sie sich beim nShift Portal an und navigieren Sie zu Settings > Company Management > Single Sign-On (SSO).
- Wählen Sie einen Anbieter aus der Dropdown-Liste aus.
- Füllen Sie die zusätzlichen Felder aus, die je nach ausgewähltem Anbieter angezeigt werden. Welche Angaben erforderlich sind, hängt vom jeweiligen Anbieter ab. Wichtiger Hinweis: Wenn Ihr Anbieter einen Scheme-Namen verwendet, kann dieser nicht geändert werden. Wählen Sie daher bei der erstmaligen SSO-Konfiguration einen passenden Namen aus.
Beispiel:
- Klicken Sie auf Save.
- Navigieren Sie zu Settings > Company Management > Users.
- Wählen Sie den Benutzer aus, für den Sie Single Sign-On aktivieren möchten.
- Öffnen Sie die Registerkarte General, wählen Sie den externen Anbieter aus der Dropdown-Liste und klicken Sie auf Save.
SSO in der Abnahmeumgebung einrichten
Sie können SSO in der Abnahmeumgebung einrichten, um beispielsweise Ihre Konfiguration zu testen, bevor Sie diese in der Produktionsumgebung verwenden. Die Abnahmeumgebung verfügt über eine eigene Anmeldeadresse und einen eigenen Client. Daher ist eine separate Einrichtung bei Ihrem Identitätsanbieter erforderlich.
Schritte zur Einrichtung:
- Erstellen Sie bei Ihrem Identitätsanbieter eine separate App-Registrierung für die Abnahmeumgebung.
- Fügen Sie die Weiterleitungs-URIs für die Abnahmeumgebung hinzu. Verwenden Sie dasselbe Muster wie für die Produktionsumgebung, jedoch mit der Basisadresse der Abnahmeumgebung.
- Geben Sie die Client-ID und das Client-Geheimnis aus dieser App-Registrierung in der SSO-Konfiguration der Abnahmeumgebung ein.
Verwenden Sie die App-Registrierung der Produktionsumgebung nicht erneut. Erstellen Sie für die Abnahmeumgebung eine separate App-Registrierung oder eine entsprechende Konfiguration bei Ihrem Identitätsanbieter. Dadurch bleiben die beiden Umgebungen voneinander getrennt, und Sie vermeiden Einschränkungen für Weiterleitungs-URIs über verschiedene Domänen hinweg, wie sie beispielsweise Microsoft Entra ID vorgibt.
Basisadressen (weitere Informationen unter Allgemeine Hinweise):
- Produktion:
account.nshiftportal.com/idp - Abnahmeumgebung:
account.acc.nshiftportal.com/idp
Weiterführende Informationen
- nShift-Anleitung: Single Sign-On: nShift Marketplace
- nShift-Anleitung: Single Sign-On: EntraID
- Microsoft-Anleitung: https://learn.microsoft.com/en-us/entra/identity/enterprise-apps/add-application-portal