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.

    *IMPORTANT: In order for the JumpCloud account to take over an existing account on a system, the usernames must match.  

     

     

  • Mac - ​​In 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|^com.apple|Guest|root|\/"
 
  • Windows - In 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 Linux, you can easily get a list of users 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 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: Apr 14, 2017 03:04PM MDT

Related Articles
31b11a79e2c94470a66430cfe6d3eecd@jumpcloud.desk-mail.com
https://cdn.desk.com/
false
desk
Loading
seconds ago
a minute ago
minutes ago
an hour ago
hours ago
a day ago
days ago
about
false
Invalid characters found
/customer/en/portal/articles/autocomplete