Fehlerbehebung
Was muss ich dem Citrix Support und Engineering zur Verfügung stellen, wenn ich einen SAML-Supportfall eröffne?
Falls Sie Unterstützung bei einem SAML-bezogenen Problem benötigen, benötigt der Citrix Support und Engineering die folgenden Informationen:
- Geben Sie ausreichend Kontext an und beschreiben Sie Ihr Anmeldeszenario sowie Ihre Citrix- oder Active Directory-Umgebung.
- Welche Citrix eDocs Sie bei der Erstkonfiguration befolgt haben.
- Screenshots und Details Ihrer SAML-Anwendung in Ihrem IdP.
- Details Ihres Active Directory.
- Eine SAML-Tracer-Datei (
.json) von der SAML-Tracer-Browsererweiterung. - Eine HAR-Datei (
.har) aus den Entwicklertools Ihres Browsers. - Details zu funktionierenden und fehlerhaften Endbenutzern oder Citrix Cloud-Administratorbenutzern.
- Die öffentliche Anrufer-IP des Computers, der eine SAML-Anmeldung bei Store oder Citrix Cloud durchführt.
SAML-Traces für Citrix Support und Engineering erfassen
Citrix Engineering und Support empfehlen die Verwendung der SAML-Tracer-Browsererweiterung für alle SAML-Debugging-Zwecke sowie .HAR-Dateien, die von Browser-Entwicklertools generiert werden. Diese Erweiterung ist für die meisten gängigen Webbrowser verfügbar und exportiert .JSON-Dateien. Die Erweiterung dekodiert SAML-Anfragen und -Antworten in XML, wodurch sie menschenlesbar und wesentlich einfacher zu verstehen und zu debuggen sind.
Wie erfasse ich eine HAR-Datei von meinem Browser, um sie an den Citrix Support und das Engineering zu senden?
Weitere Informationen finden Sie im Artikel HAR-Datei erfassen
Nützliche SAML-Debugging-Tools von Drittanbietern
WICHTIG:
Citrix übernimmt keine Haftung, wenn Tools von Drittanbietern zu Debugging-Zwecken verwendet werden. Die Nutzung und der Zugriff auf Tools und Websites von Drittanbietern erfolgt auf eigenes Risiko.
| Tool | Zweck |
|---|---|
| https://www.samltool.io/ | Dekodiert Base64-SAML-Anfragen und -Antworten |
| https://www.sslshopper.com/certificate-decoder.html | Dekodiert Zertifikatsdaten |
| https://www.rcfed.com/SAMLWSFed/MetadataCertificateExtract | Extrahiert Signatur- und Verschlüsselungszertifikate als Dateien aus SAML-Metadaten |
| https://www.whatismyip.com/ | Stellt die aufrufende IP-Adresse des Clients bereit, der eine SAML-Anmeldung versucht. |
Attributfehler
Attributfehler können unter einer der folgenden Bedingungen auftreten:
- Die erforderlichen Attribute in Ihrer SAML-Konfiguration sind nicht korrekt kodiert.
- Die Attribute
cip_sidundcip_upnfehlen in der SAML-Assertion. - Die Attribute
cip_sidodercip_oidfehlen in der SAML-Assertion, und Citrix Cloud kann sie aufgrund eines Konnektivitätsproblems nicht aus Active Directory abrufen.
Wenn ein Attributfehler auftritt, zeigt Citrix Cloud eine Fehlermeldung an, die die fehlerhaften Attribute enthält.
So beheben Sie diese Art von Fehler:
-
Stellen Sie sicher, dass Ihr SAML-Anbieter die erforderlichen Attribute mit der korrekten Kodierung sendet, wie in der folgenden Tabelle gezeigt. Mindestens das SID- oder UPN-Attribut muss enthalten sein.
Attribut Kodierung Erforderlich cip_email Muss im String-Format vorliegen ( user@domain)cip_oid Muss im Base64- oder String-Format vorliegen cip_sid Muss im Base64- oder String-Format vorliegen Ja, wenn cip_upnnicht verwendet wirdcip_upn Muss im String-Format vorliegen ( user@domain)Ja, wenn cip_sidnicht verwendet wird -
Stellen Sie sicher, dass die Cloud Connectors online und fehlerfrei sind, damit Citrix Cloud alle fehlenden Attribute abrufen kann, die es benötigt. Weitere Informationen finden Sie unter Erweiterte Integritätsprüfungen für Cloud Connectors.
Unerwartete Fehler
In den folgenden Fällen kann in Citrix Cloud ein unerwarteter Fehler auftreten:
- Ein Benutzer initiiert eine SAML-Anfrage über einen IDP-initiierten Flow. Zum Beispiel wird die Anfrage durch Auswahl einer Kachel über das App-Portal des Identitätsanbieters gestellt, anstatt direkt zur Store-URL (
customer.cloud.com) zu navigieren. - Das SAML-Zertifikat ist ungültig oder abgelaufen.
- Der Authentifizierungskontext ist ungültig.
- Die SAML-Assertion und die Antwortsignatur stimmen nicht überein.
Wenn dieser Fehler auftritt, zeigt Citrix Cloud eine generische Fehlermeldung an.
Wenn dieser Fehler durch die Navigation zu Citrix Cloud über das App-Portal eines Identitätsanbieters verursacht wird, können Sie die folgende Problemumgehung verwenden:
- Erstellen Sie eine Lesezeichen-App im App-Portal des Identitätsanbieters, die auf Ihre Store-URL verweist (zum Beispiel
https://customer.cloud.com). - Weisen Sie Benutzern sowohl der SAML-App als auch der Lesezeichen-App zu.
- Ändern Sie die Sichtbarkeitseinstellungen der SAML-App und der Lesezeichen-App, sodass die Lesezeichen-App sichtbar und die SAML-App im App-Portal ausgeblendet ist.
- Deaktivieren Sie die Einstellung Endbenutzer immer zur Eingabe ihrer Anmeldeinformationen auffordern in Citrix® StoreFront Cloud, um zusätzliche Kennwortabfragen zu entfernen. Anweisungen finden Sie unter Endbenutzer immer zur Eingabe ihrer Anmeldeinformationen auffordern.
In diesem Artikel
- Was muss ich dem Citrix Support und Engineering zur Verfügung stellen, wenn ich einen SAML-Supportfall eröffne?
- SAML-Traces für Citrix Support und Engineering erfassen
- Wie erfasse ich eine HAR-Datei von meinem Browser, um sie an den Citrix Support und das Engineering zu senden?
- Nützliche SAML-Debugging-Tools von Drittanbietern
- Attributfehler
- Unerwartete Fehler