Table Of Contents

Managing User Security: Roles and Scopes

Overview of User Authentication and Authorization

External Authentication

User Access Roles and Default Permissions

Scopes

Steps for Setting Up Users and Scopes

Creating and Managing Scopes

Creating a Scope

Editing and Viewing Scope Properties

Deleting Scopes

Managing User Accounts and Controlling User Access

Creating User Accounts and Assigning Default Permissions

Changing User Information and Disabling Accounts (General Tab)

Controlling User Permissions and Access to Scopes (Security Tab)

Controlling User Access to Maps (Maps Tab)

Deleting a Cisco ANA User Account

Changing a User's Cisco ANA Password

Managing User Security: Roles and Scopes

---

These topics describe how Cisco ANA implements a two-dimensional security engine combining a role-based security mechanism with scopes (groups of NEs) that are granted to users. In addition, it describes managing users in the Cisco ANA platform, including defining users and passwords.

•Overview of User Authentication and Authorization

•Steps for Setting Up Users and Scopes

•Creating and Managing Scopes

•Managing User Accounts and Controlling User Access

•Deleting a Cisco ANA User Account

•Changing a User's Cisco ANA Password

Overview of User Authentication and Authorization

Cisco ANA uses a combination of methods to manage user authentication and authorization:

•User authentication can be managed locally by Cisco ANA or externally by an LDAP application. Either method can be used to validate user accounts and passwords, thus controlling who can log in to Cisco ANA. If you use Cisco ANA, user information and passwords are stored in the Cisco ANA database. If you use an external LDAP application, passwords are stored on the external LDAP server. See External Authentication.

•User authorization is managed through a combination of user access roles and scopes:

–User access roles control the actions a user can perform in the Cisco ANA GUI clients. When a user's account is created, the user is assigned an access role that determines the user's default permissions. For more information, see User Access Roles and Default Permissions.

–Scopes are groups of network elements that are created by administrators. Once a scope is created, you can assign it to users. A user's default permissions determine the actions the user can perform on the NEs in the scope. These actions are referred to as the user's security level on that scope. If desired, you can assign the user a more strict user access role for a scope. For more information, see Scopes.

For example, a user named johnsmith has a user access role (or default permission) that allows him to update the software images on all network elements. You could create a scope called SanFrancisco that contains a group of switches, and then give johnsmith a stricter security access role on that scope. Thus the user johnsmith could update the software images on all network elements, except for the switches in the scope named SanFrancisco.

User authorization information (roles and scopes) is always stored in the Cisco ANA database. The external LDAP server, if used, only stores passwords.

External Authentication

External authentication means that user authentication and passwords are validated by an external application, rather than by Cisco ANA. When Cisco ANA performs the authentication, Cisco ANA validates users by checking information that is saved in the Cisco ANA database. If you use an LDAP application, the information is validated by the external LDAP server.

If Cisco ANA is using external authentication and cannot communicate with the LDAP server, the only user permitted to log back into Cisco ANA is root. This is because root is the LDAP emergency user, and is validated only by Cisco ANA. The root user can then log in to Cisco ANA, change the authentication method to local, and edit user accounts so that those users can subsequently log in. Cisco ANA uses LDAP version 3.

If you want to use external authentication, you must do the following:

•Perform the necessary installation prerequisites. See the Cisco Active Network Abstraction 3.7 Installation Guide.

•Configure Cisco ANA so that it can communicate with the LDAP server. See Using an External LDAP Server for Password Authentication, page 6-13.

If you are switching from external authentication to Cisco ANA authentication, you can import the user information from the LDAP server into Cisco ANA. That procedure is described in the Cisco Active Network Abstraction 3.7 Installation Guide.

User Access Roles and Default Permissions

User access roles control the actions a user is authorized to perform in Cisco ANA. When you create a user account, you assign one security access role to the account. This role determines the user's default permissions, which in turn determine the general GUI functions the user can perform, such as:

•Logging in to Cisco ANA.

•Managing alarms in Cisco ANA NetworkVision.

•Creating, deleting, and opening maps.

•Arranging maps, adding NEs, managing aggregations, adding NEs to a map, and setting the map's background.

•Managing business tags.

