[Notification] We're upgrading the JumpCloud Support Center the week of September 16th.

Support Center

Getting Started: Systems

Mac®, Windows®, or Linux® systems are bound to JumpCloud® by installing JumpCloud's system agent. Please check JumpCloud Agent Compatibility, System Requirements and Impacts prior to installing an agent. After an agent is installed and bound to a system, you can remotely and securely manage the system and its user accounts, set policies, execute commands, enable MFA, and more.
  • Create, modify, and disable local user accounts.
  • Manage SSHD configuration (Linux).
  • Enforce MFA (Mac, Linux SSH).
  • The execution of Commands.
This KB covers:
About the Agent
The agent is small, secure, and keeps itself up-to-date. It's designed to check in with JumpCloud securely through port 443, tell you its status, look for instructions from you, set policies, report log in event data, and more.

1 - Add a System
To add a new system:
  1. Log in to the JumpCloud Admin Portal:  https://console.jumpcloud.com/login.
  2. Go to Systems, then click ( + ). 
The New System panel appears. This panel has various system tabs. Each tab includes information about downloading and installing the JumpCloud agent for that system. In addition to the information on each system tab, you can also read the following about installing agents from the command linetemplate or AMI, or the JumpCloud API.

You can whitelist the JumpCloud agent with your AntiVirus vendor.

Installation typically completes in several minutes. After installation, the agent checks in with JumpCloud and shows as active in the Admin Portal. You can view details about the system on the System panel.

2 - View the System Panel

Details tab

The System Panel Details tab shows the following information:
  • Display Name - This defaults to the hostname of the system, but can be set to any string.
  • Immutable details - Details like the hostname, IP, and other fields that can't be modified are kept current via the agent service.
  • SSH Options (Linux) - These options modify the SSHD configuration. The agent attempts to control the SSHD configuration regardless of other software it may interact with. Configuration management, other security modules, or anything else that may attempt to change these files in conjunction with the agent may result in adverse behavior.  
Tip: Expand the System Details panel Settings section to enable Multi-factor Authentication (MFA) and the System Insights feature for the system you’re viewing.

System Groups tab

Use the System Panel Systems Group tab to see which system groups are connected to the system and to connect system groups to the system.

To create a group, see Getting Started: Groups.

Users tab

Use the System Panel Users tab to see users bound to the system and to connect users to the system.

  • Connected through Group Membership:
    • Users with Enable Permissions in the Administrator / Sudo column of the list of users means that they are bound to the system through group membership.
    • If the connected is removed, you are presented the option to remove the user from the group that has granted access to the system.
    • Click Enable Permissions to create a direct connection between the user and the system. Doing so lets you set Standard User or Administrator permissions. Group membership for the user remains unchanged.
  • Connected directly:
    • Users with a permission in the Administrator / Sudo column of the list of users means that the user is bound directly to the system.
    • You can define the type of permission for this individual user.
    • If the connection is removed, the direct relationship between the system and the user is removed. The user may still have access granted to the system through membership to a group. 
3 - Video Tutorials

Adding Windows Systems

Adding Mac Systems

Adding Linux Systems

4 - More Information

Find more information about systems in the following JumpCloud KB sections:

Last Updated: Sep 16, 2019 02:16PM MDT

Related Articles
seconds ago
a minute ago
minutes ago
an hour ago
hours ago
a day ago
days ago
Invalid characters found