SAML für Single Sign-On mit Citrix Files

Last published : Oct 21, 2026
Haftungsausschluss:
Diese Funktion wird eingestellt, wenn ShareFile (jetzt Progress) die Unterstützung einstellt.
Sie können XenMobile® und ShareFile so konfigurieren, dass sie die Security Assertion Markup Language (SAML) verwenden, um Single Sign-On (SSO)-Zugriff auf mobile Citrix Files-Apps zu ermöglichen. Diese Funktionalität umfasst:
  • Citrix Files-Apps, die MAM SDK-fähig sind oder mit dem MDX Toolkit umschlossen wurden
  • Nicht umschlossene Citrix Files-Clients, wie die Website, das Outlook-Plug-in oder Synchronisierungs-Clients
  • Für umschlossene Citrix Files-Apps. Benutzer, die sich über die mobile Citrix Files-App bei Citrix Files anmelden, werden zur Benutzerauthentifizierung und zum Abrufen eines SAML-Tokens zu Secure Hub umgeleitet. Nach erfolgreicher Authentifizierung sendet die mobile Citrix Files-App das SAML-Token an ShareFile. Nach der ersten Anmeldung können Benutzer über SSO auf die mobile Citrix Files-App zugreifen. Sie können auch Dokumente von ShareFile an Secure Mail-E-Mails anhängen, ohne sich jedes Mal anmelden zu müssen.
  • Für nicht umschlossene Citrix Files-Clients. Benutzer, die sich über einen Webbrowser oder einen anderen Citrix Files-Client bei Citrix Files anmelden, werden zu XenMobile umgeleitet. XenMobile authentifiziert die Benutzer, die dann ein SAML-Token erhalten, das an ShareFile gesendet wird. Nach der ersten Anmeldung können Benutzer über SSO auf Citrix Files-Clients zugreifen, ohne sich jedes Mal anmelden zu müssen.
Um XenMobile als SAML-Identitätsanbieter (IdP) für ShareFile zu verwenden, müssen Sie XenMobile für die Verwendung mit Enterprise-Konten konfigurieren, wie in diesem Artikel beschrieben. Alternativ können Sie XenMobile so konfigurieren, dass es nur mit Speicherzonen-Konnektoren funktioniert. Weitere Informationen finden Sie unter ShareFile mit XenMobile verwenden.
Ein detailliertes Referenzarchitekturdiagramm finden Sie unter Architektur.
Related information
Zertifikate und Authentifizierung

Voraussetzungen

Erfüllen Sie die folgenden Voraussetzungen, bevor Sie SSO mit XenMobile und Citrix Files-Apps konfigurieren können:
  • Das MAM SDK oder eine kompatible Version des MDX Toolkit (für mobile Citrix Files-Apps).
    Weitere Informationen finden Sie unter XenMobile-Kompatibilität.
  • Eine kompatible Version der mobilen Citrix Files-Apps und Secure Hub.
  • ShareFile-Administratorkonto.
  • Verbindung zwischen XenMobile und ShareFile überprüft.

ShareFile-Zugriff konfigurieren

Bevor Sie SAML für ShareFile einrichten, geben Sie die ShareFile-Zugriffsinformationen wie folgt an:
  1. Klicken Sie in der XenMobile-Webkonsole auf Konfigurieren > ShareFile. Die Konfigurationsseite ShareFile wird angezeigt.
    ShareFile-Konfigurationseinstellungen
  2. Konfigurieren Sie diese Einstellungen:
    • Domäne: Geben Sie den Namen Ihrer ShareFile-Subdomäne ein. Beispiel: example.sharefile.com.
    • Zuweisen zu Bereitstellungsgruppen: Wählen oder suchen Sie die Bereitstellungsgruppen, die SSO mit ShareFile verwenden sollen.
    • Anmeldung des ShareFile-Administratorkontos
    • Benutzername: Geben Sie den Benutzernamen des ShareFile-Administrators ein. Dieser Benutzer muss Administratorberechtigungen besitzen.
    • Kennwort: Geben Sie das Kennwort des ShareFile-Administrators ein.
    • Benutzerkontenbereitstellung: Lassen Sie diese Einstellung deaktiviert. Verwenden Sie das ShareFile-Benutzerverwaltungstool für die Benutzerbereitstellung. Siehe Benutzerkonten und Verteilergruppen bereitstellen.
  3. Klicken Sie auf Verbindung testen, um zu überprüfen, ob der Benutzername und das Kennwort für das ShareFile-Administratorkonto eine Authentifizierung beim angegebenen ShareFile-Konto ermöglichen.
  4. Klicken Sie auf Speichern.
    • XenMobile synchronisiert sich mit ShareFile und aktualisiert die ShareFile-Einstellungen ShareFile Issuer/Entity ID und Login URL.
    • Die Seite Configure > ShareFile zeigt den App internal name an. Sie benötigen diesen Namen, um die später in SSO-Einstellungen für Citrix Files.com ändern beschriebenen Schritte auszuführen.

