Skip to content

CareSupport-ApS/mac-ServerConnect

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ServerConnect

Introduction

ServerConnect is an open-source menubar macOS application written in Swift. It is designed for IT Managers to deploy and configure using an MDM system, allowing employees to easily access company-designated data locations. The app supports both Legacy SMB / AFP server connections and online services like SharePoint, Box or Dropbox.

Menubar showing ServerConnect options

Table of Contents

Installation

ServerConnect should be installed using the provided .pkg file. The app itself is notarized, but the .pkg is not, so it needs to be distributed using an MDM.

  1. Distribute the .pkg file via your MDM system.
  2. Distribute your custom .mobileconfig using your MDM (before the next step)
  3. Once deployed, the application should be launched manually or through a script. The app loads from the .mobileconfig everytime the menubar icon is pressed, however logo, companyname and subtitle is only loaded on app launch.
  4. After the first launch, the application will automatically start using an inbuilt LaunchAgent.

Usage

Once the app is configured by the admin, the user can:

  1. Click on the ServerConnect icon in the menubar.
  2. Select the specific path they want to access.
  3. The app will then prompt the user for their SMB credentials (username and password). If user has previously saved their credentials, it will attempt to connect immediately. To override the automatic connection, hold SHIFT while pressing the path.
  4. After entering the credentials, the app attempts to connect to the selected path over SMB.

For online services like SharePoint:

  1. Select the SharePoint path in the menubar.
  2. Open the folder in SharePoint and press sync to synchronize it with OneDrive.
  3. The folder will then be directly accessible in Finder.

Features

  • SMB Server Support: Connect to SMB servers with user authentication.
  • SharePoint Integration: Link to specific online folders in SharePoint and sync with OneDrive for Finder access.
  • MDM Configurable: Easily deploy and configure using an MDM system.
  • Menubar Access: Simple menubar interface for quick access to configured paths.

Dependencies

ServerConnect uses the following libraries and frameworks:

Configuration

ServerConnect can be configured using a .mobileconfig file provided by the admin. The configuration file allows the admin to set up all necessary paths and settings for the users.

Example .mobileconfig file:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
	<key>PayloadContent</key>
	<array>
		<dict>
			<key>PayloadIdentifier</key>
			<string>com.caresupport.ServerConnect.B4329991-6908-4FBD-BC2E-3C063BCCC52F</string>
			<key>PayloadType</key>
			<string>com.caresupport.ServerConnect</string>
			<key>PayloadUUID</key>
			<string>91FCB468-BC5A-4B91-BC4B-388E478268E5</string>
			<key>PayloadVersion</key>
			<integer>1</integer>
			<key>companyName</key>
			<string>CareSupport ApS</string>
			<key>helpURL</key>
			<string>https://kb.caresupport.dk/kunder/caresupport</string>
			<key>subtitle</key>
			<string>Only store corporate data the the locations below.</string>
			<key>logoUrl</key>
			<string>https://caresupport.dk/wp-content/uploads/2024/02/Screenshot-2022-06-09-at-11.49.07-1.png</string>
			<key>servers</key>
			<array>
				<dict>
					<key>address</key>
					<string>server.caresupport.dk</string>
					<key>method</key>
					<string>smb</string>
					<key>name</key>
					<string>Legacy SMB fileShare</string>
					<key>paths</key>
					<array>
						<dict>
							<key>description</key>
							<string>Åbner hele mappen</string>
							<key>name</key>
							<string>Hele mappen</string>
							<key>path</key>
							<string>01. PROJEKTER - FILM OG TV</string>
						</dict>
						<dict>
							<key>description</key>
							<string>Til produktioner under udvikling og produktion</string>
							<key>name</key>
							<string>UDV OG PROD</string>
							<key>path</key>
							<string>01. PROJEKTER - FILM OG TV/01. UDV &amp; PROD</string>
						</dict>
						<dict>
							<key>description</key>
							<string>Til produktionerne der produceres sammen med andre producenter</string>
							<key>name</key>
							<string>CO-PRODUKTIONER</string>
							<key>path</key>
							<string>01. PROJEKTER - FILM OG TV/02. CO-PRODUKTIONER (minor)</string>
						</dict>
						<dict>
							<key>description</key>
							<string>Alle arkiverede produktionsfiler</string>
							<key>name</key>
							<string>KATALOG</string>
							<key>path</key>
							<string>01. PROJEKTER - FILM OG TV/04. KATALOG</string>
						</dict>
					</array>
					<key>username</key>
					<string>{{email}}</string>
				</dict>
<dict>
					<key>address</key>
					<string>https://caresupport.sharepoint.com</string>
					<key>description</key>
					<string>SharePoint files - these files can be worked in at the same time</string>
					<key>method</key>
					<string>web</string>
					<key>mountPoint</key>
					<string>~/Library/CloudStorage/OneDrive-Deltebiblioteker–CareSupport</string>
					<key>name</key>
					<string>SharePoint - Departments</string>
					<key>paths</key>
					<array>
						<dict>
							<key>localPath</key>
							<string>Local path on computer</string>
							<key>name</key>
							<string>Developers</string>
							<key>path</key>
							<string>sites/path-1</string>
						</dict><dict>
							<key>localPath</key>
							<string>Local path on computer</string>
							<key>name</key>
							<string>Marketing</string>
							<key>path</key>
							<string>sites/path32</string>
						</dict><dict>
							<key>localPath</key>
							<string>Produktioner - DK-Prod -</string>
							<key>name</key>
							<string>Finance</string>
							<key>path</key>
							<string>sites/path-3</string>
						</dict>
					</array>
				</dict>
			</array>
		</dict>
	</array>
	<key>PayloadDisplayName</key>
	<string>ServerConnect - Nimbus Film</string>
	<key>PayloadIdentifier</key>
	<string>dk.caresupport.7F67D7C2-5FD9-4C75-86FC-270AFF866215</string>
	<key>PayloadOrganization</key>
	<string>CareSupport ApS</string>
	<key>PayloadType</key>
	<string>Configuration</string>
	<key>PayloadUUID</key>
	<string>19895FDC-F976-4AE7-A6B9-6840497DF275</string>
	<key>PayloadVersion</key>
	<integer>1</integer>
</dict>
</plist>




productbuild --sign 8XW2A3LKCS --component /Users/emillind/Downloads/3.6/ServerConnect.app /Applications /Users/emillind/Downloads/3.6/ServerConnect.pkg

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages