Basis-Konfiguration verwalten

Auf dieser Seite erfahren Sie, wie Sie die Single-Sign-On-Funktion für Ihre Prozessplattform aktivieren können und welche Einstellungsmöglichkeiten Ihnen zur Verfügung stehen, um eine zuverlässige und sichere Kommunikation zwischen der Prozessplattform und Ihrem Identitätsmanagement-System (Identity Provider) zu gewährleisten.

Inhaltsverzeichnis

 

Stammdaten pflegen

 

Die Stammdaten der SAML-Konfiguration können Sie in den oben zu sehenden Feldern pflegen. Die Stammdaten der SAML-Konfiguration umfassen die Beschriftung der beiden Login-Knöpfe und den Status (aktiv oder nicht aktiv) der SAML-Konfiguration.

Über das Feld "Single-Sign-On aktivieren?" können Sie festlegen, ob den Nutzern Ihrer PICTURE-Prozessplattform die Möglichkeit gegeben werden soll, sich per Single-Sign-On (auf Basis der erstellten Konfiguration) zu authentifizieren (Häkchen muss gesetzt sein) oder nicht (Feld muss leer gelassen werden).

Über das Feld "Single Logout aktivieren?" können Sie festlegen, ob den Nutzern Ihrer PICTURE-Prozessplattform die Möglichkeit gegeben werden soll, sich per Single Logout aus der PICTURE-Prozessplattform und dem Identity-Provider (und damit allen anderen verbundenen Systemen) auszuloggen. Diese Einstellung hat nur Auswirkungen, wenn Single-Sign-On aktiv ist. Ist diese Option deaktiviert, so steht kein Logout-Button zur Verfügung.

Der Text den Sie unter "Beschriftung des zusätzlichen Login-Knopfs" und “Beschriftung des PICTURE-Prozessplattform Login-Knopfs” angeben, findet sich nach dem erfolgreichen Speichern der SAML-Konfiguration auf der Login-Seite wieder, sofern Sie die SAML-Konfiguration aktiviert haben. 

 

Unter "Fehlermeldung bei Anforderung eines neuen Passwortes" können Sie optional angeben, welche Fehlermeldung ein Anwender erhalten soll, wenn dieser ein neues Passwort über die Login-Maske anfordert, aber bisher kein eigenes Passwort für die Prozessplattform hat, da er sich über Single-Sign-On authentifiziert. 

Wir empfehlen Ihnen einen Hyperlink in die Fehlermeldung einzubinden, über den ein Anwender Informationen zum Zurücksetzen des Passwortes bei dem genutzten Identity-Provider findet. Um einen Hyperlink in die Fehlermeldung einzubinden, können Sie den Link einfach an die gewünschte Stelle in Ihrer Fehlermeldung einfügen. Der eingefügte Hyperlink muss mit "http" oder "https" beginnen, damit er später in der angezeigten Fehlermeldung als Link formatiert wird und klickbar ist.

 

Falls Sie keine individuelle Fehlermeldung konfigurieren möchten, können Sie das Feld einfach leer lassen. In diesem Fall wird die folgende Standard-Fehlermeldung der Prozessplattform ausgeben:

Weiterleitungen für SAML-authentifizierte Nutzer festlegen

Sie können drei verschiedene Arten von Weiterleitungen für SAML-authentifizierte Nutzer festlegen.

 

Wie Sie die Weiterleitungen konfigurieren können und wann diese aktiv werden, erfahren Sie im Folgenden.

Weiterleitung nach erfolgreichem Login (Startseite)

In dem oben zu sehenden Eingabefeld können Sie festlegen, zu welcher Seite der PICTURE-Prozessplattform Nutzer, die sich erfolgreich bei dem Identity-Provider authentifiziert haben, weitergeleitet werden sollen. Die Festlegung der Startseite (Weiterleitung nach erfolgreichem Login) ist optional. Wird hier kein Wert eingetragen, verhält sich die PICTURE-Prozessplattform wie bei einem Standard-Login (Weiterleitung auf die Startseite des zuletzt genutzten Arbeitsbereichs).

Falls Sie als Startseite das Prozessregister eines bestimmten Arbeitsbereiches festlegen möchten, besteht zudem die Möglichkeit bestimmte Filter über die URL einzustellen, sodass neu eingeloggte Nutzer zunächst eine vordefinierte Prozess- und Prozesslandkarten-Menge sehen können. Wie Sie eine URL erstellen können, die auf das Prozessregister verweist und ggf. sogar auf eine bestimmte Filteransicht erfahren Sie auf folgender Seite des Informationsportals: Prozessregister mithilfe von Filtern durchsuchen

Falls Sie als Startseite nicht das Prozessregister, sondern einen anderen Bereich der PICTURE-Prozessplattform festlegen möchten, können Sie sich einfach in die Plattform einloggen und zu der Seite wechseln, die Sie als Startseite festlegen möchten. Wenn Sie auf der gewünschten Seite sind, übernehmen Sie aus der Adresszeile Ihres Browsers die URL und geben diese im Eingabefeld für die Startseite ein, damit per SAML authentifizierte Nutzer nach dem Login direkt zu der gerade geöffneten Seite weitergeleitet werden.