SAML für umschlossene Citrix Files MDX-Apps einrichten

Sie müssen Citrix Gateway nicht für die Single Sign-On-Konfiguration mit umschlossenen Citrix Files MDX-Apps verwenden. Informationen zum Konfigurieren des Zugriffs für nicht umschlossene Citrix Files-Clients, wie z. B. die Website, das Outlook-Plug-in oder die Synchronisierungs-Clients, finden Sie unter Citrix Gateway für andere Citrix Files-Clients konfigurieren.
Die folgenden Schritte gelten für iOS- und Android-Apps und -Geräte. So konfigurieren Sie SAML für umschlossene Citrix Files MDX-Apps:
  1. Umschließen Sie die mobile Citrix Files-App mit dem MDX Toolkit. Weitere Informationen zum Umschließen von Apps mit dem MDX Toolkit finden Sie unter Umschließen von Apps mit dem MDX Toolkit.
  2. Laden Sie in der XenMobile-Konsole die umschlossene mobile Citrix Files-App hoch. Informationen zum Hochladen von MDX-Apps finden Sie unter Hinzufügen einer MDX-App zu XenMobile.
  3. SAML-Einstellungen überprüfen: Melden Sie sich bei ShareFile mit dem zuvor konfigurierten Administrator-Benutzernamen und -Passwort an.
  4. Stellen Sie sicher, dass ShareFile und XenMobile für dieselbe Zeitzone konfiguriert sind. Stellen Sie sicher, dass XenMobile die korrekte Uhrzeit für die konfigurierte Zeitzone anzeigt. Andernfalls kann das SSO fehlschlagen.

Mobile Citrix Files-App validieren

  1. Installieren und konfigurieren Sie Secure Hub auf dem Benutzergerät.
  2. Laden Sie die mobile Citrix Files-App aus dem XenMobile Store herunter und installieren Sie sie.
  3. Starten Sie die mobile Citrix Files-App. Citrix Files startet, ohne zur Eingabe von Benutzername oder Passwort aufzufordern.

Mit Secure Mail validieren

  1. Installieren und konfigurieren Sie Secure Hub auf dem Benutzergerät, falls dies noch nicht geschehen ist.
  2. Laden Sie Secure Mail aus dem XenMobile Store herunter, installieren und richten Sie es ein.
  3. Öffnen Sie ein neues E-Mail-Formular und tippen Sie dann auf Von Citrix Files anhängen. Dateien, die an die E-Mail angehängt werden können, werden angezeigt, ohne dass ein Benutzername oder Kennwort abgefragt wird.

Citrix Gateway für andere Citrix Files-Clients konfigurieren

Um den Zugriff für nicht-eingekapselte Citrix Files-Clients, wie die Website, das Outlook-Plug-In oder die Synchronisierungsclients, zu konfigurieren: Konfigurieren Sie Citrix Gateway wie folgt, um die Verwendung von XenMobile als SAML-Identitätsanbieter zu unterstützen.
  • Umleitung der Startseite deaktivieren.
  • Eine Citrix Files-Sitzungsrichtlinie und ein Profil erstellen.
  • Richtlinien auf dem virtuellen Citrix Gateway-Server konfigurieren.

Umleitung der Startseite deaktivieren

