Apple macOS
This chapter refers to an Apple macOS operating system.
Installing
To install the Fabasoft Folio Client, perform the following steps:
- Download the FolioClient.dmg installation package from the Fabasoft Folio installation.
https://<host>/<vdir>/fscasp/content/lib/FolioClient.dmg
Alternatively, you find the DMG file in the Setup\ComponentsBase\Client folder of the Fabasoft Folio distribution media. - Double-click the DMG file.
- Drag the app to the “Applications” folder.
Note: In case of an update keep in mind to close the Fabasoft Folio Client (menu bar > Folio symbol > Quit) before dragging the new app to the “Applications” folder and replacing the old one. - Open the “Applications” folder and run the Fabasoft Folio Client.
- Enter the credentials of an administrative user to finish the installation.
Note: For users without administrative rights, the administrator can finish the installation by executing the following command.
sudo /Applications/Fabasoft*/Contents/MacOS/Fabasoft*UI* -runsetup:1
Deployment via Mobile Device Management Profile
For preconfigured workstations, where the users do not have administrative rights, the following security settings must be configured for smooth operation.
The code requirements can be obtained by following command:
codesign --display -r - <path to application>
Identifier | Service | Access | Code Requirement |
|---|---|---|---|
com.fabasoft.foliosystraypm22 | Accessibility | Allow | identifier "com.fabasoft.foliosystraypm22" and anchor apple generic and certificate 1[field.1.2.840.113635.100.6.2.6] /* exists */ and certificate leaf[field.1.2.840.113635.100.6.1.13] /* exists */ and certificate leaf[subject.OU] = "9FUG84LZ2G" |
System Events | Allow | ||
Screen Recording | Allow | ||
Full Disk Access | Allow | ||
Apple Events | Allow* |
- * For “Apple Events” it is necessary to define the appropriate receiver.
Receiver Process Identifiers |
|---|
com.apple.finder |
com.apple.mail |
com.apple.Safari |
com.apple.systemevents |
com.apple.systempreferences |
com.microsoft.Outlook |
com.microsoft.Word |
Uninstalling
Uninstalling the Client
To uninstall the Fabasoft Folio Client, perform the following steps:
- Quit the Fabasoft Folio Client.
- Open “System Preferences” > “Extensions” and disable the “Finder” entry under “Fabasoft Folio”.
- Open “Finder” and delete the following files:
- /Applications/Fabasoft Folio 2022.app
- /Library/PrivilegedHelperTools/com.fabasoft.finderinjectorpm22
- ~/Library/Application Support/Fabasoft
Removing the Fabasoft Settings (Optional)
To remove the settings, perform the following steps:
- Open the Finder, point to “Go” and click “Go to folder”.
A dialog box opens. - Type “~/.fsc” and click “Go”.
This command leads you to the folder containing the settings. - Delete the .fsc folder.
Note: When removing the .fsc folder all settings and not yet saved files will be lost.
Security Settings
The following security settings must be made after installing the Fabasoft Folio Client.
- Access for “Accessibility Access”
The corresponding pop-up appears directly after the first start of the Fabasoft Folio Client. - Allow Control for “Finder.app”
The corresponding pop-up appears when clicking "Open Folio Folder" and navigating in the synchronized folder. - Allow Control for “Mail.app”
The corresponding pop-up appears when executing the use case "Send as Link". - Access for “Screen Recording”
The corresponding pop-up appears when you log in for the first time in Fabasoft Folio.
File and Registry Locations
The data in this locations must not be removed or modified. The data will be written during the setup process or when logging into the web browser client.
- /Applications/Fabasoft Folio 2022.app
- /Library/PrivilegedHelperTools/com.fabasoft.finderinjectorpm22
- ~/Library/Application Support/Fabasoft
- ~/.fsc/