Wenn Sie externe login-geschützte Inhalte oder Services verlinken oder einbetten möchten, ermöglichen Sie mit dem SAML-Integrationen-Plugin eine nahtlose Nutzererfahrung. Sobald Ihre IT-Abteilung die Verbindung im SAML-Integrationen-Plugin konfiguriert hat, können Nutzer, die in der Staffbase-Plattform angemeldet sind, automatisch auf die login-geschützten Inhalte zugreifen. Das SAML-Integrationen-Plugin verwendet das SAML-Protokoll, einen Industriestandard, um die Identität eines Nutzers zwischen zwei Systemen zu authentifizieren. Dieses Feature ist besonders nützlich, wenn Sie Mitarbeitern auf Ihrer Plattform vertrauliche Unternehmensdaten zugänglich machen wollen oder sicheren Zugriff auf ein Angebot Dritter gewährleisten wollen. 

Login-geschützte Services und Inhalte mit dem SAML-Integrationen-Plugin einbetten

1. Wenden Sie sich an Ihre IT-Abteilung, um das SAML-Integrationen-Plugin für die SSO-Anmeldung einzurichten.
   Sobald die Verbindung vollständig konfiguriert ist, können Sie vor der Veröffentlichung letzte Anpassungen vornehmen. 
2. Navigieren Sie im Studio zu SAML-Integrationen.
3. Klicken Sie auf die SAML-Verbindung, die Sie einbetten möchten. 
   
   
4. Optional können Sie die Vorschau nutzen, um zu sehen, wie der eingebetteten Inhalt oder Service für Ihre Nutzer aussehen wird. 
5. Optional können Sie auf das Zahnrad klicken, um die Einstellungen für diese SAML-Integration zu öffnen und die Sichtbarkeit, Editoren oder weitere Einstellungen zu konfigurieren und zu speichern. 
6. Klicken Sie auf SAML-Integration veröffentlichen, um den login-geschützten Inhalt oder Service für Nutzer verfügbar zu machen. 
   Ein neuer Menüpunkt mit dem eingebetteten Inhalt oder Service wird der Plattform hinzugefügt.

Deeplink zu einer Seite innerhalb des login-geschützten Services einfügen

Die Einbettung mit dem SAML-Integrationen-Plugin hat den großen Vorteil, dass Sie direkt auf eine Unterseite des externen Inhalts verlinken können. Die Unterseite des externen Inhalts wird dann in die Plattform eingebettet und erscheint als eine normale Seite innerhalb Ihrer App. Die Nutzer bemerken dabei weder die Anmeldung, noch, dass der Inhalt von einer externen Quelle stammt. 

Voraussetzungen:

• Sie verfügen über den vollständigen Link zur Unterseite des externen Inhalts. 
• Der Anbieter der externen Inhalte unterstützt den SAML-RelayState. Mehr Informationen über den SAML RelayState erhalten Sie in der offiziellen SAML-Dokumentation.

1. Konfigurieren Sie die SAML-Verbindung wie beschrieben mit Hilfe Ihrer IT-Abteilung. 
2. Navigieren Sie zu der SSO-Verbindung die für den Zugriff auf die Unterseite ermöglicht.
3. Klicken sie auf das Zahnrad um die Einstellungen zu öffnen.
4. Wählen Sie bei Sichtbarkeit in der App die Option Für alle Nutzer.
5. Bei Zeige im Menü für, deaktivieren Sie die Symbole für Mobile- und Desktop-Geräte.
   
   
6. Klicken Sie auf Speichern. 
7. Klicken Sie auf SAML-Integration veröffentlichen. 
   Die SAML-Verbindung ist funktionsfähig, aber im Menü für Ihre Nutzer noch nicht sichtbar. Um Ihren Nutzern Zugriff auf die Unterseite zu gewähren, konfigurieren Sie nun den Deeplink. 
8. Klicken Sie auf Vorschau. 
9. Kopieren Sie den Link. 
   
   
10. Fügen Sie den Link in ein Textbearbeitungs-Tool ein. 
    

    Der Link darf keine Leerzeichen oder Zeilenumbrüche enthalten. Wenn der Link im Texteditor auf eine neue Zeile läuft, ist das kein Problem.

11. Passen Sie die Links wie folgt an:

• Wenn Sie den Link in einem Nachrichtenbeitrag oder auf einer Seite innerhalb der App verwenden, können Sie den kopierten Link aus Ihrer URL-Zeile verwenden.
• Fügen Sie am Ende den Pfad zur Unterseite /path-to-sub-page hinzu. Fügen Sie den Link in ein Textverarbeitungsprogramm ein. (z. B. https://app.yourcompany.com/content/saml/contentID123456/path-to-sub-page) Wenn Sie den Link in einem Nachrichtenbeitrag oder auf einer Seite innerhalb der App verwenden, können Sie einfach diesen kopierten Link verwenden.
• Wenn Sie den Link außerhalb der App verwenden möchten, fügen Sie /openlink/ nach Ihrer benutzerdefinierten Domain hinzu. Dadurch kann der Inhalt von außerhalb Ihrer Plattform eingebettet werden. (z.B. https://app.yourcompany.com/openlink/content/saml/contentID123456/path-to-sub-page

Sie können den Deeplink nun z.B. mit dem Links-Plugin oder mit dem Links-Widget verwenden. Fügen Sie den soeben erstellten Deeplink als Ziel-URL ein. 

Wie Nutzer den eingebetteten Inhalt in der App sehen

Betten Sie mit SAML-Integrationen z.B. Ihr Ideen-Portal ein und machen Sie es Ihren Nutzern als Menüpunkt zugänglich: 

Mit Hilfe von Deeplinking können Sie besonders beliebte Ideen direkt in Ihrem Ideen-Portal anzeigen lassen:

Weitere hilfreiche Informationen

• Weitere Informationen zu Deeplinks auf der Staffbase-Plattform