username

Last Updated : Dec 09, 2022 |

Use the username command to add a local user account. Use the no form of the command to remove the user account from the system.

By default there is only a single user account named “root”, with the root password, which accesses the administrator level. You cannot delete this basic user account unless you have created a different administrator. You cannot modify the access level of the basic user account.

Note:

Removing the root user may disable access to the gateway, as the root account is the only account to which lockout, inactivity, and password aging mechanisms are not applied.

Important:

For security reasons, you must change the default root account password immediately.

Ensure that the password does not contain the username.

Syntax

username[name] access-type [access_type]

no username [name]

Parameters

Parameter

Description

Possible Values

Default Value

name

New user name

Minimum four character string

access_type

Access type definition

read-only, read-write, admin

-

Enter user’s password at the prompt

The password must comply with the password policies determined by login authentication min-password-length, login authentication min-password-upper-chars, login authentication min-password-lower-chars, login authentication min-password-digit-chars, and login authentication min-password-special-chars.

User Level

admin

Context

general

Example

To create a new user account with username john and a read-write access:

Gxxx-001(super)# username john access-type read-write 
Enter new password: ***************
Confirm password  : ***************
User account added.

To change the password of the root user:

Gxxx-001(super)# username root access-type admin 
Enter new password: ***************
Confirm password  : ***************
User account modified.
You cannot change the access type of the root user:
Gxxx-001(super)# username root access-type read-write 
ERROR: User account root has always an administrator access type.
Note:

To define a username that includes spaces, you must enclose the entire name in quotation marks, for example, new york.