{"id":1650,"date":"2010-01-06T11:47:17","date_gmt":"2010-01-06T11:47:17","guid":{"rendered":"http:\/\/neu.koetzingit.de\/citrix-sessionsharingkey-verstehen\/"},"modified":"2026-06-02T13:33:34","modified_gmt":"2026-06-02T13:33:34","slug":"citrix-sessionsharingkey-verstehen","status":"publish","type":"post","link":"https:\/\/www.koetzingit.de\/en\/citrix-sessionsharingkey-verstehen\/","title":{"rendered":"Understanding the Citrix SessionSharingKey"},"content":{"rendered":"<p><span class=\"dropcapmiddle\">S<\/span>chon mal\u00a0etwas vom\u00a0Web Interface<strong> Session Sharing Key<\/strong> geh\u00f6rt? Wahrscheinlich nicht aber ich vermute das einige\u00a0 Unternehmen mit dem Sharing Key ein Problem haben\u00a0und es nicht wissen. Nat\u00fcrlich erkennen Sie, dass Sitzungen nicht &#8222;Geschert&#8220; werden oder sogar auf dem gleichen xenApp Server eine neue Sitzung starten. Vor einigen Jahren habe ich einen Artikel \u00fcber <a href=\"http:\/\/old.koetzingit.de\/index.php?option=com_content&amp;task=view&amp;id=118&amp;Itemid=191\">Citrix Seamless Engine verstehen<\/a> geschrieben und\u00a0verdeutlicht &#8222;Sharing&#8220; Probleme beim ver\u00f6ffentlichen von Anwendungen. Der Web Interface Session Sharing Key ist eine andere Geschichte, die ich in diesem Artikel erkl\u00e4ren m\u00f6chte.<\/p>\n<p><strong>Der\u00a0Session Sharing Key spielt eine Rolle wenn<\/strong><\/p>\n<ul>\n<li>Web Interface Seite und\u00a0die Nutzung des\u00a0Online\/Offline Plug-in zur gleichen Zeit<\/li>\n<li>Web Interface\u00a0Seite zum Start von Sitzungsdesktop und darin das Online\/Offline Plug-in<\/li>\n<li>Web Interface\u00a0Seite\u00a0zum Start\u00a0eines VM Desktop (xenDesktop) und\u00a0darin das Online\/Offline Plug-in<\/li>\n<\/ul>\n<p><!--more--><\/p>\n<h3><span class=\"label label-success\">Web Interface- und die Web Interface Service Seite<\/span><\/h3>\n<p>Als Citrix das Web Interface designte hatten sie nicht gedacht, dass Unternehmen das Online Plug-In (PNAgent) und die Web Interface Seite zur gleichen Zeit und f\u00fcr den gleichen Benutzer verwenden w\u00fcrden. Zudem verwenden viele Administratoren das Online Plug-In als ein Ersatz f\u00fcr das Startmen\u00fc, wovon ich kein Freund bin und auch Citrix es nicht entwickelt hat. Anstelle einfach ein gemeinsames Startmen\u00fc f\u00fcr alle Benutzer zu erstellen, wird das Online Plug-In genutzt. Das ist einfach aber oft wird untersch\u00e4tzt wie viele Komponenten beteiligt sind und was dadurch alles falsch gehen kann.<\/p>\n<h3><span class=\"label label-success\">Web Interface Session Sharing Key verstehen<\/span><\/h3>\n<p>Nun was oder besser wo ist der Session Sharing Key? Sie finden den &#8222;SessionSharingKey&#8220; in der ICA Datei die zum Start der Sitzung vom Web Interface oder der Service Seite heruntergeladen wurde.<br \/>Wie die ICA Datei zu erhalten ist\u00a0wird in den Citrix Artikeln <a href=\"http:\/\/support.citrix.com\/article\/ctx115304\" target=\"_blank\" rel=\"noopener noreferrer\">CTX115304<\/a> beschrieben oder einfach den Firefox verwenden. Haben Sie die Datei heruntergeladen, dann suchen Sie nach SessionSharingKey und sie\u00a0finden etwas\u00a0wie SessionSharingKey=<strong>-GFS55brCiGGp\/Rlna9dWmB<\/strong>, oder mit \u00e4lteren Web Interface Versionen SessionSharingKey=<strong>8-basic-basic&#8211;user @dom.local-farm1<\/strong> <\/p>\n<p>Der zweite Key kommt vom Web Interface 4.6 und hier sollten Sie einige Werte erkennen. Hier nun die Aufl\u00f6sung des Schl\u00fcssels: colors + &#8222;-&#8220; + encrypt + &#8222;-&#8220; + audio + &#8222;-&#8220; + domain + &#8222;-&#8220; + user + &#8222;-&#8220; + farm<\/p>\n<p>Was ist denn nun mit dem ersten Sharing Key, der vom Web Interface 5.2 kommt? Citrix hat schlicht entschieden den gesamten Session Sharing Key mit einem &#8222;Hash&#8220; Wert zu versehen. Wirklich wichtig ist aber das der SessionSharingKey 100% tig gleich sein muss, damit ein Sharing der Sitzungen funktioniert.<\/p>\n<h3><span class=\"label label-success\">Problem mit dem Session Sharing Key<\/span><\/h3>\n<p>Wahrscheinlich sehen einige noch immer nicht das Problem mit dem Sharing Key aber das kommt noch. Beginnen wir mit dem offensichtlichem \u2013 dem Dom\u00e4nen Wert!<br \/>\u00a0<br \/>Nehmen wir an, dass der Administrator im Web Interface die Dom\u00e4ne mit <strong>mydomain.local<\/strong> vorgegeben hat und Benutzer \u00fcber diese Seite eine Desktop Sitzung starten.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\" size-full wp-image-1647\" src=\"http:\/\/www.koetzingit.de\/wp-content\/uploads\/2010\/01\/wissk04.png\" alt=\"Wissk04\" width=\"308\" height=\"314\"  title=\"Citrix SessionSharingKey verstehen\" srcset=\"https:\/\/www.koetzingit.de\/wp-content\/uploads\/2010\/01\/wissk04.png 308w, https:\/\/www.koetzingit.de\/wp-content\/uploads\/2010\/01\/wissk04-294x300.png 294w\" sizes=\"auto, (max-width: 308px) 100vw, 308px\" \/>.<\/p>\n<p>Auf der Desktop Sitzung wiederum wird das Online Plug-In mit Pass-Through verwendet. Als Standard wird bei dem Server mydomain zur Anmeldung verwendet und nicht mydomain.local!<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\" size-full wp-image-1648\" src=\"http:\/\/www.koetzingit.de\/wp-content\/uploads\/2010\/01\/wissk03.png\" alt=\"Wissk03\" width=\"312\" height=\"216\"  title=\"Citrix SessionSharingKey verstehen\" srcset=\"https:\/\/www.koetzingit.de\/wp-content\/uploads\/2010\/01\/wissk03.png 312w, https:\/\/www.koetzingit.de\/wp-content\/uploads\/2010\/01\/wissk03-300x208.png 300w\" sizes=\"auto, (max-width: 312px) 100vw, 312px\" \/><\/p>\n<p>Wird jetzt eine Anwendung \u00fcber das Online Plug-In gestartet, so ist der Session Sharing Key nicht der selbe wie der f\u00fcr die Desktop Sitzung. Hieraus folgt, dass die Anwendung eine neue Sitzung f\u00fcr den Benutzer \u00f6ffnet, die Anmeldung erneut durchgef\u00fchrt wird, ein weiteres mal das Profil des Benutzers geladen wird usw.\u00a0Das bringt eine Menge an Problemen mit sich.<\/p>\n<p>Das Gleiche passiert, wenn Web Interface und das Online Plug-In zur gleichen Zeit auf einer Workstation verwendet werden. Die Strategie ist\u00a0hier das Web Interface (die Webseite) zu verwenden, um zus\u00e4tzliche Nachrichten, Informationen etc. darzustellen.\u00a0Dies\u00a0erfordert aber au\u00dferdem das Online Plug-In f\u00fcr die Inhaltsumleitung.<\/p>\n<p>Nicht so offensichtlich aber tats\u00e4chlich &#8222;gemein&#8220; ist, dass evtl. die Web Interface Seite und der Service unterschiedliche Session Sharing Key\u2019s erzeugen selbst wenn alles gleich ist! Ups, ein &#8222;Bug&#8220; im Web Interface den ich mit 4.6 gesehen habe. Hoffe dass dies in der aktuellen Web Interface Version 5.2 bereits behoben wurde.<\/p>\n<h3><span class=\"label label-success\">Wie bekomme ich den gleichen Session Sharing Key?<\/span><\/h3>\n<p>Als erstes sicherstellen das Web Interface und der Server\/Workstation das gleiche Dom\u00e4nenformat (Netbios oder UPN) verwenden. F\u00fcr Server\/Workstation kann eine Microsoft Gruppenrichtlinie genutzt werden und\/oder ein ICA Client Registry Wert gesetzt werden, wie im Artikel <a href=\"http:\/\/support.citrix.com\/article\/ctx368624\" target=\"_blank\" rel=\"noopener noreferrer\">CTX368624<\/a> beschrieben, .<br \/>Sollte der Sharing Key noch immer nicht gleich sein, so ist eine Fehleranalyse notwendig, welche ich als n\u00e4chstes erkl\u00e4re.<\/p>\n<p>\u00a0<img loading=\"lazy\" decoding=\"async\" class=\" size-full wp-image-1649\" src=\"http:\/\/www.koetzingit.de\/wp-content\/uploads\/2010\/01\/wissk02.png\" alt=\"Wissk02\" width=\"309\" height=\"314\"  title=\"Citrix SessionSharingKey verstehen\" srcset=\"https:\/\/www.koetzingit.de\/wp-content\/uploads\/2010\/01\/wissk02.png 309w, https:\/\/www.koetzingit.de\/wp-content\/uploads\/2010\/01\/wissk02-295x300.png 295w\" sizes=\"auto, (max-width: 309px) 100vw, 309px\" \/><\/p>\n<h3><span class=\"label label-success\">Fehleranalyse des Session Sharing Key<\/span><\/h3>\n<p>Der Session Sharing Key mit dem Hash Wert hilft so gar nicht und darum muss dieser erst deaktiviert werden. Hierzu einfach die Windows Suchfunktion (F3) verwenden aber vorher sicherstellen das ALLE Dateien durchsucht werden. Das Web Interface Verzeichnis dann nach dem Inhalt &#8222;SessionSharingKey&#8220; durchsuchen. Mit Web Interface 5.2 sind das Ergebnis zwei Dateien &#8222;Include.java&#8220; und &#8222;LaunchShared.java&#8220;, wobei in der ersten Datei nichts wirklich N\u00fctzliches steht.\u00a0 In der LaunchShared.java hingegen sind relative schnell die folgenden zwei Zeilen zu finden:<\/p>\n<p><code>\/\/ Put the encrypted hash in the ica file, if we successfully managed to create one.<\/code><br \/><code>icaFile.setValue(ICAFile.SECTION_APPLICATION, ICAFile.VALNAME_SESSIONSHARING_KEY, sessionSharingKeyHash);<\/code><\/p>\n<p>Wird vor der zweiten Zeile &#8222;\/\/&#8220;\u00a0 gesetzt, dann wird dadurch der &#8222;Hash&#8220; auf dem Session Sharing Key deaktiviert und erh\u00e4lt einen noch l\u00e4ngeren String:<br \/>SessionsharingKey=8-basic-none-mydomain-user-farm-Off-Off&#8211;On-On<br \/>\u00dcbersetzt zu: colors + &#8222;-&#8220; + encrypt + &#8222;-&#8220; + audio + &#8222;-&#8220; + domain + &#8222;-&#8220; + user + &#8222;-&#8220; + farm + &#8222;-&#8220; +\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 specialFolderRedirection + &#8222;-&#8220; + virtualComPortEmulation + &#8222;-&#8220; + comPortMapping + &#8222;-&#8220; + clientPrinterPortMapping + &#8222;-&#8220; + clientPrinterSpooling<\/p>\n<p>Beim einem Vergleich kann es jetzt sein, dass an einer Stelle ein Off steht wo aber ein On sein sollte oder andersherum. Die ersten Parameter sind einfach zu managen (Eigenschaften der Anwendung und Dom\u00e4ne) aber was ist mit dem Rest? Einfach den notwendigen Wert in die Default.ica Datei f\u00fcr das Web Interface oder Service hinzuf\u00fcgen. Die Werte f\u00fcr die ICA Datei k\u00f6nnen in der INI File Reference <a href=\"http:\/\/support.citrix.com\/article\/ctx107919\" target=\"_blank\" rel=\"noopener noreferrer\">CTX107919<\/a> nachgelesen werden.<\/p>\n<p>Als Beispiel: &#8222;comPortMapping&#8220; sollte On sein, dann den Wert COMAllowed=On in der [wfclient] Sektion hinzuf\u00fcgen.<\/p>\n<p>\u00a0<\/p>\n<h3><span class=\"label label-success\">Zusammenfassung<\/span><\/h3>\n<p>Der Session Sharing Key ist sehr wichtig und sollte Web Interface und das Online Plug-In in Kombination verwendet werden. Unbedingt sicherstellen, dass zur Authentifizierung f\u00fcr Web Interface und Server\/Workstation das gleiche Format (Netbios, UPN) verwendet wird. Bedingt durch ein Web Interface Bug kann es notwendig sein eine Fehleranalyse durchzuf\u00fchren.<br \/>Ungleichheit mit dem Session Sharing Key verhindert das Sitzungen geschert werden. Passiert das, so werden mehrere Sitzungen f\u00fcr den gleichen Benutzer verwendet, mehrfach Anmeldungen an Servern, mehrfaches laden von Profilen, unn\u00f6tiger Verbrauch von Server Ressourcen und noch vieles mehr.\u00a0 Daher unbedingt sicherstellen, dass der Session Sharing Key unter Ihrer Kontrolle ist &#8211; Ist das so? Lassen Sie es mich wissen!<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Schon mal\u00a0etwas vom\u00a0Web Interface Session Sharing Key geh\u00f6rt? Wahrscheinlich nicht aber ich vermute das einige\u00a0 Unternehmen mit dem Sharing Key [&hellip;]<\/p>\n","protected":false},"author":1755,"featured_media":1578,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_uag_custom_page_level_css":"","site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"default","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","ast-disable-related-posts":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"default","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"footnotes":""},"categories":[11],"tags":[],"class_list":["post-1650","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-understanding-de"],"uagb_featured_image_src":{"full":["https:\/\/www.koetzingit.de\/wp-content\/uploads\/2016\/10\/news-citrix-santa-clara.jpg",360,360,false],"thumbnail":["https:\/\/www.koetzingit.de\/wp-content\/uploads\/2016\/10\/news-citrix-santa-clara-150x150.jpg",150,150,true],"medium":["https:\/\/www.koetzingit.de\/wp-content\/uploads\/2016\/10\/news-citrix-santa-clara-300x300.jpg",300,300,true],"medium_large":["https:\/\/www.koetzingit.de\/wp-content\/uploads\/2016\/10\/news-citrix-santa-clara.jpg",360,360,false],"large":["https:\/\/www.koetzingit.de\/wp-content\/uploads\/2016\/10\/news-citrix-santa-clara.jpg",360,360,false],"1536x1536":["https:\/\/www.koetzingit.de\/wp-content\/uploads\/2016\/10\/news-citrix-santa-clara.jpg",360,360,false],"2048x2048":["https:\/\/www.koetzingit.de\/wp-content\/uploads\/2016\/10\/news-citrix-santa-clara.jpg",360,360,false],"trp-custom-language-flag":["https:\/\/www.koetzingit.de\/wp-content\/uploads\/2016\/10\/news-citrix-santa-clara.jpg",12,12,false]},"uagb_author_info":{"display_name":"Thomas K\u00f6tzing","author_link":"https:\/\/www.koetzingit.de\/en\/author\/thomas-koetzing\/"},"uagb_comment_info":0,"uagb_excerpt":"Schon mal\u00a0etwas vom\u00a0Web Interface Session Sharing Key geh\u00f6rt? Wahrscheinlich nicht aber ich vermute das einige\u00a0 Unternehmen mit dem Sharing Key [&hellip;]","_links":{"self":[{"href":"https:\/\/www.koetzingit.de\/en\/wp-json\/wp\/v2\/posts\/1650","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.koetzingit.de\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.koetzingit.de\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.koetzingit.de\/en\/wp-json\/wp\/v2\/users\/1755"}],"replies":[{"embeddable":true,"href":"https:\/\/www.koetzingit.de\/en\/wp-json\/wp\/v2\/comments?post=1650"}],"version-history":[{"count":1,"href":"https:\/\/www.koetzingit.de\/en\/wp-json\/wp\/v2\/posts\/1650\/revisions"}],"predecessor-version":[{"id":1921,"href":"https:\/\/www.koetzingit.de\/en\/wp-json\/wp\/v2\/posts\/1650\/revisions\/1921"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.koetzingit.de\/en\/wp-json\/wp\/v2\/media\/1578"}],"wp:attachment":[{"href":"https:\/\/www.koetzingit.de\/en\/wp-json\/wp\/v2\/media?parent=1650"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.koetzingit.de\/en\/wp-json\/wp\/v2\/categories?post=1650"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.koetzingit.de\/en\/wp-json\/wp\/v2\/tags?post=1650"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}