GateKeeper for OSX 3.0.0 Installation Notes

Important notes regarding GateKeeper operation on MacOS

Version: 
	GateKeeper is only supported on MacOS 10.13 and higher.

Screensavers: 
	GateKeeper does not behave well with screen savers. We recommend disabling screensavers on any Mac in which GateKeeper is installed. If the screen saver is not disabled with GateKeeper installed, the screen may lock up when attempting to wake the system up. In this case, the machine must be restarted.

Login screen options: 
	We recommend setting “Displaying login window as” to  “Name and password” for best usability. This can be changed from the “Users & Groups” settings menu, in the “Login Options” tab. Skipping this step will not affect Gatekeeper functionality, but will improve the appearance of the login window thus improving usability.

Fast user switching: 
	Gatekeeper uses fast user switching when locking the screen and changing users. We recommend users turn on fast user switching, and use this feature if they intend to suspend their session manually instead of using the lock screen. This is because GateKeeper will not log in a user from the lock screen. GateKeeper can only log in a user from the login window. Fast user switching can be enabled from the “Users & Groups” settings menu under the “Login Options” tab. Set “Show fast user switching menu as” to “Full Name”. This step is optional, but improves usability for users.

Domain credentials:
	MacOS has poor handling of new domain credentials when using a custom authentication plugin. For this reason, any domain credentials you would like to use on a given Mac should be logged into at least once BEFORE GateKeeper is installed. Failing to do so will usually result in a frozen window, at which point the system needs to be restarted.

Uninstalling:
	In order to uninstall the application, the user navigate to the directory: “/Applications/Utilities/Uninstall GateKeeper”. There they will see a program called “uninstall”. After double clicking this application, or opening it from the terminal, they will need to enter their admin password. GateKeeper will then be uninstalled.

Recovery:
	In the unlikely event that a user is unable to log in using the GateKeeper authentication plugin, the following process can be used to uninstall GateKeeper. First, restart the Mac while holding the Command and R keys. This will boot into recovery mode. Then, open the Terminal from the Utilities menu. Then run the following commands:

cd /Applications/Utilities/Uninstall\ GateKeeper
sudo ./uninstall

Then restart the Mac.