Unabhängig davon, welche Seite Sie als Startseite festgelegt haben müssen Sie bei der Eingabe in das Feld für die Startseite berücksichtigen, dass Sie nur den Teil der URL eingeben müssen, der nicht bereits eine Zeile über dem Eingabefeld unter "Feste Adresse (URL) Ihrer Prozessplattform" angezeigt wird.

Weiterleitung nach fehlgeschlagenem Login

Ein Login eines Nutzers, der sich erfolgreich per SAML beim Identity-Provider authentifiziert hat, kann dennoch aus den folgenden Gründen fehlschlagen:

  • Er besitzt noch kein Schattennutzerkonto und durch die konfigurierte automatische Nutzererstellung würde seinem neuen Konto keine Lizenz zugewiesen werden.

    • Dieser Fall tritt z.B. immer dann ein, wenn durch die Konfiguration der automatischen Nutzererstellung bestimmten Gruppen von Nutzern der Zutritt zur Plattform verwehrt werden soll.

  • Er besitzt bereits ein Schattennutzerkonto, aber

    • dieses wurde gesperrt

    • er besitzt keine Lizenz

  • Es wurde der für die PICTURE-Prozessplattform geschützte Benutzername “admin” verwendet

In den oben genannten Fällen bietet Ihnen diese Einstellung die Möglichkeit dem Nutzer nicht die standardmäßige Fehlermeldung der Plattform anzuzeigen, sondern ihn z.B. auf eine entsprechende Intranet-Seite weiterzuleiten, auf der erklärt wird, welche Mitarbeiter Ihrer Organisation Zugriff auf die Plattform haben.

Weiterleitung nach Logout

Mit dieser Einstellung können Sie den Nutzer nach einem erfolgreichen Single-Logout aus der Plattform zu einer von Ihnen gewünschten URL weiterleiten. 

Adressdaten (URLs) pflegen

Identity-Provider-Adressen pflegen

Um Single-Sign-On über SAML in Ihrer PICTURE-Prozessplattform nutzen zu können, benötigt die Prozessplattform als Service-Provider Informationen über den von Ihnen genutzten Identity-Provider. Dazu müssen Sie die oben zu sehenden Einstellungsmöglichkeiten mit den jeweiligen Daten Ihres Identity-Providers ausfüllen.

Am Identity-Provider zu hinterlegende Service-Provider-Adressen einsehen

Um Single-Sign-On über SAML in Ihrer PICTURE-Prozessplattform nutzen zu können, benötigt der von Ihnen genutzte Identity-Provider Informationen über die PICTURE-Prozessplattform als Service-Provider. Dazu müssen Sie die oben angezeigten Einstellungsmöglichkeiten bei Ihrem Identity-Provider an geeigneter Stelle hinterlegen.

Signierung und Verschlüsselung von SAML-Nachrichten

Identity-Provider-Zertifikat hinterlegen

Um Single-Sign-On sicher und zuverlässig nutzen zu können, müssen Sie in dem oben zu sehenden Eingabefeld das X.509-Zertifikat hinterlegen, über welches SAML-Nachrichten Ihres Identity-Providers eindeutig als solche identifiziert werden können. Das hier zu hinterlegende Zertifikat können Sie im Normalfall von Ihrem Identity-Provider übernehmen, da dies dort bereits vorliegen sollte.

Prozessplattform- bzw. Service-Provider-Schlüsselpaar hinterlegen

Um Single-Sign-On sicher und zuverlässig nutzen zu können, müssen Sie für Ihre Prozessplattform ein eigenes Schlüsselpaar - bestehend aus einem privaten Schlüssel im PKCS#8-Format und einem X.509-Zertifikat - generieren und hinterlegen. Das generierte Zertifikat müssen Sie zudem bei Ihrem Identity-Provider hinterlegen. Mit Hilfe des Zertifikats kann Ihr Identity-Provider feststellen, ob eine erhaltene SAML-Nachricht mit dem in der Prozessplattform hinterlegten privaten Schlüssel signiert wurde und somit sicherstellen, dass diese von genau diesem Prozessplattform-Mandanten stammt.

FAQ - Basis-Konfiguration

Wie kann ich die XML-Metadaten der Prozessplattform herunterladen?

Sie können die XML-Metadaten der Prozessplattform über die URL, die auf dem Reiter "Basis-Konfiguration" im Abschnitt "Prozessplattform bzw. Service-Provider-Adressen" im Eingabefeld "Identifikator der Prozessplattform als Service-Provider" angezeigt wird herunterladen.

Berücksichtigen Sie, dass die Metadaten erst vollständig ausgeliefert werden können, wenn Sie das X.509-Zertifikat im Abschnitt "Prozessplattform bzw. Service-Provider-Schlüsselpaar" hinterlegt haben. Haben Sie das X.509-Zertifikat noch nicht hinterlegt, kann dieses bei einer Abfrage der XML-Metadaten über die o.g. URL nicht mit ausgeliefert werden.