Understand the JumpCloud Agent

After you install the JumpCloud agent on users’ local machines, you can manage access to the device and more:

• Add, modify, and delete local user accounts
• Run commands
• (Linux only) Enable multi-factor authentication (MFA) via SSH with username and password
• (Mac and Linux only) Create and manage local system groups and members
• (Mac only) Manage FileVault access

Understanding the Architecture

The JumpCloud agent is written in Go (with a bit of C++ in Windows). The memory footprint is approximately 5-7MB of RAM and runs as a compiled native binary.

The Agent contacts JumpCloud's servers (see Agent Compatibility, System Requirements, and Impacts for a list of endpoints) using a long HTTPS poll in near real-time, but could take longer in some instances. If work is available, the Agent downloads and executes the work request.

Understanding the Connect Key

The Connect Key is located in the Admin Portal and provides a way to associate devices with your JumpCloud organization. It is unique to each Admin in the org.

Find your Connect Key when you add a device under DEVICE MANAGEMENT > Devices in the Admin Portal. Admin-generated Connect keys never expire.

When Admins enable the option to allow users to install the JumpCloud Agent, users can generate their own Connect key. User-generated Connect keys are valid for one hour. See Enable Users to Install the JumpCloud Agent for more information.

Locating the Log Files

JumpCloud Agent log files are located here:

• Linux, Mac: /var/log/jcagent.log
• Windows: C:\Windows\Temp\jcagent.log

Understanding Updates

Updates are pushed to devices with an active Agent. If the device is not active during the update cycle, the update will be queued and pushed to the device the next time it is active. The agent may not receive the update if a condition exists which causes the update to fail multiple times, in which case manual intervention may be required.

An update can be executed manually by running the agent installation as normal. The Agent version files are located here:

• Linux, Mac: /opt/jc/version.txt
• Windows: C:\Program Files\JumpCloud\Plugins\Contrib\version.txt