Legacy RADIUS server IPs will be deprecated on Dec 17, 2018. Please see this KB for more info.

Support Center

Naming Convention for Users

Bringing together multiple existing, disparate services like Windows, Linux, Google Apps and others into a single directory requires consideration of a naming convention for the username.  This article will discuss:

Determining Local Usernames

JumpCloud -  The JumpCloud username is specified in the Username field of the User Details in the JumpCloud administrator console.  Once created, it cannot be changed. Usernames must start with an alphabetic character. 
IMPORTANT: In order for the JumpCloud account to take over an existing account on a system, the usernames must match, for Linux and Mac, this match is case sensitive.
  • Mac -  The GUI typically shows the term 'username' next to what JumpCloud would consider the 'Full Name'. Here, the 'Account name' needs to match the JumpCloud account.  

    -To find the Account name, go to: System Preferences > Users & Groups > right-click the user > Advanced Options.  The Account name is shown on this screen
  • Windows - The GUI within the control panel for 'User Accounts' shows the 'Full Name' and not the actual username of the Windows user.

    -To find the 'username', go to: Control Panel> Administrative Tools > Computer Managment > Local Users and Groups> Users. The 'username' name is shown on this screen under the 'Name' heading. 

Please refer to How To Use Commands To Query Existing Local Accounts for more information on querying local users using JumpCloud Commands or the system's command-line.  

Determining a Naming Convention

Considerations when deciding on a naming convention
  • JumpCloud Usernames must contain only valid Unix Characters (letters, numbers, '.' or '_')
  • System character restrictions
  • Length (Windows is limited to 20 characters)
  • Case - 'user' is not the same as 'USER' is not the same as 'User'

Generally, it's good practice to use a convention such as first initial/last name, first name/last name, or another convention where it is unlikely two users will have the same username. Once a convention is selected, then recreate or rename any users that are not in compliance. 

Changing Existing Usernames

Application installations can be dependent on the existing username.  Please refer to your software vendor for further consideration on possible issues and remediation.

Renaming users will vary by OS type and version.  The following list is not meant to exhaustive, nor the only methods for renaming usernames.

NOTE: Changing existing usernames for Mac and Linux is generally not recommended unless you have a full understanding of the impacts from doing so.  Changing the username on these platforms can have adverse effects on application and file access.


Last Updated: Nov 28, 2018 09:19AM MST

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