Overview
The federated authentication dialogs were changed in M-Files Online Sep ’22 Update (22.9.11816.7) to use Edge technology: OAuth2/SAML federated authentication dialogs were updated to use WebView2 (Edge) as a hosted browser component. On the day of writing this article, WebView2 has some issues in Citrix environments.
Impacted Products and Versions
M-Files Online Sep ’22 Update (22.9.11816.7) and newer, which is used in Citrix environment.
Symptoms
When user is not logged to the M-Files Vault and opens the vault (or logs in otherwise), the authentication dialog appears. When this is done in a problematic Citrix environment, end user does not see the authentication dialog properly: For example, user could only see the edges of the authentication dialog while the actual content window remains grey.
Cause and Reason
This is likely related to the Citrix API Hooks, but since the cause is not M-Files related as such, we do not give an accurate assessment of the root cause of this problem. The aim of the article is to raise awareness of this kind of error and guide you in the right direction.
Solution
Disabling Citrix API hooks per-application basis seems to help with this problem. You can find more details from the following external link (NOTE: we cannot guarantee its availability, accuracy or quality):
Key elements to fix the issue mentioned above should contain commands like the ones below (NOTE: Use these commands that alter the Windows Registry at your own risk and only when you know what you are doing):
REG ADD HKLM\SOFTWARE\Citrix\CtxHook /v ExcludedImageNames /t REG_EXPAND_SZ /d msedgewebview2.exe /f
REG ADD HKLM\SOFTWARE\Wow6432Node\Citrix\CtxHook /v ExcludedImageNames /t REG_EXPAND_SZ /d msedgewebview2.exe /f
Searching information from the Internet with the combination of Citrix and WebView2 might also be useful.
Reference Documents
/article/mfiles-ka-55512 (Using M-Files with Citrix XenApp or Microsoft RDS)