Deaktivieren Sie das Standardverhalten für Anforderungen, die über den Pfad /cginfra eingehen. Diese Aktion ermöglicht es Benutzern, die ursprünglich angeforderte interne URL anstelle der konfigurierten Startseite zu sehen.
  1. Bearbeiten Sie die Einstellungen für den virtuellen Citrix Gateway-Server, der für XenMobile-Anmeldungen verwendet wird. Gehen Sie in Citrix ADC zu Weitere Einstellungen und deaktivieren Sie dann das Kontrollkästchen Auf Startseite umleiten.
    Citrix ADC-Bildschirm
  2. Geben Sie unter ShareFile (jetzt ShareFile genannt) den internen Servernamen und die Portnummer Ihres XenMobile-Servers ein.
  3. Geben Sie unter Citrix Endpoint Management™ Ihre XenMobile-URL ein. Ihre Version von Citrix Gateway kann sich auf den älteren Produktnamen AppController beziehen.
    Diese Konfiguration autorisiert Anforderungen an die von Ihnen eingegebene URL über den Pfad /cginfra.

Eine Citrix Files-Sitzungsrichtlinie und ein Anforderungsprofil erstellen

Konfigurieren Sie die folgenden Einstellungen, um eine Citrix Files-Sitzungsrichtlinie und ein Anforderungsprofil zu erstellen:
  1. Klicken Sie im Konfigurationsdienstprogramm von Citrix Gateway im linken Navigationsbereich auf Citrix Gateway > Richtlinien > Sitzung.
  2. Erstellen Sie eine Sitzungsrichtlinie. Klicken Sie auf der Registerkarte Richtlinien auf Hinzufügen.
  3. Geben Sie im Feld Name ShareFile_Policy ein.
  4. Erstellen Sie eine Aktion, indem Sie auf die Schaltfläche + klicken. Die Seite Sitzungsprofil erstellen wird angezeigt.
    Konfigurieren Sie die folgenden Einstellungen:
    • Name: Geben Sie ShareFile_Profile ein.
    • Klicken Sie auf die Registerkarte Client Experience und konfigurieren Sie dann die folgenden Einstellungen:
      • Startseite: Geben Sie none ein.
      • Sitzungs-Timeout (Min.): Geben Sie 1 ein.
      • Single Sign-on für Webanwendungen: Wählen Sie diese Einstellung aus.
      • Anmeldeinformationsindex: Klicken Sie auf PRIMARY.
    • Klicken Sie auf die Registerkarte Veröffentlichte Anwendungen.
    Konfigurieren Sie diese Einstellungen:
    • ICA® Proxy: Klicken Sie auf EIN.
    • Web Interface Address: Geben Sie Ihre XenMobile Server-URL ein.
    • Single Sign-on Domain: Geben Sie Ihren Active Directory-Domänennamen ein.
      Beim Konfigurieren des Citrix Gateway-Sitzungsprofils muss das Domänensuffix für Single Sign-on Domain mit dem in LDAP definierten XenMobile-Domänenalias übereinstimmen.
  5. Klicken Sie auf Erstellen, um das Sitzungsprofil zu definieren.
  6. Klicken Sie auf Expression Editor.
    Citrix Gateway-Sitzungsprofil-Bildschirm
    Konfigurieren Sie diese Einstellungen:
    • Wert: Geben Sie NSC_FSRD ein.
    • Header Name: Geben Sie COOKIE ein.
  7. Klicken Sie auf Erstellen und dann auf Schließen.
    Citrix Gateway-Sitzungsprofil-Bildschirm

Richtlinien auf dem virtuellen Citrix Gateway-Server konfigurieren

Konfigurieren Sie diese Einstellungen auf dem virtuellen Citrix Gateway-Server.
  1. Klicken Sie im Citrix Gateway-Konfigurationsdienstprogramm im linken Navigationsbereich auf Citrix Gateway > Virtuelle Server.
  2. Klicken Sie im Bereich Details auf Ihren virtuellen Citrix Gateway-Server.
  3. Klicken Sie auf Bearbeiten.
  4. Klicken Sie auf Konfigurierte Richtlinien > Sitzungsrichtlinien und dann auf Bindung hinzufügen.
  5. Wählen Sie ShareFile_Policy aus.
  6. Bearbeiten Sie die automatisch generierte Prioritätsnummer für die ausgewählte Richtlinie, sodass sie die höchste Priorität (die kleinste Zahl) im Verhältnis zu allen anderen aufgeführten Richtlinien hat. Zum Beispiel:
  7. Klicken Sie auf Fertig und speichern Sie dann die laufende Citrix ADC-Konfiguration.