Note that the previous examples do not perform any type of configuration or provisioning on NEs. When you decide which scopes a user can access, you add a scope (a list of NEs) to the user's account, and you assign a security access role for the scope. This becomes the user's scope security level and controls the actions the user can perform on the NEs in the scope. For more information on scopes, see Scopes.

Cisco ANA provides five predefined security access roles that you can grant to users to enable system functions (see Table 9-1). (More examples are provided in Table 9-2.)

Table 9-1 User Access Roles 

Role	Description
Viewer	Views the network, links, events, and inventory. Has read-only access to the network and to nonprivileged system functions.
Operator	Performs most day-to-day business operations such as managing alarms, manipulating maps, viewing network-related information, and managing business attachments.
OperatorPlus	Manages the alarm lifecycle.
Configurator	Performs tasks and tests related to configuration and activation of services, through Command Builder, Configuration Archive, NEIM, and activation commands.
Administrator	Manages the Cisco ANA system and its security. Performs all administrative actions, including creating units, AVMs, and VNEs; and managing polling and protection groups, users, scopes, and maps.

When a new user is defined as an Administrator, this user can perform all administrative actions, including opening all maps, working with all scopes, and managing the system using Cisco ANA Manage. These activities are performed with the highest privileges. Cisco ANA Manage supports multiple administrators. Access rights do not need to be defined for an administrative user.

Scopes

Scopes are groups of managed NEs. Users can only access NEs that are in their assigned scopes. Furthermore, you designate a user access role within each scope that determines which NEs a user can access and the actions they can perform on those NEs. Cisco ANA provides a predefined scope called All Managed Elements, which cannot be edited. For more information on user access roles, see User Access Roles and Default Permissions.

After you allocate a scope and a role to a user, the user can perform various activities on the NEs included in the scope, as follows:

•Activate services.

•View NE, inventory, and link properties.

•Manage advanced options such as show counters, show utilization, and refresh.

Table 9-2 describes the actions a user can perform in the GUI clients or in a scope, based on each user access role.

Table 9-2 Scope and GUI Functions Permitted According to User Access Roles 

