Device Management

Dropshare 5.0.4 and later

For site and team installations, Dropshare offers several options to automate the deployment of the app.

License Activation

In order to automatically activate the licensing of the app, provide the following launch parameters to it:

Parameter	Description
-licenseCode	License Code (individual or site licenses)
-licenseEmail	Email address associated with license code
-deactivateLicense	Optional, Dropshare 6.17 and later. Deactivates the license activation of this Mac, so the license can be activated on another Mac. Takes no value.

Deactivating a License

Dropshare 6.17 and later

To free up an activation, for example before a Mac is retired or reassigned, launch Dropshare with -deactivateLicense. The activation is removed from your license, so the license can be activated on another Mac.

To move a Mac to a different license in a single run, combine -deactivateLicense with -licenseCode and -licenseEmail. Dropshare deactivates the current license first and then activates the new one.

Connection Import

To automatically import connections to the app on startup, provide the following launch parameters to it (can be repeated for multiple connections):

Parameter	Description
-importConnection	Absolute path to .dsconn file to import
-importPassphrase	Passphrase for decryption of connection file
-importReference	Optional, Dropshare 6.17 and later. Your own ID for the connection, for example company-s3. Letters, digits, dots, dashes and underscores are allowed.
-importReplace	Optional, Dropshare 6.17 and later. YES updates an existing connection with the same ID instead of importing a copy.

-importPassphrase, -importReference and -importReplace apply to the -importConnection they follow.

Updating Connections

Dropshare 6.17 and later

Without -importReplace, importing a connection that already exists adds a copy. To update a deployed connection instead, for example after rotating its access keys, import it with the same -importReference and -importReplace YES:

1. Export the updated connection to a .dsconn file.
2. Run the same import again with the new file.

Dropshare replaces the connection's settings and credentials. The connection's position in the list, its upload preferences, keyboard shortcut and whether it is the default connection are kept.

Locking Connections

Dropshare 6.17 and later

To prevent users from adding their own connections or changing the deployed ones, set LockConnections to true in a configuration profile for Dropshare. Use the Custom Settings (Application & Custom Settings) payload of your device management solution with the preference domain net.mkswap.Dropshare5, or net.mkswap.Dropshare-setapp for the Setapp version:

<key>LockConnections</key>
<true/>

While connections are locked, users cannot:

• add connections, either with the setup assistant or by opening a .dsconn file or a connection synchronized to iCloud,
• edit, rename, duplicate or delete connections,
• export a connection to a file or synchronize it to iCloud.

Users can still choose the default connection, change a connection's upload preferences, set keyboard shortcuts and choose a connection when uploading. Imports with -importConnection keep working, so connections can still be added and updated during deployment.

Dropshare only honors LockConnections when it is set by a configuration profile. Setting it with defaults write has no effect.

Preferences Import

To automatically import preferences to the app on startup, provide the following launch parameters to it:

Parameter	Description
-importPrefs	Absolute path to .dspref file to import
-importPrefsPassphrase	Passphrase for decryption of preferences file

Landing Page Import

To automatically import custom landing pages to the app on startup, provide the following launch parameters to it (can be repeated for multiple landing page slots 1-5):

Parameter	Description
-importLp	Absolute path to .html landing page file to import
-importLpSlot	Custom landing page slot to import into (1-5)

Sample Usage

Below is a sample of how to start the app with launch parameters in your deployment setup:

open /Applications/Dropshare.app --args -importConnection "/Users/test/test.dsconn" -importPassphrase "test" -importConnection "/Users/test/test2.dsconn" -importPassphrase "test2" -licenseCode "aaaa-bbbb-cccc-dddd-eeee" -licenseEmail "test@example.com"

To deploy a connection under your own ID and update it on later runs:

open /Applications/Dropshare.app --args -importConnection "/Users/test/company.dsconn" -importPassphrase "test" -importReference "company-s3" -importReplace YES

To deactivate the license of a Mac:

open /Applications/Dropshare.app --args -deactivateLicense

Launch parameters are only read when Dropshare starts. If Dropshare is already running, quit it before running the command.