Konfigurieren der Single Sign-on-Authentifizierung
Enterprise Server-Administratoren können Single Sign-On (SSO) für Ihren Server konfigurieren und aktivieren. Über das Backend-Konfigurationssystem können Administratoren die SSO-Funktion für Serverbenutzer einrichten, testen, aktivieren und deaktivieren. Die SSO-Option steht bei der Anmeldung an der Browseroberfläche von Enterprise Server zur Verfügung. Wenn SSO für Serverbenutzer eingerichtet ist, können diese bequem mit denselben Anmeldedaten auf den Server zugreifen, die auch für die unternehmensweiten Systeme gelten.
Weitere Informationen zum Zugriff auf die Browseroberfläche von Enterprise Server finden Sie auf der Seite Die browserbasierte Oberfläche erkunden.
SAML Single Sign-On
Wenn das SSO-System in Enterprise Server konfiguriert und aktiviert ist, übernimmt es autorisierte Identitäten vom vorgesehenen Identitätsanbieter (IdP) Ihres Unternehmens, beispielsweise Okta, OneLogin usw. Die Kommunikation zur Identitätsbestätigung basiert dabei auf der standardisierten Security Assertion Markup Language (SAML 2.0). Die SSO-Anmeldeoberfläche für Ihr Unternehmen basiert, sofern sie noch nicht vorhanden ist, in der Regel auf einer Vorlage oder einem Beispiel des IdP. Sie leitet den SAML-basierten Austausch von Authentifizierungsbestätigungen ein und ermöglicht den Zugriff auf Unternehmensdienste.
Wenn die Option SAML in der Dropdown-Liste SSO auf der Seite Administration – Einstellungen – Authentifizierung der Browseroberfläche ausgewählt ist, zeigt die Seite die vorkonfigurierten URLs für den SSO-Dienst von Enterprise Server (Altium Metadata Configuration) sowie die Möglichkeit an, die Autorisierungsverbindungsdaten Ihres IdP hochzuladen oder manuell einzugeben (SAML Identity Provider Configuration).
Die IdP-Konfigurationsmetadaten sollten von Ihrem Identitätsanbieter verfügbar sein, sobald dieser für die Integration mit Ihren Unternehmensdiensten eingerichtet ist – siehe die Beispiele zur IdP-Integration weiter unten. Um das SAML-SSO-System in Enterprise Server zu konfigurieren (sofern dies noch nicht geschehen ist), verwenden Sie die Schaltfläche
, um die vom IdP Ihres Unternehmens generierte XML-Datei mit der SAML-IdP-Konfiguration zu suchen und hochzuladen. Eine hochgeladene IdP-XML-Datei wird vom System analysiert, um die wichtigsten Konfigurationsfelder (X509 Certificate, Identity Provider Issuer-URL und IdP Single Sign-On URL) zu extrahieren. Alternativ können Sie die einzelnen Elemente der Konfiguration (Sicherheitszertifikat und URLs) manuell in die entsprechenden Felder eintragen.
SSO wird erst aktiviert, nachdem ein Integrationstest durchgeführt wurde. Dieser wird über die Schaltfläche
gestartet. Dabei werden der SSO-Identitätsprozess und die SSO-Anmeldung Ihres Unternehmens überprüft. Nachdem die Konfiguration erfolgreich getestet wurde, können Sie die Einstellungen durch Klicken auf die Schaltfläche
speichern und damit auf Enterprise Server anwenden.
Beispiele zur Integration von Identitätsanbietern
Klappen Sie den folgenden Abschnitt auf, um ein schrittweises Beispiel für die Integration von OneLogin als Identitätsanbieter anzuzeigen.
Integration mit OneLogin
-
Melden Sie sich als Administrator bei OneLogin an.
-
Wählen Sie Applications und anschließend Add Apps.
-
Suchen Sie nach „SAML“ und wählen Sie die IdP-Anwendungsoption SAML Test Connector (Advanced).
-
Geben Sie einen Anwendungsnamen an (Display Name). Dieser dient nur zur Anzeige.
-
Klicken Sie auf die Schaltfläche Save.
-
Kopieren Sie die Einträge Entity ID und Single Sign-On URL (Assertion Consumer Service) von der Seite Admin – Settings – Authentication der Browseroberfläche von Enterprise Server in die unten angegebenen Felder.
In der Anwendungskonfiguration von OneLogin:
-
Fügen Sie den oben genannten Entity ID (Name des Dienstanbieters) als Audience (EntityID)-URL ein.
-
Fügen Sie den oben genannten Single Sign-On URL (Assertion Consumer Service) als ACS (Consumer) URL Validator ein.
-
Fügen Sie Single Sign-On URL (Assertion Consumer Service) außerdem als ACS (Consumer) URL ein.
-
Die Felder RelayState, Recipient, Single Logout URL und Login URL können leer bleiben.
-
-
Stellen Sie sicher, dass die Option SAML nameID format auf Email und SAML signature element auf Both eingestellt ist. Klicken Sie auf die Schaltfläche Save, um die Einstellungen zu bestätigen.
-
Klicken Sie auf die Schaltfläche More Actions und anschließend auf den Menüeintrag SAML Metadata, um die SAML-Metadaten des Identitätsanbieters als XML-Datei herunterzuladen.
-
Diese Metadatendatei wird auf der Seite Admin – Settings – Authentication der Browseroberfläche von Enterprise Server hochgeladen, um den OneLogin-SSO-Dienst zu konfigurieren – siehe unten.
-
Wenn Sie den OneLogin-SSO-Dienst in Enterprise Server lieber manuell einrichten möchten, finden Sie die erforderlichen Parameter, indem Sie den Menüeintrag SSO in der Anwendungsoberfläche von OneLogin auswählen.
-
-
Die nächsten Schritte bestehen darin, Benutzer hinzuzufügen und diesen die Anwendung zuzuweisen.
Klappen Sie den folgenden Abschnitt auf, um ein schrittweises Beispiel für die Integration von Okta als Identitätsanbieter anzuzeigen.
Integration mit Okta
-
Melden Sie sich bei Okta als Administrator an.
-
Klicken Sie auf den Link bzw. die Schaltfläche Admin und anschließend auf die Schaltfläche Add Application unter dem Unternehmen Applications.
-
Klicken Sie auf die Schaltfläche Create New App.
-
Wählen Sie SAML 2.0 als Sign-on method aus.
-
Geben Sie einen App name an. Dieser dient nur zu Anzeigezwecken.
-
Beachten Sie die Einträge Single Sign On URL (Assertion Consumer Service) und Entity ID auf der Seite Admin – Settings – Authentication der Browseroberfläche des Enterprise Servers.
-
Kopieren Sie den Eintrag Single Sign-On URL des Enterprise Servers und fügen Sie ihn in das Feld Single sign on URL der SAML-Einstellungen von Okta ein.
-
Kopieren Sie den Eintrag Entity ID des Enterprise Servers und fügen Sie ihn in das Feld Audience URI der SAML-Einstellungen von Okta ein.
Ein Eintrag für Default RelayState ist nicht erforderlich.
-
Legen Sie die übrigen Felder wie folgt fest:
-
Für Name ID format gilt
EmailAddress. -
Für Application username gilt (Okta)
Email. -
Setzen Sie im Abschnitt ATTRIBUTE STATEMENTS das Feld Name auf:
http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddressund Value auf:user.email
-
-
Klicken Sie auf die Schaltfläche Next und wählen Sie die Option ..Okta customer adding an internal app aus.
-
Klicken Sie auf die Schaltfläche Finish.
-
Klicken Sie auf den Link Identity Provider metadata und speichern Sie die Metadaten-XML-Datei auf Ihrem Computer, oder klicken Sie auf die Schaltfläche View Setup Instructions, um Optionen für die manuelle Einrichtung aufzurufen.
-
Laden Sie im Abschnitt SAML Identity Provider configuration auf der Seite Admin – Settings – Authentication der Browseroberfläche des Enterprise Servers die gespeicherte Metadaten-XML-Datei hoch oder richten Sie die einzelnen Abschnitte manuell ein – siehe oben.
-
Erweitern Sie den ausklappbaren Abschnitt unten, um ein schrittweises Beispiel für die Integration von Microsoft Entra ID als Identitätsanbieter anzuzeigen.
Integration mit Microsoft Entra ID
-
Melden Sie sich beim Microsoft Entra Admin Center an.
-
Wählen Sie Identity und anschließend die Option Enterprise applications aus.
-
Erstellen Sie Ihre eigene Anwendung.
-
Wählen Sie Users and groups und anschließend Add user/group aus.
-
Wählen Sie Single sign-on, Step 1 und anschließend Edit aus.
-
Kopieren Sie Entity ID und Single Sign-On URL von der Seite Admin – Settings – Authentication der Browseroberfläche des Enterprise Servers. Fügen Sie die kopierten Zeichenfolgen in die Felder Entity ID und Assertion Consumer Service URL im Bereich für die SAML-Konfiguration der Microsoft Entra-App ein. Stellen Sie sicher, dass die Kontrollkästchen Default für diese Felder aktiviert sind, und speichern Sie anschließend die Konfiguration.
-
Laden Sie die erstellte Verbundmetadaten-XML-Datei herunter.
-
Laden Sie die Verbundmetadaten-XML-Datei auf der Seite Admin – Settings – Authentication der Browseroberfläche des Enterprise Servers hoch und testen Sie anschließend die SAML-Integrationsverbindung – siehe oben.
Erweitern Sie den ausklappbaren Abschnitt unten, um ein schrittweises Beispiel für die Integration von JumpCloud als Identitätsanbieter anzuzeigen.
Integration mit JumpCloud
-
Wählen Sie in der JumpCloud-Oberfläche im Navigationsbaum SSO und anschließend auf der Seite SSO die Schaltfläche Add New Application aus.
-
Geben Sie im Suchfeld des Konfigurationsfensters „
saml“ ein, um Custom SAML App zu finden und anschließend zu installieren. -
Benennen Sie Ihre Instanz von Custom SAML App – in diesem Beispiel lautet die Bezeichnung
Altium. -
Wechseln Sie in der JumpCloud-Konfigurationsoberfläche zur Registerkarte SSO und geben Sie die Entitäts-/URL-Einstellungen von der Seite Admin – Settings – Authentication der Browseroberfläche des Enterprise Servers wie gezeigt ein.
-
Geben Sie den JumpCloud-Endpunkt IDP URL ein und aktivieren Sie die Option Declare Redirect Endpoint.
-
Verwenden Sie die Option Export Metadata, um die resultierende SAML-Metadaten-XML-Datei herunterzuladen.
-
Laden Sie die Metadaten-XML-Datei auf der Seite Admin – Settings – Authentication der Browseroberfläche des Enterprise Servers hoch und testen Sie anschließend die SAML-Integrationsverbindung – siehe oben.
Erweitern Sie den ausklappbaren Abschnitt unten, um ein schrittweises Beispiel für die Integration von Microsoft Administrative Domain Federated Services (AD FS) als Identitätsanbieter anzuzeigen.
Integration mit Microsoft AD FS
-
Öffnen Sie die Anwendung AD FS Management (normalerweise Start → Windows Administrative Tools → AD FS Management).
-
Navigieren Sie zu Relying Party Trusts und klicken Sie auf die Option Add Relying Party Trust... (1).
-
Stellen Sie im Popup-Fenster sicher, dass Claims aware (2) ausgewählt ist, und klicken Sie auf Start (3).
-
Wählen Sie im Schritt Select Data Source die Option Enter data about the relying party manually (1) aus und klicken Sie auf Next (2).
-
Geben Sie einen Anzeigenamen für die Vertrauensstellung an. In diesem Beispiel wird
AltiumLiveals Anzeigename verwendet. -
Abhängig von Ihrer Sicherheitskonfiguration können Sie optional ein Zertifikat zur Tokenverschlüsselung angeben. Für diese Anleitung wird keines verwendet.
-
Stellen Sie im Schritt Configure URL sicher, dass die Option Enable support for the SAML 2.0 WebSSO protocol (1) ausgewählt ist, und geben Sie Single Sign-On URL, kopiert von der Seite Admin – Settings – Authentication der Browseroberfläche des Enterprise Servers, in das Feld Relying party SAML 2.0 SSO service URL: (2) ein. Klicken Sie auf Next (3).
-
Geben Sie im Schritt Configure Identifiers einen Bezeichner für diese Vertrauensstellung in das Eingabefeld (1) ein. Der Bezeichner muss dem Eintrag Entity ID entnommen werden, der sich im Bereich Altium Metadata Configuration der Seite Admin – Settings – Authentication der Browseroberfläche des Enterprise Servers befindet. Klicken Sie unbedingt auf die Schaltfläche Add (2).
Das Ergebnis sollte wie folgt aussehen. Klicken Sie auf Next.
-
Abhängig von Ihrer Sicherheitskonfiguration können Sie im nächsten Schritt optionale Zugriffssteuerungsrichtlinien auswählen. In diesem Beispiel werden keine zusätzlichen Richtlinien ausgewählt; fahren Sie mit der Option
Permit everyonefort. -
Überprüfen Sie die Konfiguration und wählen Sie Next aus.
-
Beim Einrichten der Vertrauensstellung sind nicht alle Einstellungen verfügbar. Damit
SHA-1als sicherer Hashalgorithmus verwendet werden kann, klicken Sie mit der rechten Maustaste auf den Namen von Relying Party Trust, den Sie gerade hinzugefügt haben, und wählen Sie Properties aus. -
Wählen Sie im Eigenschaftenfenster die Registerkarte Advanced (1) aus und legen Sie
SHA-1als sicheren Hashalgorithmus (2) fest. Klicken Sie auf OK, um die Änderungen zu speichern.
-
Wählen Sie im Fenster „AD FS-Verwaltung“ die hinzugefügte Vertrauensstellung der vertrauenden Seite und anschließend die Option Edit Claim Issuance Policy... aus.
-
Wählen Sie im Fenster Edit Claim Issuance Policy Folgendes aus: Add Rule...
-
Stellen Sie im Schritt Choose Rule Type des Assistenten sicher, dass Send LDAP Attributes as Claims ausgewählt ist, und klicken Sie anschließend auf Next.
-
Geben Sie einen Claim rule name (1) an, wählen Sie
Active Directoryals Attribute store (2) und wählen Sie ein LDAP Attribute (3) aus der ID aus, die den Benutzernamen des Enterprise Server-Benutzers enthält. Dieses Attribut muss im Outgoing Claim Type (3) dem Name ID zugeordnet werden. Klicken Sie auf Finish (4). -
Stellen Sie sicher, dass die Anspruchsausstellungsrichtlinie gespeichert wird, indem Sie auf OK klicken.
-
Laden Sie die Datei
FederationMetadata.xmlvom entsprechenden Server herunter. -
Laden Sie die Metadaten-XML-Datei auf die Seite Admin – Settings – Authentication der Browseroberfläche des Enterprise Servers hoch und testen Sie anschließend die SAML-Integrationsverbindung – siehe oben.
Erweitern Sie den folgenden ausklappbaren Abschnitt, um ein schrittweises Beispiel für die Integration von AWS IAM Identity Center als Identitätsanbieter anzuzeigen:
Integration mit AWS IAM Identity Center
-
Gehen Sie zu IAM Identity Center und fügen Sie eine benutzerdefinierte SAML-2.0-Anwendung hinzu (Add Application).
-
Tragen Sie die Einstellungen für die AWS-Metadaten-URL von Ihrer Altium-SSO-Seite ein. Bestätigen Sie die Einstellungen mit Submit.
-
Laden Sie die Metadatendatei aus dem Bereich IAM Identity Center metadata herunter.
-
Gehen Sie zu Edit attribute mappings.
-
Geben Sie ein Attribut an, das den Benutzernamen des Enterprise Server-Benutzers enthalten soll, und wählen Sie
unspecifiedfür Format. -
Erstellen Sie neue Benutzer in AWS und weisen Sie die Anwendung den erstellten Benutzern oder einer Gruppe zu.
-
Stellen Sie sicher, dass dieselben Benutzer sowohl auf Altium- als auch auf IAM-Seite vorhanden sind.
-
Laden Sie die Metadaten-XML-Datei auf die Seite Admin – Settings – Authentication der Browseroberfläche des Enterprise Servers hoch und testen Sie anschließend die SAML-Integrationsverbindung – siehe oben.
Single Sign-On mit OAuth / OIDC
Die SSO-Funktion Ihres Enterprise Servers kann auch mit dem OAuth-/OIDC-Standard konfiguriert werden. Wenn die Option OAuth / OIDC in der Dropdown-Liste SSO auf der Seite Admin – Einstellungen – Authentifizierung der Browseroberfläche ausgewählt ist, können Sie auf dieser Seite die von Ihrem gewählten Identitätsanbieter bereitgestellten Daten eingeben.
-
Application Credentials:
-
Client ID – die Anwendungs-ID vom Identitätsanbieter.
-
Client Secret – das Anwendungsgeheimnis vom Identitätsanbieter.
-
-
Configuration:
-
Scopes to Request – Bereiche definieren den Umfang des Zugriffs, den Ihre Anwendung vom Benutzer anfordert.
-
Authentication Endpoint – dieser Endpunkt verarbeitet die Benutzerauthentifizierung und die Zustimmung. Ihre Anwendung leitet Benutzer zu diesem Endpunkt weiter, damit sie sich anmelden und Berechtigungen erteilen können.
-
Token Endpoint – dieser Endpunkt wird verwendet, um einen Autorisierungscode oder ein Aktualisierungstoken gegen ein Zugriffstoken auszutauschen. Dabei handelt es sich um eine sichere Backchannel-Kommunikation zwischen der Anwendung und dem Autorisierungsserver.
-
User Profile Endpoint – dieser Endpunkt ruft mithilfe eines Zugriffstokens Benutzerprofilinformationen (z. B. Name, E-Mail-Adresse) ab. Die zurückgegebenen Daten hängen von den bei der Autorisierung gewährten Bereichen ab.
-
-
Mappings – geben Sie im Feld Mapped Attribute der Tabelle das Attribut ein, das dem Benutzernamen des Benutzers auf der Enterprise Server-Seite zugeordnet werden soll.
SSO wird erst aktiviert, nachdem ein Integrationstest ausgeführt wurde, der über die Schaltfläche
gestartet wird. Dabei werden der SSO-Identitätsprozess und die SSO-Anmeldung Ihres Unternehmens überprüft. Nach erfolgreichem Test der Konfiguration können Sie die Einstellungen durch Klicken auf die Schaltfläche
speichern und damit auf den Enterprise Server anwenden.


)















































)