Configuring Users and Groups
All configuration and administration functions for Cisco Unified SIP Proxy are available through the graphical user interface (GUI). However, you may find using the command-line interface (CLI) is more efficient than using the GUI. For example, you may want to create a script to configure a large number of users for a specific system. In this case, the CLI can be more efficient.
This chapter describes the commands for the following tasks and contains the following sections:
Adding and Modifying a User
Users, or users, configured in Cisco Unified Communications Manager can be imported to the Cisco Unified SIP Proxy database.
The procedure described in this section allows you to create a new user in the system. Use the same procedures to modify an existing user’s properties.
The maximum number of users is determined by the license of the module.
Note Ensure not to use reserved keywords or any name that may conflict with the regular users or process names in Linux (root, bin, daemon, adm, lp, sync, shutdown, halt, mail, operator, games, and so on.) while creating the users.
Required Data for This Procedure
The following information is required for adding or modifying a user:
- Username—The user ID. The username must be at least 3 and no more than 32 characters. Cisco Unified SIP Proxy allows only letters, numbers, underscore (_), dot (.), and dash (-) in user IDs. User IDs must start with a letter. Do not use spaces in the username.
- (Optional) Full name—First and last name of the user. It must start and end with quotation marks (“ ”).
- (Optional) Group—Name of an existing group in which this user is a member.
- (Optional) Password—Password for logging into the Cisco Unified SIP Proxy GUI. The password must include a minimum length ranging from 8 through 64 characters. There is no limit on the maximum number of characters. Spaces are not allowed. A valid password should have at least one uppercase letter, one lowercase letter, one number, and a symbol.
- (Optional) PIN—No PIN is required for vCUSP users.
SUMMARY STEPS
EXEC mode:
1. username userid [ create | delete | fullname [ first “ first-name ” | last “ last-name ” |
display “ full-name ” ] | group group-name | language “ language ” | password “ password ” | pin number ]
2. show users
or
show user detail username userid
3. copy running-config startup-config
Configuration mode:
1. config t
2. username userid [ create | phonenumber phone-number | phonenumberE164 full-number ]
3. exit
4. show users
or
show user detail username userid
5. copy running-config startup-config
DETAILED STEPS
EXEC mode:
|
|
|
Step 1 |
username userid [ create | delete | fullname [ first “ first-name ” | last “ last-name ” | display “ full-name ” ] | group group-name | language “ language ” | password “password” | pin number ]
se-10-0-0-0# username user1 create se-10-0-0-0# username user2 fullname display “User 2” se-10-0-0-0# username user2 group sales se-10-0-0-0# username user2 password “Green123!” se-10-0-0-0# username user2 pin 4444 se-10-0-0-0# username user2 delete |
Creates the user with the specified user ID. The optional parameters configure more information for the user:
- userid —User ID of the user. The user ID must be at least 2 and no more than 31 characters. Cisco Unified SIP Proxy allows only letters, numbers, underscore (_), dot (.), and dash (-) in user IDs. Do not use spaces in the username. User IDs must start with a letter.
- create —C reates the user with no other information.
- delete —Deletes an existing user.
- fullname —Specifies a full name for this user. This full name appears on telephone displays.
- group —Associates this user with an existing group.
- language —Specifies the default language used for the specified user. See the Release Notes for Cisco Unified SIP Proxy for a list of available languages.
- password —Specifies a password for this user. The password value must be entered within quotation marks (“ ”). Spaces are not allowed. Acceptable password characters are lowercase letters a to z, uppercase letters A to Z, digits 0 to 9, and the following symbols: -,. + = _ ! @ # $ ^ * () ? / ~ < > & %.
- pin —Specifies a personal identification number (PIN) for this user. The user enters this number from the telephone when accessing the voice-mail system. The PIN can contain a maximum number of 16 digits. The asterisk (*) and pound sign (#) cannot be used.
|
Step 2 |
show users or show user detail username userid
se-10-0-0-0# show user detail username user2 |
Displays a list of user IDs for all users configured on the system. or Displays the detailed information configured for the specified user. |
Step 3 |
copy running-config startup-config
se-10-0-0-0# copy running-config startup-config |
Copies the configuration changes to the startup configuration. |
Examples
The following output illustrates the show users and show user detail username commands:
se-10-0-0-0# show user detail username user2
Configuration mode:
|
|
|
Step 1 |
config t
se-10-0-0-0# config t |
Enters configuration mode. |
Step 2 |
username userid [ create | phonenumber phone-number | phonenumberE164 full-number ]
se-10-0-0-0(config)# username user3 create se-10-0-0-0(config)# username user3 password Usr@50180 |
Creates the user with the specified user ID. The optional parameters configure more information for the user:
- userid —User ID of the user. The user ID must be at least 2 and no more than 31 characters. Cisco Unified SIP Proxy allows only letters, numbers, underscore (_), dot (.), and dash (-) in user IDs. Do not use spaces in the username. User IDs must start with a letter.
- create —Creates the user with no other information.
- password —Specifies a password for this user.
|
Step 3 |
exit
se-10-0-0-0(config)# exit |
Exits configuration mode. |
Step 4 |
show users or show user detail username userid
se-10-0-0-0# show user detail username user2 |
Displays a list of user IDs for all users configured on the system. or Displays the detailed information configured for the specified user. |
Step 5 |
copy running-config startup-config
se-10-0-0-0# copy running-config startup-config |
Copies the configuration changes to the startup configuration. |
Examples
The following example illustrates configuring a user and the output from the show commands:
se-10-0-0-0(config)# username user3 create
se-10-0-0-0(config)# username user3 password User@5521
se-10-0-0-0(config)# exit
se-10-0-0-0# show user detail username user3
Adding and Modifying a Group
A group is a collection of users, usually with a common function or purpose, such as sales, main office, customer service, or technicians. A group has the following characteristics:
- Members of the group can be individual users or other groups.
- The group is assigned an extension.
- A group can have zero or more users as owners. An owner of a group can add and delete members. Additionally, an owner can add and delete other owners to the group.
- Members can belong to more than one group.
- Members can be added to the group using the configuration mode groupname command or using the EXEC mode username command. See Adding and Modifying a User for details about the username command.
Note Users must exist before being added to a group. See Adding and Modifying a User to configure the user’s detailed information.
The following procedure allows you to create a new group in the system.
Required Data for This Procedure
The following information is required to define a group:
– Name of group
– (Optional) Description of group
– (Optional) Full name of group
– Name of group
– (Optional) One or more existing user or group IDs to be added as members
– (Optional) One or more existing user IDs to be added as owners
– (Optional) Extension or telephone number of the group
– (Optional) Full E.164 telephone number of the group
SUMMARY STEPS
EXEC mode:
1. groupname userid [ create | delete | description “description” | fullname “full-name” ]
2. show groups
or
show group detail groupname groupid
3. copy running-config startup-config
Configuration mode:
1. config t
2. groupname groupid [ member username | owner ownername | phonenumber phone-number | phonenumberE164 full-number ]
3. exit
4. show groups
or
show group detail groupname groupid
5. copy running-config startup-config
DETAILED STEPS
EXEC mode:
|
|
|
Step 1 |
groupname groupid [ create | delete | description “description” | fullname “full-name” ]
se-10-0-0-0# groupname sales fullname “Sales Department” se-10-0-0-0# groupname sales description “Retail Sales Department” se-10-0-0-0# groupname sales delete |
Creates the group with the groupid value. The optional parameters configure more information for the group:
- create —C reates the group with no other information.
- delete —Deletes an existing group.
- description —Specifies a description of the group.
- fullname —Specifies a long name for the group.
|
Step 2 |
show groups or show group detail groupname groupid
se-10-0-0-0# show group detail groupname sales |
Displays a list of group IDs for all configured groups. This command does not display the details for the groups. or Displays the detailed configuration information for the group groupid value. |
Step 3 |
copy running-config startup-config
se-10-0-0-0# copy running-config startup-config |
Copies the configuration changes to the startup configuration. |
Examples
The following example creates a group and displays the output of the show commands:
se-10-0-0-0# groupname sales fullname "Sales Department"
se-10-0-0-0# groupname sales description "CA office"
se-10-0-0-0# show group detail groupname sales
Full Name: Sales Department
Configuration mode:
|
|
|
Step 1 |
config t
se-10-0-0-0# config t |
Enters configuration mode. |
Step 2 |
groupname groupid [member username | owner ownername | phonenumber phone-number | phonenumberE164 full-number]
se-10-0-0-0(config)# groupname sales member user1 se-10-0-0-0(config)# groupname sales owner user2 se-10-0-0-0(config)# groupname sales phonenumber 50163 se-10-0-0-0(config)# groupname sales phonenumberE164 14445550163 |
Creates the group with the groupid value. The optional parameters configure more information for the user:
- member —Associates an existing user as a member of this group. Repeat this command to assign multiple users to the group.
- owner —Specifies the owner of the group. The owner is not considered a member. If the owner is to have access to the group’s voice mailbox, also assign the owner as a member.
- phonenumber —Associates a number or extension with this group. No spaces or dashes are allowed.
- phonenumberE164 —Associates a telephone number and area code with this group. No spaces or dashes are allowed.
|
Step 3 |
exit
se-10-0-0-0(config)# exit |
Exits configuration mode. |
Step 4 |
show groups or show group detail groupname groupid
se-10-0-0-0# show group detail groupname sales |
Displays a list of group IDs for all configured groups. This command does not display the details for the groups. Displays the detailed configuration information for the group groupid value. |
Step 5 |
copy running-config startup-config
se-10-0-0-0# copy running-config startup-config |
Copies the configuration changes to the startup configuration. |
Examples
The following example adds an owner and two members to the group sales and assigns sales a phone number:
se-10-0-0-0(config)# groupname sales member user1
se-10-0-0-0(config)# groupname sales member user2
se-10-0-0-0(config)# groupname sales owner user1
se-10-0-0-0(config)# groupname sales phonenumber 50163
se-10-0-0-0(config)# groupname sales phonenumberE164 12225550163
sse-10-0-0-0(config)# exit
se-10-0-0-0(# show groups
se-10-0-0-0# show group detail groupname sales
Full Name: Sales Department
Phone(E.164): 12225550163