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.

  • Wenn die Verwendung von SSO erzwungen wird (die Option Enforce SSO (not applied to access from localhost) ist auf der Seite Admin – Settings – Authentication der Browseroberfläche aktiviert), wird Benutzern unmittelbar nach dem Aufrufen der Enterprise Server-Adresse die SSO-Anmeldeseite angezeigt.

  • Der SSO-Zugriff kann auch beim Herstellen einer Verbindung zum Enterprise Server Workspace aus Altium Designer verwendet werden. Weitere Informationen finden Sie auf der Seite Zugriff auf Ihren Workspace.

     
     

    Wenn EDMS.UnifiedLogin den Status „Public“ hat, aktualisieren Sie den folgenden Absatz mit dem Quellcode des Snippets „Open Beta Feature Moves to Public“.

    Beachten Sie, dass Sie zum Herstellen einer Verbindung mit Ihrem Enterprise Server Workspace über einen externen Browser den Ansatz der „einheitlichen Anmeldung“ verwenden müssen, um die SSO-Zugriffsfunktion in Altium Designer nutzen zu können. Diese Funktion befindet sich in der offenen Betaphase und ist verfügbar, wenn die Option EDMS.UnifiedLogin im Dialogfeld Erweiterte Einstellungen von Altium Designer aktiviert ist.

Weitere Informationen zum Zugriff auf die Browseroberfläche von Enterprise Server finden Sie auf der Seite Die browserbasierte Oberfläche erkunden.

Bei Verwendung eines internen Identitätsanbieters muss Enterprise Server dem HTTPS-Zertifikat vertrauen, das dieser Identitätsanbieter verwendet. Andernfalls wird beim Versuch, von Enterprise Server aus eine Verbindung zu ihm herzustellen, eine Fehlermeldung angezeigt. Identitätsanbieter großer Anbieter (Okta, Entra ID usw.) verfügen standardmäßig über geeignete vertrauenswürdige Zertifikate.

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.

  • Wenn SSO anschließend manuell oder infolge einer Konfigurationsänderung deaktiviert wird, steht die Schaltfläche  Zum Verschieben klicken und ziehen​ zur Verfügung, sodass der Testvorgang wiederholt werden kann.

  • Bei Bedarf kann das Feld Entity ID in den Altium Metadata Configuration -Einstellungen geändert werden (beispielsweise, um zwei Serverinstanzen eindeutig voneinander zu unterscheiden).

  • Achten Sie beim Konfigurieren von SSO darauf, dass der vom Identitätsanbieter bereitgestellte Benutzername exakt mit dem Username des entsprechenden vorhandenen Benutzers in Enterprise Server übereinstimmt (unabhängig davon, ob für den Benutzer die Authentifizierung über Built-in oder Windows konfiguriert ist). Beim Abgleich der Benutzernamen wird zwischen Groß- und Kleinschreibung unterschieden.

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.

Klappen Sie den folgenden Abschnitt auf, um ein schrittweises Beispiel für die Integration von Okta als Identitätsanbieter anzuzeigen.

Erweitern Sie den ausklappbaren Abschnitt unten, um ein schrittweises Beispiel für die Integration von Microsoft Entra ID als Identitätsanbieter anzuzeigen.

Erweitern Sie den ausklappbaren Abschnitt unten, um ein schrittweises Beispiel für die Integration von JumpCloud als Identitätsanbieter anzuzeigen.

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.

Erweitern Sie den folgenden ausklappbaren Abschnitt, um ein schrittweises Beispiel für die Integration von AWS IAM Identity Center als Identitätsanbieter anzuzeigen:

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.

Wenn SSO anschließend entweder manuell oder aufgrund einer Konfigurationsänderung deaktiviert wird, ist die Schaltfläche  verfügbar, sodass der Testvorgang wiederholt werden kann.

Beachten Sie bei der Verwendung von Entra ID, dass zwei API-Versionen für die OAuth-Endpunkte bereitgestellt werden:

  • https://login.microsoftonline.com/{tenantId}/.well-known/openid-configuration

  • https://login.microsoftonline.com/{tenantId}/v2.0/.well-known/openid-configuration

Sie müssen den richtigen Satz von Endpunkten (token/authorize/userinfo) aus einer dieser Varianten abrufen. Wenn Sie diese mischen, tritt beim Versuch, eine Verbindung vom Enterprise Server zu Entra ID herzustellen, ein Fehler auf.

AI-LocalizedKI-lokalisiert
Wenn Sie ein Problem feststellen, wählen Sie den Text/das Bild aus und drücken SieCtrl + Enter, um uns Ihr Feedback zu senden.
Contents
Contents