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:

What is considered the username for:

  • 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 be an exact match and 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

    -Or via shell
dscl . -list /Users | grep -Ev "^_.*|daemon|^|Guest|root|\/"
  • Windows - Depending on the version, the GUI may not readily show the username of the account .  Open a command prompt or PowerShell and run:  
net users
  • Linux - In the shell:
$ cut -d: -f1 /etc/passwd

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

Considerations when changing a username
  • Application dependencies - if the application installation is dependent on the existing username, involve the software vendor for application specific issues in this scenario
Renaming users varies by OS and by OS version, the following list is not meant to be exhaustive, nor the only methods for renaming users.

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: Jul 28, 2017 10:23AM MDT

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