Citrix Files.com SSO-Einstellungen ändern

Nehmen Sie die folgenden Änderungen für MDX- und Nicht-MDX-Citrix Files-Apps vor.
Wichtig:
Eine neue Nummer wird an den internen Anwendungsnamen angehängt:
  • Jedes Mal, wenn Sie die Citrix Files-App bearbeiten oder neu erstellen
  • Jedes Mal, wenn Sie die ShareFile-Einstellungen in XenMobile ändern
Daher müssen Sie auch die Anmelde-URL auf der Citrix Files-Website aktualisieren, um den aktualisierten App-Namen widerzuspiegeln.
  1. Melden Sie sich bei Ihrem ShareFile-Konto (https://<subdomain>.sharefile.com) als ShareFile-Administrator an.
  2. In der ShareFile-Weboberfläche klicken Sie auf Admin und wählen dann Configure Single Sign-on aus.
  3. Bearbeiten Sie die Login URL wie folgt:
    Hier ist eine Beispiel-Login URL vor den Bearbeitungen: https://xms.citrix.lab/samlsp/websso.do?action=authenticateUser&app=ShareFile_SAML_SP&reqtype=1.
    Beispiel-Login-URL
    • Fügen Sie den externen FQDN des virtuellen Citrix Gateway-Servers plus /cginfra/https/ vor dem XenMobile Server-FQDN ein und fügen Sie dann 8443 nach dem XenMobile-FQDN hinzu.
      Hier ist ein Beispiel einer bearbeiteten URL: https://nsgateway.acme.com/cginfra/https/xms.citrix.lab:8443/samlsp/websso.do?action=authenticateUser&app=SHareFile_SAML_SP&reqtype=1
    • Ändern Sie den Parameter &app=ShareFile_SAML_SP in den internen Anwendungsnamen von Citrix Files. Der interne Name ist standardmäßig ShareFile_SAML. Jedes Mal, wenn Sie Ihre Konfiguration ändern, wird jedoch eine Zahl an den internen Namen angehängt (ShareFile_SAML_2, ShareFile_SAML_3 usw.). Sie können den internen App-Namen auf der Seite Configure > ShareFile nachschlagen.
      Hier ist ein Beispiel einer bearbeiteten URL: https://nsgateway.acme.com/cginfra/https/xms.citrix.lab:8443/samlsp/websso.do?action=authenticateUser&app=ShareFile_SAML&reqtype=1
    • Fügen Sie &nssso=true am Ende der URL hinzu.
      Hier ist ein Beispiel der finalen URL: https://nsgateway.acme.com/cginfra/https/xms.citrix.lab:8443/samlsp/websso.do?action=authenticateUser&app=ShareFile_SAML&reqtype=1&nssso=true.
  4. Unter Optionale Einstellungen aktivieren Sie das Kontrollkästchen Webauthentifizierung aktivieren.
    Bildschirm für optionale Einstellungen

Konfiguration überprüfen

Führen Sie die folgenden Schritte aus, um die Konfiguration zu überprüfen.
  1. Navigieren Sie mit Ihrem Browser zu https://<subdomain>sharefile.com/saml/login.
    Sie werden zum Anmeldeformular von Citrix Gateway weitergeleitet. Wenn Sie nicht weitergeleitet werden, überprüfen Sie die vorhergehenden Konfigurationseinstellungen.
  2. Geben Sie den Benutzernamen und das Kennwort für die Citrix Gateway- und XenMobile-Umgebung ein, die Sie konfiguriert haben.
    Ihre Citrix Files-Ordner unter <subdomain>.sharefile.com werden angezeigt. Wenn Sie Ihre Citrix Files-Ordner nicht sehen, stellen Sie sicher, dass Sie die richtigen Anmeldeinformationen eingegeben haben.