Solution
SERVER SIDE CHANGES
For StoreFront deployments, modify web.config under the Receiver for Web (RfWeb) site (typically C:inetpubwwwrootCitrixStoreWeb) to activate the Citrix Receiver Launcher / Citrix Workspace App Launcher for Safari 12 and later.
1. Open web.config using your preferred text editor and locate the line : <protocolHandler enabled='true' platforms='(Macintosh|Windows NT).*((Firefox/((5[2-9]|[6789][0-9])|ddd))|(Chrome/((4[2-9]|[56789][0-9])|ddd)))' skipDoubleHopCheckWhenDisabled='false' />
2. The value of the platforms attribute is a regular expression specifying the browsers that Citrix Receiver Launcher is used for client detection and HDX launches. Change the regular expression to:
'(Macintosh|Windows NT).*((Firefox/((5[2-9]|[6789][0-9])|ddd))|(Chrome/((4[2-9]|[56789][0-9])|ddd)))|Macintosh.*Version/(1[2-9]|[2-9][0-9]).*Safari/'
3. This will add Safari 12 and later to the list of browsers that Citrix Receiver Launcher will be used.
CLIENT SIDE CHANGES
On a Mac Station running Safari 12 perform the following actions:
- Launch Safari 12 Browser and select Safari from the Menu on top > go to Preferences and select it
- In preferences > Select Advanced tab > check Checkbox 'Show Develop Menu in Menu Bar' (Located at the very bottom). This option will enable the Develop tab in Safari top menu
- Close the preferences window by selecting the red circle on the top left corner
- Go back to Safari Menu and select > Clear History
- Then go to Safari Menu and select the Develop Tab > Empty Caches
- Close All safari windows after this. Make sure no Safari Windows are left open.
- Test using Safari 12 and browse to Storefront’s receiver for website URL.
CLIENT DETECTION BEHAVIOR ON SAFARI 12
- Go to https://StorefrontURL/Citrix/StoreNameWeb
- The first thing a user should see when testing going internally to Storefront’s Website is to detect Receiver/Workspace App. Please select “Detect Receiver/Workspace App”. Image below shows test using receiver.
- The following window prompt will appear “Do you want to allow this page to open Citrix Receiver Launcher?' please select “Allow”
- Once “Allow” is selected, no Manual interaction will be required by user. Site will automatically load to go to either “Logon Page when using explicit authentication” or it would “take you to your Apps enumeration” if SSO (Single Sign On) is enabled.
- Once user is logged in, when trying to launch an application or desktop the following prompt will show for user to select 'Allow'
ADDITIONAL CONSIDERATIONS
- When users are connecting internally and Storefront server is using an Internal SSL cert. Mac stations must have the CA Root and or Intermediate Certificate added to their Keychain Store in the Mac. Additionally, SSL certIFICATE must be set to Always trust / Allow. See example below:
Note: You should clear browser cache and history before the changes mentioned in this article can take effect.
Problem Cause
Additional Resources
You can now use the Application probing feature to proactively monitor the health of applications enabling you to fix issues before the user actually experiences them. For more information refer to Citrix Documentation - Application probing.
Citrix Blogs - NPAPI support is being removed from Safari 12
Disclaimer
Citrix Files makes accessing your files from a Mac much easier. It allows you to access files and folders from ShareFile directly through Finder on your Mac. Content is streamed when it is accessed and not permanently stored on your computer. Changes made to files in the ShareFile folder are automatically saved back to the cloud. Most Finder operations like drag and drop, copy and paste, move and rename, and others will automatically update to the cloud.
Contents
System Requirements
Install Citrix Files
Sign-in to Citrix Files
Basic Operations
Icon Overlays
Right Click Menu
Menu Bar Icon
Dashboard
Overflow Menu
Preferences
Open and Edit
Conflict Prevention
Troubleshooting
Citrix Files Drive is Unavailable
Reconnect the Drive
Relaunch Citrix Files
Reinstall Citrix Files
System Requirements
- macOS 10.12 Sierra
- macOS 10.13 High Sierra
- macOS 10.14 Mojave
- macOS 10.15 Catalina
Note:
|
Install
- Download the installer DMG.
- Open the installer package and follow the prompts to install Citrix Files.
- You will be required to provide an administrator password and accept prompts for mounting the Citrix Files kernel extension to complete the installation.
Note: Citrix Files for Mac support for Apple silicon devices (M1 chip) is on a preview basis. Please see macOS Recovery security setting requirements that 'Allow user management of kernel extensions from identified developers.' |
After installation, a volume named “Citrix Files” will appear. You may access this volume by clicking on the Citrix Files menu bar item and then clicking the folder icon. It will also appear in the Favorites sidebar in Finder windows. This volume displays all of the files and folders from your Citrix Files account.
Sign in
When starting the Citrix Files Desktop app for the first time, you are prompted to sign in with your Citrix Files Credentials.
Basic Operations
Citrix Files allows you to manage the files in your Citrix Files account the same way that you would manage files normally through Finder.
Operation | Description |
---|---|
Open and Edit | Double click on a file in the Citrix Files folder. Make any edits necessary and then save the changes.
|
Download | Drag and drop file(s) or folder(s) from the Citrix Files folder to another folder on your computer.
|
Upload | Drag and drop file(s) or folder(s) from the Citrix Files folder to another folder on your computer. |
Delete | Right click on a file or folder and select Move to Trash. You may also drag files and folders to the trash. |
Move | Drag and drop file(s) or folder(s) from one location in the Citrix Files folder to another. |
New Folder | Create a new folder in Citrix Files folder. |
Quick Tip:
|
Icon Overlays
Files and Folders will have an icon overlay representing the status of that item. The following defines what each icon overlay represents:
Online-only files. These folders and files don’t take up space on your computer. |
Mixed state Folder occurs when you have some items within it are mixed across online-only, always offline and/or cached. Note: When you open an online-only file, it is download to your device and becomes a cached file. You can open cached files anytime, even without internet access. If you need to free up space, you can change the file back to online only. To do so just right-click the file and select ‘to be set’ or go to the Citrix Files dashboard – settings – free up space |
Only files or folders that you mark as “Make available offline” will have a green circle with the white check mark. These files or folders are downloaded to your device and are available offline. |
The file or folder is currently syncing to the cloud. |
The file is currently checked out. |
Right Click Menu
When you right click on a file or folder within Citrix Files, you will see some additional options. These options give you access to the functions available in Citrix Files for these items. Options will vary based on the types of files or folders you have selected, permissions, and account settings.
Operation | Available For | Description |
---|---|---|
Share | Files and Folders | Copy Link - Copies a Citrix Files download link. Link settings will be determined by the Share options in your Preferences. Email with Citrix Files - Send a download link through email. Email options may be customized before sending, or by modifying default options in your Preferences. Email with mail app - Opens the Mail app in Mac OS. A new message is generated that contains a Citrix Files download link Initiate Approval - (For a single file only) Initiate an approval workflow on a file |
Request Files | Single Folder | Copy Link - Copies a Citrix Files upload link. Link settings will be determined by the Share options in your Preferences. Email with Citrix Files - Send a upload link through email. Email options may be customized before sending, or by modifying default options in your Preferences. Email with mail app - Opens the Mail app in Mac OS. A new message is generated that contains a Citrix Files upload link |
Check Out | Single File | Check Out a file to prevent other users from making changes |
View Details | Single File or Folder | View detailed information for a file or folder. The details window provides access to multiple file versions, notes, or checkout details |
Refresh Contents | Single Folder | Folder contents should update automatically as changes are made, but you may refresh contents manually using this function |
Citrix For Macbook
Additional actions are available under More Options.
Operation | Available For | Description |
---|---|---|
Download | Files and Folders | For file(s) and folder(s), download allows you to download file(s) or folder(s) to a specific location on your computer. Note: For improved performance, use this option for large file downloads or downloading a large number of items. These downloads are optimized for bulk operations and do not store data in the cache. |
Upload | Single Folder | Right click on a folder and upload allows you to upload files and folders from a specific location on your computer. Note: For improved performance, use this option for large file uploads or uploading a large number of items These downloads are optimized for bulk operations and do not store data in the cache. |
Manage Permissions | Single Folder | Add users to a folder, modify folder permissions, and copy folder permissions from one user to another. |
Add to Favorites | Single File or Single Folder | Adds the file or folder to the Favorites folder. |
Preview | Single File | Stream a video file without downloading it (Available for .mp4, .ogg, .ogv, and .webm file types). |
Menu Bar Icon
This icon displays the current status of Citrix Files. A spinner over the icon indicates activity.
Uploads in progress or edits that are being saved back to Citrix Files will be indicated by a spinner. You will also see a spinner when navigating to a folder. The spinner indicates that the contents of a folder are being fetched and should appear after the spinner disappears.
Dashboard
Clicking on the menu bar icon will open the dashboard:
- Recent Files - Files that have been uploaded or edited will appear in the list of recent files. Double click on a file to open it.
- Overflow Menu - Access Preferences, Send Feedback, Help Launch Website, and quit/exit the Citrix Files application.
- Workflow button - Open a window containing Workflows where you can view
- Open Citrix Files Folder - Open the Citrix Files drive in Finder on this Mac.
Overflow Menu
This provides access to Preferences, Send Feedback, Help Launch Website, and Quit.Provide a rating for the app and leave detailed comments.
- Help - Provides links to support and legal resources. This menu also allows you to report a technical problem with the app to the development team.
- Launch Website - Opens the Citrix Files website.
- Quit - Quits the App.
- Preferences - Opens the Preferences for the App.
Citrix Receiver Apple App
Preferences
Preference | Description |
---|---|
Account | Log out - Logs you out of your account. Cached files are deleted |
App Settings | Cache - Hover over the ? for details and cache usage |
Share Options | Notifications - Set default notifications that are applied when sharing |
Open and Edit
Open and Edit has been tested with the following applications:
- Adobe Acrobat Reader DC
- Adobe Photoshop
- Keynote
- Numbers
- Microsoft Excel 2008, 2011, 2016, 2017
- Microsoft PowerPoint 2008, 2011, 2016, 2017
- Microsoft Word 2008, 2011, 2016, 2017
- Pages
- Preview
- Sketch
- TextEdit
Citrix Receiver Apple Download
Other applications will be tested and fully supported during the course of the Beta program. Please report any issues you experience with open and edit.
Users are welcome to use Citrix Files for Mac with any application, however when using applications that are not listed above, we recommend saving local copies before uploading to Citrix Files until compatibility has been tested.
Conflict Prevention
Citrix Files for Mac provides end user notifications when another user uploads a new version of a file or checks a file out while you are also viewing / editing the file, in order to prevent file conflicts.
Notification when someone uploads a new version of the file you also have open:
Notification when someone checks out a file while you also have that file open:
Troubleshooting
Citrix Files Drive is Unavailable
Citrix Files gives you access to the files on your Workspace account by making them available as a storage drive (like an SD card or a thumb drive). This drive needs to mount itself into your Mac's file system before files can be accessed from Citrix Files. If the Citrix Files app experiences an issue with mounting, the app menu bar icon will show a warning symbol. You will need to ensure the drive mounts properly before you may use Citrix Files.
Reconnect the Drive
- Click the Citrix Files menu bar icon.
- Click Reconnect.
Relaunch the App
You may need to relaunch Citrix Files app in case the app experiences an issue with mounting.
- Close any files that may be open in Citrix Files (Ex: You have opened a Word document in Citrix Files).
- Click on the Citrix Files menu bar icon.
- Click on (...).
- Select Quit.
- Open Citrix Files app in your Applications folder.
Reinstall Citrix Files
Citrix Files installs a kernel extension or ext to mount the drive.
- Click the Citrix Files menu bar icon.
- Click on (...) Over Flow Menu
- Select Help.
- Click Uninstall Citrix Files.
- Download and install Citrix Files again.
Additional Resources
Citrix Receiver Apple Ipad
CTX119253- Language Support for Citrix Products