User Access Role	GUI-Based Actions Permitted to Users with This Role	Device Based (Scope) Actions Permitted to Users with This Role
Administrator	Administrators are the only ones that can perform actions in Cisco ANA Manage, which means managing: •Gateways, units, AVMs, VNEs. •Event notifications •Global settings: Database segments, event management settings, polling groups, protection groups, service disclaimers, report settings, and security settings (including user authentication method and password rules). •Device scopes. •User accounts. •Manage static topology links. •Workflow templates and workflows. Administrators are the only ones that can perform event management actions in Cisco ANA EventVision. Map management: •Manage the maps that users are allowed to access.	All
Configurator	Map management: •Create maps. Advanced tools: •Ping and Telnet an NE directly from the client. •Enable and disable port alarms. •Cisco ANA Command Builder.	Activation services: •Add and publish activation commands on managed NE (regardless of whether the NE is inside or outside the Configurator's scope)
OperatorPlus	Map management: •Create new maps and add NEs. •Edit, delete, and rename maps. •Save maps. Map manipulation: •Create and break aggregations. •Change map layout. •Set background image. •Create business links.	Map manipulation: •Create business tags for NEs. Display network information: •Include path tool traffic, rates, drops, or any dynamic data.
Operator	Map manipulation: •Create and delete business tags.	Display network information: •Refresh port information from NE.
Viewer	Application: •Log into Cisco ANA NetworkVision. •Change user password (if using local authentication). •View the device list. •View map. •View link properties. •Use table filter. •Export from any table.	Display network and business tag information: •View alarm list and alarm properties, and find alarms. •Find and view attachments. •View NE properties and inventory. •Calculate and view affected parties. •Open port utilization graph.

Steps for Setting Up Users and Scopes

Figure 9-1 and the subsequent text describe the steps required to customize security using Cisco ANA Manage, and the order in which the steps must be performed.

Figure 9-1 Customizing Security Flow

1. Install licenses. This allows you to control and monitor the number of client and BQL connections over a limited or unlimited period of time based on the client licenses installed. For more information, see Managing Licenses, page 2-5.

2. Configure external authentication if you want to use an external LDAP server to store passwords and authenticate users. For more information, see Using an External LDAP Server for Password Authentication, page 6-13.

3. Define scopes. This enables you to group specific managed NEs so that users can view and manage those NEs based on their individual user role. For more information, see Creating and Managing Scopes.

4. Define Cisco ANA user accounts. This enables you to define and manage user accounts, including the maps the user can access. For more information, see Managing User Accounts and Controlling User Access.

5. Grant scopes and roles to users. This enables you to manage general user account information, the list of scopes assigned to each user, and security access roles per scope. For more information, see Changing User Information and Disabling Accounts (General Tab).

Creating and Managing Scopes

Cisco ANA Manage enables you to group specific managed NEs so that users can view and manage those NEs based on their user role or permission.

After a scope is created, it can be assigned to a user. Multiple scopes can be assigned to a single user and a single scope can be assigned to multiple users. When the scope is assigned to a user, you must provide the user with security access roles that define the user's role within the assigned scope. See Changing User Information and Disabling Accounts (General Tab).

These topics explain how to manage scopes:

•Creating a Scope

•Editing and Viewing Scope Properties

•Deleting Scopes

Creating a Scope

To create a scope:

---

Step 1 Select Scopes in the Cisco ANA Manage window.

Step 2 Open the New Scope dialog box in one of the following ways:

•Right-click Scopes, then choose New Scope.

•Choose File > New Scope.

•Click New Scope in the toolbar.

Step 3 In the Scope field, enter a name for the scope.

Step 4 Specify the devices to include in the scope:

•To add devices to the scope, select the required devices from the Available Devices list and then click Add All or Add Selected to move the devices to the Active Devices list.

•To remove devices from the scope, select the devices in the Active Devices lists and then click Remove Selected or Remove All to move the devices to the Available Devices list.

---

Note You can select multiple devices by using the Ctrl key.

---

Step 5 When the Active Devices list includes the required devices for the scope, click OK. The scope is saved and is displayed in the content area.

---

Editing and Viewing Scope Properties

Cisco ANA Manage enables you to edit or view the details of a scope.

To edit or view scope properties:

---

Step 1 Select Scopes in the navigation pane.

Step 2 Select the scope that you want to edit or view in the content area.

Step 3 Open the Properties dialog box for the scope in one of the following ways:

•Right-click the scope, then choose Properties.

•Choose File > Properties.

•Click Properties in the toolbar.

For more information about the Properties dialog box, see Creating and Managing Scopes.

Step 4 Edit and view the properties as required.

Step 5 Click OK.

---

Deleting Scopes

When a scope is deleted, it is deleted from all users who have the assigned scope.

To delete a scope:

---

Step 1 Select Scopes in the navigation pane.

Step 2 Select the scope that you want to delete in the content area.

---

Note You can select multiple scopes by using the Ctrl key.

---

Step 3 Right-click the scope, then choose Delete. The scope is deleted and is removed from the content area.

---

Managing User Accounts and Controlling User Access

The Users windows enable you to define and manage user accounts. This includes managing general user information as well as security access rights and forced login changes, as required. You can also monitor a user's last login time.

Configuring a new user account in Cisco ANA involves these steps:

1. Create the user account and assign the default permissions that will control the user's access to GUI functions. See Creating User Accounts and Assigning Default Permissions.

2. (Optional) Specify the maximum number of client connections and when the user must change their password. See Changing User Information and Disabling Accounts (General Tab).

3. Apply scopes and scope permissions that will control the user's access to network elements. See Controlling User Permissions and Access to Scopes (Security Tab).

4. (Optional) Control which existing maps a user can access. This feature is disabled by default, and users can only access the maps they create after their user account is enabled. To enable this feature and change configure user access to existing maps, see Controlling User Access to Maps (Maps Tab).

Creating User Accounts and Assigning Default Permissions

A new user is created with the following predefined system defaults:

•No scopes are assigned to the user.

•The number of connections is unlimited.

•The password must be changed every 30 days.

•The maximum number of login attempts is 5.

To define a user account:

---

Step 1 Select Users in the Cisco ANA Manage window.

Step 2 Open the New User dialog box in one of the following ways:

•Right-click Users, then choose New User.

•Choose File > New User.

•Click New User in the toolbar.

Step 3 Enter the information required to define a new user:

Field	Description
User Name	Enter the new user's name to be used for logging in. Note The username is unique and can contain a maximum of 20 characters. Special characters cannot be used.
Full Name	(Optional) Enter the full name of the user. Note Valid entries contain a maximum of 20 characters; special characters cannot be used.
Description	(Optional) Enter a free text description of the user.
External user only	If checked, Cisco ANA will only let the user log in if the user's password can be validated by an external LDAP server. The password fields are disabled. (If external authentication is being used, the box is checked by default. See Using an External LDAP Server for Password Authentication, page 6-13.)
Password	Enter the new Cisco ANA password, which is then stored in the Cisco ANA database. (This field is disabled if the Non-ANA Authentication Only check box is checked.) Passwords must adhere to the global password rules set by the administrator (see Setting Global Password Rules, page 6-16).
Confirm password	Reenter the new Cisco ANA password.
Role	In the drop-down list, choose the security access role that will be the user's default permissions. Note The permission applies only to activities or actions that are not related to an NE. For more information on the functionality that a user can perform, see User Access Roles and Default Permissions.
Force password change at next login	This check box is checked by default and forces the user to change the user password when they next log in. (This field is disabled if the Non-ANA Authentication Only check box is checked.)

Step 4 Click Create. The new username and default security access role are displayed in the content area.

---

The basic user account is created. To verify your settings, see Changing User Information and Disabling Accounts (General Tab). The user will not be able to see any network elements until you assign a scope to the user. See Controlling User Permissions and Access to Scopes (Security Tab).

Changing User Information and Disabling Accounts (General Tab)

After you create a user account, when you view the user properties and select the General tab, you will see the information you entered when the account was created. You can further refine the account by controlling the number of GUI client connections for the user, or forcing them to change their password after a certain time. You can also disable or reenable a user account using the following procedure.

To view or edit general user information:

---

Step 1 Select Users in the Cisco ANA window.

Step 2 Right-click the required user, then choose Properties.

The Properties dialog box is displayed with the General tab selected by default.

Step 3 Edit the general properties as required:

Field	Description
User Name	The current username. The username cannot be modified.
Last Login	The date and time that the user last logged in.
Full Name	The user's full name.
Description	A description of the user.
Enable account	Check this check box to enable the user account, or uncheck the check box to disable the user account. The user account is automatically locked when the number of logins defined is exceeded (the Limit Connections to option is enabled). It is also locked if the user account is not active for a certain number of days, as configured in the Global Settings branch (see Automatically Disabling Accounts for Inactive Users, page 6-17); by default, this period is 30 days. You can manually lock or unlock a user's account at any time. A user whose account is locked cannot log into the system.
External user only	If checked, Cisco ANA will only let the user log in if their password can be validated by an external LDAP server. The passwords entered in the Password field in this dialog box will be disabled, and the user will not be able to log in even if Cisco ANA switches back to local authentication. (If external authentication is being used, the box is checked by default. See Using an External LDAP Server for Password Authentication, page 6-13.) If you uncheck this check box, Cisco ANA prompts you for a new password that will be used for local authentication. The password is stored in the Cisco ANA database, and the Force Password fields become active.
Limit connections to	The number of instances of Cisco ANA client applications that the user can access at any one time. For example, if the number of connections is limited to 10, the user can have five instances of Cisco ANA Manage and five instances of Cisco ANA NetworkVision open at the same time. If the user then tries to open an instance of Cisco ANA EventVision, the attempt is refused.
Force password change after ___ days	If checked, it forces the user to change their password after a specific number of days. Uncheck this check box to allow the user to retain their current password indefinitely. If you check the check box, enter the number of days after which the user is forced to change their password. (This field is disabled if the Non-ANA Authentication Only check box is checked.)
Force password change at next login	Check this check box to force the user to change their user password when they next log in. You can set this option at any time. (This field is disabled if the Non-ANA Authentication Only check box is checked.)

Step 4 Click Apply to accept your entries.

Step 5 Click OK to close the Properties dialog box or click the Security tab to assign scopes to the user. (See Controlling User Permissions and Access to Scopes (Security Tab) for more information.)

---

Controlling User Permissions and Access to Scopes (Security Tab)

The Security tab enables you to manage the user's capability to view and manage applications and NEs by applying user scopes and security access roles. Users cannot view any network elements until a scope is assigned to them. The scopes, and the level of access to the network elements, is controlled by the settings you specify in the following procedure.

---

Note A user can have different security access roles for different scopes.

---

To assign a scope and security level to a user:

---

Step 1 Select the Users branch in Cisco ANA.

Step 2 Right-click the required user, then choose Properties.

Step 3 In the User Properties dialog box, click the Security tab.

Step 4 In the Default drop-down list, choose the default security level for the user. By default, a new user is assigned the viewer security access role. The level that you select here is the value displayed in the ANA Users table.

Step 5 Click Add to add a scope to the active rights of the user.

Step 6 In the Security Level dialog box, choose the required scope and the appropriate security level within this scope for the user:

Field	Description
Available Scopes	Lists all predefined and unassigned scopes.
Security Level	Displays the security access roles for the defined scopes. For more information, see Scopes.

Step 7 Click OK. The scope is added to the list of Active Rights in the Security tab.

Step 8 Click Apply, then OK.

---

Controlling User Access to Maps (Maps Tab)

You can use the Maps tab to control user access to existing maps.

---

Note This feature is disabled by default.

---

When logging in to Cisco ANA NetworkVision, new users do not have permission to view any existing maps; they can only access maps they create going forward. However, administrators can assign existing maps to new users by enabling this feature and manually assigning the maps.

To enable this feature.

---

Step 1 Log in to the gateway server as user sheer.

Step 2 Change to the ANAHOME/Main directory.

Step 3 Run the following command (which is one line):

# ./runRegTool.sh -gs 127.0.0.1 set 0.0.0.0 
site/mmvm/services/securitymanager/map-security-enabled true 

Step 4 When the gateway server returns a success message, restart the gateway.

---

To assign maps to a user (after enabling the feature):

---

Step 1 Select Users in the Cisco ANA window.

Step 2 Right-click the required user, then choose Properties.

The User Properties dialog box is displayed.

Step 3 Click the Maps tab.

The Maps tab is divided into two parts:

•The left side displays a list of all available maps in the database that have not been assigned to the user.

•The right side displays all maps that have been assigned to the user and that the user can open and manage in Cisco ANA NetworkVision.

The following buttons are displayed between the available maps and assigned maps lists in the Maps tab:

Button	Description
	Moves the selected map to the Assigned Maps list.
	Move the entire available map list to the Assigned Maps list.
	Removes a selected map from the assigned map list to the Available Map list.
	Removes the entire assigned map list to the Available Map list.

Step 4 Choose a map from the list of Available Maps, then click the required button to add the map to the list of Assigned Maps to the user.

---

Note You can select multiple rows by using the Ctrl key.

---

Step 5 Choose and move maps between the two lists, as required, using the appropriate buttons.

Step 6 Click OK to confirm the user's assigned maps.

---

Deleting a Cisco ANA User Account

To delete a user account:

---

Step 1 Select Users in the Cisco ANA window.

Step 2 In the content area, select the user account that you want to delete.

---

Note You can select multiple rows by using the Ctrl key.

---

Step 3 Right-click the user, then choose Delete. The selected user is deleted, and is not displayed in the content area.

---

Changing a User's Cisco ANA Password

You can use Cisco ANA Manage to change a user's Cisco ANA password at any time. Passwords must adhere to the global password rules set by the administrator (see Setting Global Password Rules, page 6-16).

The following procedures apply only if you are using Cisco ANA to validate users. If you are using an external LDAP application to manage passwords, you must change the passwords in the LDAP server.

There are different procedures for administrators and for users, as described in the following.

Changing Passwords—Procedure for Administrator

To change a user's password as an administrator:

---

Step 1 Select Users in the Cisco ANA window.

Step 2 In the content area, select the user whose password you want to change.

Step 3 Right-click the required user, then choose Change Password.

Step 4 Enter the new password in the Password and Confirm Password fields.

Step 5 Click OK. A confirmation message is displayed.

Step 6 Click OK.

---

Changing Passwords—Procedure for Users

Cisco ANA Manage also enables the current user to initiate a change of password.

To change your password as a user:

---

Step 1 Choose Tools > Change User Password.

Step 2 Enter the old password in the Old Password field.

Step 3 Enter the new password in the New Password and Confirm Password fields.

Step 4 Click OK. A confirmation message is displayed.

Step 5 Click OK.

---