The “RBAC User Creator for Data ONTAP” tool automatically

advertisement
This article describes working RBAC when you are using VSC 4.2. It contains the following
information:
 vCenter Server and Data ONTAP RBAC concepts .......................................................................... 1
 Best practices for working with vCenter Server RBAC ............................................................... 1
 Tips for upgrading roles from a previous release or adding new roles ............................... 2
 Upgrading custom vCenter Server roles to standard, roles provided by VSC 4.2 ............ 3
 Adding a new vCenter Server role ....................................................................................................... 8
 Privileges used in standard, VSC-specific roles ............................................................................ 11
 VSC Administrator: ........................................................................................................................... 11
 VSC Read-only: ................................................................................................................................... 14
 VSC Provision:..................................................................................................................................... 15
 VSC Clone:............................................................................................................................................. 16
 VSC Scan/Migrate: ............................................................................................................................ 17
 VSC Backup: ......................................................................................................................................... 18
 VSC Restore: ........................................................................................................................................ 19
 Working with Data ONTAP RBAC roles ........................................................................................... 20
 (Clustered Data ONTAP) Adding an RBAC role ............................................................................ 21
 (Data ONTAP operating in 7-Mode) Adding an RBAC role ...................................................... 46
vCenter Server and Data ONTAP RBAC concepts
General concepts for working with vCenter Server RBAC and Data ONTAP RBAC in a
VSC environment are provided in the “Virtual Storage System 4.2 for VMware vSphere
Installation and Administration Guide,” which is available for download from the Virtual
Storage Console for VMware vSphere product library (http://libraryclnt.dmz.netapp.com/documentation/productlibrary/index.html?productID=30048) on
the NetApp Support Site.
You should be familiar with the concepts, such as vCenter Server permissions, that are
presented in the VSC install guide before performing the steps supplied in this article for
setting up RBAC.
Best practices for working with vCenter Server RBAC
To simplify using vCenter Server RBAC, VSC 4.2 includes several standard, VSC-specific
roles. These roles use vCenter Server permissions that contain both the VSC-specific
1
privileges and the native vCenter Server privileges that you need to perform standard, VSC
tasks.
If the standard, VSC-specific roles are too fine-grained for the tasks you want a user to
perform, you can combine the roles to expand the tasks for that user. You do this by cloning
these roles and using the cloned roles to create custom roles for your system. Or you can set
up a group for each task and add the user to both groups.
Keep in mind that, if you create custom roles by cloning standard, VSC-specific roles, you
must maintain your custom roles. VSC does not maintain or update these roles over
upgrades.
A list of the standard, VSC-specific roles and the privileges they contain is available in the
section “Privileges used in standard, VSC-specific roles.”
Note: When you use the standard, VSC-specific roles, you must assign the permission to the
root object and propagate it to the child objects. This is because some native vCenter Server
privileges included in these roles can only be validated by the vCenter Server on the root
object in the inventory. For example, permissions containing the Task Create privilege must
be assigned to the root object.
For more information about:


Standard VSC roles for vCenter Servers, see the “Virtual Storage System 4.2 for VMware
vSphere Installation and Administration Guide.”
Creating your own roles, see VMware's vSphere Basic System Administration guide,
Section 18 (Managing Users, Groups, Roles, and Permissions).
Tips for upgrading roles from a previous release or adding
new roles
If you are upgrading to VSC 4.2 from an earlier version of VSC where you were using
custom roles you had created, you can easily upgrade those roles to the standard, VSCspecific roles.
You can also create custom roles for VSC 4.2.
Before you add your own vCenter Server roles, you must make the following decisions:
1. Define the task you want a VSC user to be able to perform.
2. Determine which VSC-specific and native vCenter Server privileges are required to
perform that task.
2
Note: VSC provides a product-level privilege called View. This privilege provides readonly access to the VSC GUI. You must include this privilege as part of each role you
create. Without it, the user cannot access VSC.
3. Determine the object to which you must assign the vCenter Server permission. The
permission contains all the VSC-specific and native vCenter Server privileges required
for the task. If you assign the permission at the wrong level, the VSC task will not
complete successfully.
Tip: You should always assign privileges to the root object. Both VMware and NetApp
recommend this as a best practice. Setting permissions on the root object normally allows
all the child objects to inherit those permissions, unless you place a restriction on a child
object to exclude it. If your company's security policies require more restrictive
permissions, you can restrict those entities that you do not want to have the permission.
4. Make sure that any time you create a role, you include the VSC-specific View privilege.
For detailed information about vCenter Server native privileges, see VMware's vSphere
Security guide. NetApp follows the VMware recommendations for creating and using
permissions.
Upgrading custom vCenter Server roles to standard roles
provided by VSC 4.2
If you are upgrading to VSC 4.2 from a previous release where you had set up custom roles,
you can leverage the vCenter Server RBAC features provided in VSC 4.2.
Basically, you just take your current VSC users, unmap them from your custom roles, and
then map them to the standard roles provided in VSC 4.2. The following steps provide details
on how to do this.
1. Begin by verifying that the new roles exist. Under Administration, click Roles:
3
2. The Roles panel appears and displays the current roles. The new roles are shown at the
bottom of the panel.
4
3. To modify an existing user/group and upgrade them to a new role, return to the main
view in the vSphere client and highlight the top level tree on the left pane.
Note: When you use the standard, VSC-specific roles, you must assign the permission to
the root object and propagate it to the child objects. This is because some native vCenter
Server privileges included in these roles can only be validated by the vCenter Server on
the root object in the inventory. For example, the Task Create privilege must be assigned
to the root object. Setting permissions on the root object normally allows all the child
objects to inherit those permissions, unless you place a restriction on a child object to
exclude it. If your company's security policies require more restrictive permissions, you
can restrict those entities that you do not want to have the permission.
4. Select the Permissions tab. Doing this displays the current roles and the user/group that
each role is assigned to.
5
5. Select Change Access Rule and choose the role you want to change.
This example uses PnC_VSC41, which is associated with the user/group VSC_PnC, as
the role that needs to change.
5. Select OK.
6. Now select the new role that you want.
This example uses the standard, VSC-specific role VSC Clone as the new role.
6
7. Return to the Permissions tab to verify that the change occurred. The user/group
VSC_PnC should now display VSC Clone as the role.
.
7
Adding a new vCenter Server role
VSC 4.2 includes several standard, VSC-specific roles that include all the VSC-specific
privileges and the native vCenter Server privileges that you need to perform standard VSC
tasks. For a list of the privileges included in each role, see the section “Privileges used in
standard VSC-specific roles.” NetApp recommends that you use these roles.
Note: When you use the standard, VSC-specific roles, you must assign the permission to the
root object and propagate it to the child objects. This is because some native vCenter Server
privileges included in these roles can only be validated by the vCenter Server on the root
object in the inventory. For example, the Task Create privilege must be assigned to the root
object. Setting permissions on the root object normally allows all the child objects to inherit
those permissions, unless you place a restriction on a child object to exclude it. If your
company's security policies require more restrictive permissions, you can restrict those
entities that you do not want to have the permission.
If you need to create custom roles for your environment and you have already determined the
task you want to perform, the privileges it requires, and the object you need to assign the
permission to, you can complete the following steps to add a role.
1. To create the roles and assign privileges to them, navigate to the Home screen in the
vSphere client and, under Administration, click Roles.
8
2. Select Add Role.
3. Create a role for each task and assign the required VSC-specific and native vCenter
Server privileges to it.
Remember that you must include the VSC-specific, read-only View privilege. Without
this privilege, the user will not be able to access VSC.
5. Add users and/or groups to the roles you created. In the vCenter Server, highlight the
datacenter level, and then click the Permissions tab.
Note: When you use the standard, VSC-specific roles, you must assign the permission to
the root object and propagate it to the child objects. This is because some native vCenter
Server privileges included in these roles can only be validated by the vCenter Server on
the root object in the inventory. For example, the Task Create privilege must be assigned
9
to the root object. Setting permissions on the root object normally allows all the child
objects to inherit those permissions, unless you place a restriction on a child object to
exclude it. If your company's security policies require more restrictive permissions, you
can restrict those entities that you do not want to have the permission.
6. Right-click and select add permission. When the Assign Permissions dialog box
appears, assign the role to one of the displayed users or groups. You can only assign one
permission to a vCenter Server user or group.
Tip: It is a good practice to set up high-level groups and assign a single user to multiple
groups. Doing that both allows the user to have all the permissions provided by the
different groups and simplifies managing the permissions because you do not need to
repeatedly set up the same permission for each individual user.
7. If you want all the child objects to inherit this permission, check the box: Propagate to
Child Objects.
10
Privileges used in standard, VSC-specific roles
The standard, VSC-specific roles provide all the privileges necessary to perform the task
associated with that role. The sections that follow show the standard, VSC-specific roles
and the privileges associated with each role.
Note: When you use the standard, VSC-specific roles, you must assign the permission to
the root object and propagate it to the child objects. This is because some native vCenter
Server privileges included in these roles can only be validated by the vCenter Server on
the root object in the inventory. For example, the Task Create privilege must be assigned
to the root object. Setting permissions on the root object normally allows all the child
objects to inherit those permissions, unless you place a restriction on a child object to
exclude it. If your company's security policies require more restrictive permissions, you
can restrict those entities that you do not want to have the permission.
All of these roles include the VSC-specific View privilege. Without this privilege, the
user cannot access the VSC GUI.
VSC Administrator role
Folder
Datastore
Privilege
Datastore cluster
(vCenter Server 5.1) dvPort group
Configure a datastore cluster
Modify








(Previous releases of vCenter Server called this
“Distributed virtual port group”.)
(vCenter Server 5.1) Distributed switch
(Previous releases of vCenter Server called this
“Distributed virtual switch”.)
Extension
Global
• Modify
• Port configuration operation
• Port setting operation
• Register extension
• Update extension


11
Allocate space
Browse datastore
Low level file operations
Remove file
Remove datastore
Rename datastore
Move a datastore
Update virtual machine files
Cancel task
Diagnostics





Licenses
Log event
Manage custom attributes
Settings
Set Custom Attributes
Host > Configuration







Advanced settings
Security profile and firewall
Storage partition configuration
Query patch
Change Settings
Storage partition configuration
System resources
Host > Cim
CimInteraction
Host > Local




Create virtual machine
Delete virtual machine
Reconfig virtual machine
Relayout snapshots
NetApp Virtual Storage Console > Optimization 
and Migration


Configure
Initiate Scan
Migrate virtual machines
NetApp Virtual Storage Console > Monitoring
and Host Configuration > Manage


Recommended Settings
Deploy VAAIPlugin
NetApp Virtual Storage Console > Monitoring
and Host Configuration > Configure


Recommended Settings
Deploy VAAIPlugin
NetApp Virtual Storage Console > Provisioning 
and Cloning





Configure
Create Rapid Clones
Datastore
 Manage Datastores
 Provision
Distribute templates
Re-deploy clones
Reclaim space


Backup NOW
Backup Scheduled
NetApp Virtual Storage Console > Backup and
Recover > Backup
12


Delete Backup/Job
Configure
NetApp Virtual Storage Console > Backup and
Recover > Recovery




Mount/UnMount
Recover Datastore
Recover VM
Single-File Recovery
NetApp Virtual Storage Console
Network
Resource
View
Assign network





Assign virtual machine to resource
pool
Apply a DRS vMotion
recommendation
(vCenter Server 4.x) Relocate
Query vMotion
Migrate
Tasks
• Create tasks
• Update tasks
Virtual Machine > Configuration



















Add existing disk
Add new disk
Add or remove device
Advanced
Change CPU count
Change resource
Disk change tracking
Extend virtual disk
Host USB device
Memory
Modify device settings
Raw device
Remove disk
Reload from path
Rename
(vCenter Server 5.0) Set annotation
Settings
Swapfile placement
Upgrade virtual hardware
Virtual Machine > Guest Operations



Guest operation modifications
Guest Operation Program Execution
Guest Operation Queries
Virtual Machine > Interaction
• Answer question
13
•
•
•
•
•
Configure CD media
Configure floppy media
Device connection
Power off
Power on
Virtual Machine > Inventory





Create from existing
Create new
Remove
Register
Unregister
Virtual Machine > (vCenter Server 5.1) Snapshot
Management
(Previous vCenter Server versions called this
“State”.)




Create Snapshot copy
Remove Snapshot copy
Rename Snapshot copy
Revert to Snapshot copy
Virtual Machine > Provisioning









Allow disk access
Allow read-only disk access
Allow virtual machine download
Clone template
Clone virtual machine
Create template from virtual machine
Customize
Deploy template
Read customization specifications
VSC Read-only role
Folder
NetApp Virtual Storage Console
Datastore
Global
Privilege
View
Update virtual machine files
Host > Config
Change Settings
Host > Cim
CimInteraction
Tasks
• Create tasks



14
Diagnostics
Manage custom attributes
Set Custom Attributes
• Update tasks
Virtual Machine > Configuration






Virtual Machine > Interact
• Power off
• Power on
Virtual Machine > Guest Operations



Add existing disk
Add new disk
Add or remove device
Raw device
Remove disk
(vCenter Server 5.0) Set annotation
Guest operation modifications
Guest Operation Program Execution
Guest Operation Queries
VSC Provision role
Folder
Privilege
NetApp Virtual Storage Console > Provisioning  Manage datastores
and Cloning > Datastore
 Provision
Datastore






Datastore cluster
Global
Configure a datastore cluster





Licenses
Log event
Manage custom attributes
Settings
Cancel task
Host > Configuration



Advanced settings
Security profile and firewall
Storage partition configuration
NetApp Virtual Storage Console
Tasks
View
• Create tasks
• Update tasks
15
Allocate space
Browse datastore
Low level file operations
Remove file
Rename datastore
Move a datastore
Virtual Machine > Provisioning




Virtual Machine > Interaction
Power off
Virtual Machine > Inventory


Allow disk access
Allow Read-only disk access
Customize
Read customization specifications
Remove
Unregister
VSC Clone role
Folder
Datastore
Privilege





Allocate space
Browse datastore
Low level file operations
Remove file
Rename datastore
Global




Log event
Manage custom attributes
Settings
Set Custom Attributes
Host > Configuration



Advanced settings
Security profile and firewall
Storage partition configuration
NetApp Virtual Storage Console > Provisioning 
and Cloning > Datastore

Create Rapid Clones
Re-deploy clones
NetApp Virtual Storage Console
Network
Resource
View
Assign network
Tasks
• Create tasks
• Update tasks
Virtual Machine > Configuration






Assign virtual machine to resource pool
16
Add existing disk
Add new disk
Add or remove device
Advanced
Change CPU count
Change resource












Virtual Machine > Interaction
Disk change tracking
Extend virtual disk
Host USB device
Memory
Modify device settings
Raw device
Remove disk
Rename
(vCenter Server 5.0) Set annotation
Settings
Swapfile placement
Upgrade virtual hardware
Power off



Answer question
Power on
Power off
Virtual Machine > Inventory




Create from existing
Create new
Remove
Unregister
Virtual Machine > Provisioning





Clone template
Clone virtual machine
Customize
Deploy template
Read customization specifications
VSC Scan/Migrate role
Folder
Datastore
Privilege
Global





Cancel task
Licenses
Log event
Manage custom attributes
Settings
Host > Configuration

Advanced settings
Allocate space
17


NetApp Virtual Storage Console > Optimization 
and Migration

NetApp Virtual Storage Console
Network
Resource
Security profile and firewall
Storage partition configuration
Initiate Scan
Migrate virtual machines
View
Assign network



Assign virtual machine to resource
pool
Migrate powered off virtual machine
Migrate powered on virtual machine
Virtual Machine > Inventory
Virtual Machine > SnapShot management
Move
 Create a snapshot
 Remove a snapshot
Virtual Machine > Provisioning
Allow virtual machine download
VSC Backup role
Folder
Datastore
Privilege
NetApp Virtual Storage Console > Backup and
Recover > Backup




NetApp Virtual Storage Console
Task
View
• Create tasks
• Update tasks
Browse datastore
Virtual Machine > (vCenter Server 5.1) Snapshot 
Management

(Previous vCenter Server versions called this
“State”.)
18
Backup NOW
Backup Scheduled
Delete Backup/Job
Configure
Create Snapshot
Remove Snapshot
VSC Restore role
Folder
Datastore
Privilege






Allocate space
Browse datastore
Low level file operations
Move datastore
Remove datastore
Rename datastore
Host > Configuration




Advanced settings
Change settings
Storage partition configuration
System resources
Host > Local operations




Create virtual machine
Delete virtual machine
Reconfig virtual machine
Relayout snapshots
NetApp Virtual Storage Console > Backup and
Recovery > Backup

Configure
NetApp Virtual Storage Console > Backup and
Recover > Recovery




Mount/UnMount
Recover Datastore
Recover VM
Single-File Recovery
NetApp Virtual Storage Console
Resource
View




Assign virtual machine to resource
pool
Apply recommendation
Relocate
Query vMotion
Tasks
• Create tasks
• Update tasks
Virtual Machine > Configuration






19
Add existing disk
Add new disk
Advanced
Change resource
Reload from path
Remove disk
Virtual Machine > Interaction



Power off
Power on
Answer question
Virtual Machine > Inventory





Create from existing
Move
Register
Unregister
Remove
Virtual Machine > (vCenter Server 5.1) Snapshot 
Management

(Previous vCenter Server versions called this
“State”.)
Remove Snapshot
Revert to Snapshot
Working with Data ONTAP RBAC roles
To enable VSC to work with storage systems, you need to set up some Data ONTAP RBAC
roles.
NetApp recommends that you use the “RBAC User Creator for Data ONTAP” tool to
configure these roles on storage systems. This tool and detailed screenshots explaining how
to use it are posted on the NetApp Communities Forum at:
https://communities.netapp.com/docs/DOC-19074
If you do not want to use the RBAC User Creator for Data ONTAP tool, you can use one of
the following methods:

OnCommand System Manager, which can be downloaded for either Windows or Linux
platforms.

The CLI (command-line interface), using the security login set of commands.
Because the “RBAC User Creator for Data ONTAP” tool is well-explained on the NetApp
Communities site, this article provides steps using OnCommand System Manager simply to
illustrate that there are multiple ways to set up these roles. The roles used in these steps have
the minimum set of privileges required to work with VSC.
More information about setting up Data ONTAP RBAC roles is in the Data ONTAP ClusterMode Systems Administration Guide.
Special note about Provisioning and Cloning roles
20
When you are working with Provisioning and Cloning, it is important to remember that you
can break the comprehensive, Provisioning and Cloning role into sub-roles based on the tasks
a user needs to perform. The graphic below illustrates the key Provisioning and Cloning
roles. As the circle expands out, each role after the center role has both its privileges and the
privileges associated with the roles under it.
For example, if you wanted a user to have modify storage role privileges as defined below,
you would add that user to the create clones, create storage, and modify storage
roles to ensure that the user had all the required privileges.
(Clustered Data ONTAP) Adding an RBAC role using
System Manager
Configuring RBAC for VSC when working with storage systems running clustered Data ONTAP
requires that you:

Grant privileges to commands and/or command directories. There are two levels of
access for each command/command directory:


all-access
read-only

Assign users directly to roles.

Vary your configuration depending on whether you have VSC connected to the Cluster
Admin IP for the entire cluster or directly to a Vserver within the cluster.
21
To simplify configuring these roles on storage systems, you can use a tool such as the
“RBAC User Creator for Data ONTAP,” which is posted on the NetApp Communities
Forum at:
https://communities.netapp.com/docs/DOC-19074
The “RBAC User Creator for Data ONTAP” tool automatically handles setting up the Data
ONTAP privileges correctly. For example, you should always add the all-access privileges
before you add the read-only privileges. If you first add the read-only privilege and then add
the all-access privilege, Data ONTAP marks the all-access privilege as a duplicate and
ignores it. The “RBAC User Creator for Data ONTAP” automatically adds the privileges in
the correct order.
The steps that follow provide an example of using OnCommand System Manager to create a
Data ONTAP RBAC role.
Note: For consistency, the VSC documentation refers to the roles as using privileges. The
OnCommand System Manager GUI uses the term “attribute” instead of “privilege.” When
setting up Data ONTAP RBAC roles, both these terms mean the same thing.
1. Log in to the cluster with a user account that has the ability to create roles and manage
users.
22
2. Go to Configuration > Security > Roles, and click Add:
3.
In the Add Role dialog box, enter the role name, and then click Add to add the first role
privilege:
23
4. Enter the role privilege command and access level as shown below. You can leave the
query field blank. Click OK.
24
5. Repeat Step 4 for each required command. When you have added all the role privileges,
click Add at the bottom of the Add Role dialog box to add the role. The new role should
now be visible in the main screen:
6. Now create/assign the desired user(s) to the role. Go to Configuration > Security >
Users and then click Add (or Edit if using an existing user):
25
7. In the Add User window, enter a username and password, and then under 'User login
methods' assign the user the 'ontapi' application and the role that you want the user to
have. Click on OK for each role you assign. A user can have multiple roles.
In this example, the user MHC_user gets the MHC role:
26
8. Once the list of roles has been added, click Add at the bottom of the dialog box to
create/modify the user. The user should now appear back on the main screen:
27
Clustered Data ONTAP role privileges
The required privileges for each role are shown below. They are grouped according to the
role and whether they require all-access or read-only access.
When you work with clustered Data ONTAP, you should always add the all-access
privileges first.
The “RBAC User Creator for Data ONTAP” tool adds the privileges in the correct order
automatically.
Clustered Data ONTAP role privileges for Monitoring and Host Configuration - Cluster
Admin

All Access Commands
network interface migrate
security login profiles set
storage failover show
system node run
volume efficiency stat

Read Only Commands
cluster identity show
cluster peer show
28
lun igroup show
lun mapped show
lun show
network fcp adapter show
network interface show
network port show
security login role show
security login show
storage aggregate show
storage disk show
system health alert show
system health status show
system license show
system node show
version
volume efficiency show
volume qtree show
volume show
vserver export-policy rule show
vserver fcp interface show
vserver show
Clustered Data ONTAP role privileges for Monitoring and Host Configuration - Direct
vServer

All Access Commands
security login profiles
set
system node run
volume efficiency stat

Read Only Commands
lun igroup show
lun mapped show
lun show
version
network interface
volume efficiency show
volume qtree show
volume show
vserver export-policy rule show
vserver fcp interface show
vserver
Clustered Data ONTAP role privileges for Provisioning and Cloning - Cluster Admin
Provisioning and Cloning role: Create Clones

All Access Commands
29
network interface migrate
security login profiles
set
storage failover show
system node run
system node show
volume efficiency stat
volume file clone create
volume file reservation
volume file show-disk-usage
vserver export-policy show
vserver nfs show

Read Only Commands
cluster identity show
cluster peer show
lun geometry
lun igroup show
lun mapped show
lun show
network fcp adapter show
network interface show
network port show
security login role show
security login show
storage aggregate show
storage disk show
system health alert show
system health status show
system license show
version
volume efficiency show
volume qtree show
volume quota report
volume show
vserver export-policy rule show
vserver fcp interface show
vserver fcp show
vserver iscsi show
vserver nfs status
vserver show
Provisioning and Cloning role: Create Storage

All Access Commands
lun
lun
lun
lun
lun
comment
create
igroup add
igroup create
igroup set
30
lun igroup show
lun map
lun modify
lun move
lun online
lun unmap
network interface migrate
security login profiles
set
snapmirror update-ls-set
storage failover show
system node autosupport invoke
system node run
system node show
volume autosize
volume clone create
volume create
volume efficiency on
volume efficiency show
volume efficiency start
volume efficiency stat
volume efficiency stop
volume file
volume file clone create
volume file reservation
volume file show-disk-usage
volume modify
volume restrict
volume snapshot create
volume snapshot delete
volume unmount
vserver export-policy rule create
vserver export-policy rule setindex
vserver export-policy show
vserver iscsi interface accesslist add
vserver nfs show
vserver nfs status
vserver services unix-group adduser
vserver services unix-group create
vserver services unix-user create

Read Only Commands
cluster identity show
cluster peer show
job show-completed
lun geometry
lun initiatorListMap show
lun mapped show
lun show
network fcp adapter show
network interface show
network port show
security login role show
security login show
snapmirror show
31
storage aggregate show
storage disk show
system health alert show
system health status show
system license show
version
volume qtree show
volume quota report
volume show
volume snapshot show
vserver export-policy rule show
vserver fcp initiator show
vserver fcp interface show
vserver fcp show
vserver iscsi connection show
vserver iscsi interface show
vserver iscsi session show
vserver iscsi show
vserver nfs status
vserver services unix-group show
vserver services unix-user show
vserver show
Provisioning and Cloning role: Modify Storage

All Access Commands
lun comment
lun create
lun igroup add
lun igroup create
lun igroup set
lun map
lun modify
lun move
lun online
lun resize
lun unmap
network interface migrate
security login profiles
set
snapmirror update-ls-set
storage failover show
system node autosupport invoke
system node run
system node show
volume autosize
volume clone create
volume create
volume efficiency on
volume efficiency off
volume efficiency show
volume efficiency start
32
volume efficiency stat
volume efficiency stop
volume file
volume file clone create
volume file reservation
volume file show-disk-usage
volume modify
volume restrict
volume size
volume snapshot create
volume snapshot delete
volume unmount
vserver export-policy rule create
vserver export-policy rule setindex
vserver export-policy show
vserver iscsi interface accesslist add
vserver nfs show
vserver nfs status
vserver services unix-group adduser
vserver services unix-group create
vserver services unix-user create

Read Only Commands
cluster identity show
cluster peer show
job show-completed
lun geometry
lun igroup show
lun initiatorListMap show
lun mapped show
lun show
network fcp adapter show
network interface show
network port show
security login role show
security login show
snapmirror show
storage aggregate show
storage disk show
system health alert show
system health status show
system license show
version
volume qtree show
volume quota report
volume show
volume snapshot show
vserver export-policy rule show
vserver fcp initiator show
vserver fcp interface show
vserver fcp show
vserver iscsi connection show
vserver iscsi interface show
vserver iscsi session show
vserver iscsi show
33
vserver
vserver
vserver
vserver
nfs status
services unix-group show
services unix-user show
show
Provisioning and Cloning role: Destroy Storage

All Access Commands
lun comment
lun create
lun delete
lun igroup add
lun igroup create
lun igroup set
lun map
lun modify
lun move
lun online
lun offline
lun resize
lun unmap
network interface migrate
security login profiles
set
snapmirror update-ls-set
storage failover show
system node autosupport invoke
system node run
system node show
volume autosize
volume clone create
volume create
volume destroy
volume efficiency on
volume efficiency off
volume efficiency show
volume efficiency start
volume efficiency stat
volume efficiency stop
volume file
volume file clone create
volume file reservation
volume file show-disk-usage
volume modify
volume offline
volume restrict
volume size
volume snapshot create
volume snapshot delete
volume unmount
vserver export-policy rule create
vserver export-policy rule setindex
vserver export-policy show
vserver iscsi interface accesslist add
vserver nfs show
34
vserver
vserver
vserver
vserver

nfs status
services unix-group adduser
services unix-group create
services unix-user create
Read Only Commands
cluster identity show
cluster peer show
job show-completed
lun geometry
lun igroup show
lun initiatorListMap show
lun mapped show
lun show
network fcp adapter show
network interface show
network port show
security login role show
security login show
snapmirror show
storage aggregate show
storage disk show
system health alert show
system health status show
system license show
version
volume qtree show
volume quota report
volume show
volume snapshot show
vserver export-policy rule show
vserver fcp initiator show
vserver fcp interface show
vserver fcp show
vserver iscsi connection show
vserver iscsi interface show
vserver iscsi session show
vserver iscsi show
vserver nfs status
vserver services unix-group show
vserver services unix-user show
vserver show
Clustered Data ONTAP role privileges for Provisioning and Cloning - Direct Connect
vServer
Provisioning and Cloning role: Create Clones

All-Access Commands
network interface
security login profiles
set
35
system node run
volume efficiency stat
volume file clone create
volume file reservation
volume file show-disk-usage
vserver export-policy show
vserver nfs show

Read-Only Commands
lun geometry
lun igroup show
lun mapped show
lun show
version
volume efficiency show
volume qtree show
volume quota report
volume quota show
volume show
vserver
vserver export-policy rule show
vserver fcp interface show
vserver fcp show
vserver iscsi show
vserver nfs status
Provisioning and Cloning role: Create Storage

All-Access Commands
lun comment
lun create
lun igroup add
lun igroup create
lun igroup set
lun igroup show
lun map
lun modify
lun move
lun online
lun unmap
network interface
security login profiles
set
*snapmirror
volume autosize
volume clone create
volume create
volume efficiency on
volume efficiency show
volume efficiency start
volume efficiency stat
36
volume efficiency stop
volume file
volume file clone create
volume file reservation
volume file show-disk-usage
volume modify
volume restrict
volume snapshot create
volume snapshot delete
volume unmount
vserver export-policy rule create
vserver export-policy rule setindex
vserver export-policy show
vserver iscsi interface accesslist add
vserver nfs show
vserver nfs status
vserver services unix-group adduser
vserver services unix-group create
vserver services unix-user create

Read-Only Commands
job show-completed
lun geometry
lun initiatorListMap show
lun mapped show
lun show
snapmirror show
version
volume qtree show
volume quota report
volume quota show
volume show
volume snapshot show
vserver
vserver export-policy rule show
vserver fcp initiator show
vserver fcp interface show
vserver fcp show
vserver iscsi connection show
vserver iscsi interface show
vserver iscsi session show
vserver iscsi show
vserver services unix-group show
vserver services unix-user show
Provisioning and Cloning role: Modify Storage

All-Access Commands
lun
lun
lun
lun
lun
comment
create
igroup add
igroup create
igroup set
37
lun igroup show
lun map
lun modify
lun move
lun online
lun resize
lun unmap
network interface
security login profiles
set
system node run
*snapmirror
volume autosize
volume clone create
volume create
volume efficiency on
volume efficiency off
volume efficiency show
volume efficiency start
volume efficiency stat
volume efficiency stop
volume file
volume file clone create
volume file reservation
volume file show-disk-usage
volume modify
volume restrict
volume size
volume snapshot create
volume snapshot delete
volume unmount
vserver export-policy rule create
vserver export-policy rule setindex
vserver export-policy show
vserver iscsi interface accesslist add
vserver nfs show
vserver nfs status
vserver services unix-group adduser
vserver services unix-group create
vserver services unix-user create

Read-Only Commands
job show-completed
lun geometry
lun initiatorListMap show
lun mapped show
lun show
snapmirror show
version
volume qtree show
volume quota report
volume quota show
volume show
volume snapshot show
vserver
38
vserver
vserver
vserver
vserver
vserver
vserver
vserver
vserver
vserver
vserver
export-policy rule show
fcp initiator show
fcp interface show
fcp show
iscsi connection show
iscsi interface show
iscsi session show
iscsi show
services unix-group show
services unix-user show
Provisioning and Cloning role: Destroy Storage

All-Access Commands
lun comment
lun create
lun delete
lun igroup add
lun igroup create
lun igroup set
lun igroup show
lun map
lun modify
lun move
lun online
lun offline
lun resize
lun unmap
network interface
security login profiles
set
system node run
*snapmirror
volume autosize
volume clone create
volume create
volume destroy
volume efficiency on
volume efficiency off
volume efficiency show
volume efficiency start
volume efficiency stat
volume efficiency stop
volume file
volume file clone create
volume file reservation
volume file show-disk-usage
volume modify
volume offline
volume restrict
volume size
volume snapshot create
volume snapshot delete
volume unmount
vserver export-policy rule create
39
vserver
vserver
vserver
vserver
vserver
vserver
vserver
vserver

export-policy rule setindex
export-policy show
iscsi interface accesslist add
nfs show
nfs status
services unix-group adduser
services unix-group create
services unix-user create
Read-Only Commands
job show-completed
lun geometry
lun igroup show
lun initiatorListMap show
lun mapped show
lun show
snapmirror show
version
volume qtree show
volume quota report
volume quota show
volume show
volume snapshot show
vserver
vserver export-policy rule show
vserver fcp initiator show
vserver fcp interface show
vserver fcp show
vserver iscsi connection show
vserver iscsi interface show
vserver iscsi session show
vserver iscsi show
vserver services unix-group show
vserver services unix-user show
Clustered Data ONTAP role privileges for Optimization and Migration

All-Access Commands
lun comment
lun create
lun igroup add
lun igroup create
lun igroup set
lun map
lun modify
lun move
lun online
lun unmap
network interface migrate
security login profiles
set
storage failover show
system node autosupport invoke
40
system node run
system node show
volume autosize
volume clone create
volume create
volume efficiency on
volume efficiency show
volume efficiency start
volume efficiency stat
volume efficiency stop
volume file clone create
volume file show-disk-usage
volume modify
volume restrict
volume snapshot create
volume snapshot delete
volume unmount
vserver export-policy rule create
vserver export-policy rule setindex
vserver export-policy show
vserver iscsi interface accesslist add
vserver nfs show
vserver nfs status
vserver services unix-group adduser
vserver services unix-group create
vserver services unix-user create

Read-Only Commands
cluster identity show
cluster peer show
lun geometry
lun igroup show
lun initiatorListMap show
lun mapped show
lun show
network fcp adapter show
network interface show
network port show
security login role show
security login show
storage aggregate show
storage disk show
system health alert show
system health status show
system license show
version
volume qtree show
volume quota report
volume show
volume snapshot show
vserver export-policy rule show
vserver fcp initiator show
vserver fcp interface show
vserver fcp show
vserver iscsi connection show
41
vserver
vserver
vserver
vserver
vserver
vserver
iscsi session show
iscsi show
nfs status
services unix-group show
services unix-user show
show
Clustered Data ONTAP role privileges for Optimization and Migration - Direct Connect
vServer

All-Access Commands
lun comment
lun create
lun igroup add
lun igroup create
lun igroup set
lun map
lun modify
lun move
lun online
lun unmap
security login profiles
set
volume autosize
volume clone create
volume create
volume efficiency on
volume efficiency show
volume efficiency start
volume efficiency stat
volume efficiency stop
volume file clone create
volume file reservation
volume file show-disk-usage
volume modify
volume restrict
volume snapshot create
volume snapshot delete
volume unmount
vserver export-policy rule create
vserver export-policy rule setindex
vserver export-policy show
vserver iscsi interface accesslist add
vserver nfs show
vserver nfs status
vserver services unix-group adduser
vserver services unix-group create
vserver services unix-user create

Read-Only Commands
42
job show-completed
lun geometry
lun igroup show
lun initiatorListMap show
lun mapped show
lun show
snapmirror show
version
volume qtree show
volume quota report
volume show
volume snapshot show
vserver export-policy rule show
vserver fcp initiator show
vserver fcp interface show
vserver fcp show
vserver iscsi connection show
vserver iscsi interface show
vserver iscsi session show
vserver iscsi show
vserver nfs status
vserver services unix-group show
vserver services unix-user show
vserver
Clustered Data ONTAP role privileges for Backup and Recovery - Cluster Admin

All-Access Commands
cluster identity show
job history show
lun delete
lun igroup add
lun igroup create
lun igroup delete
lun igroup new
lun igroup show
lun initiatorListMap show
lun map
lun mapped show
lun new
lun online
lun serial
lun show
lun unmap
network interface migrate
network interface new
network interface show
security login profiles
security login role show-ontapi
set
snapmirror (SN.0)
snapmirror get-volume-status
43
snapmirror new
snapmirror show
snapmirror update
snapmirror update-ls-set
storage failover show
system license show
system node run
system node show
version
volume clone create
volume clone new
volume destroy
volume efficiency stat
volume file clone create
volume file show-disk-usage
volume mount
volume new
volume offline
volume qtree new
volume qtree show
volume show
volume snapshot create
volume snapshot delete
volume snapshot new
volume snapshot rename
volume snapshot restore-file
volume snapshot show
volume unmount
vserver create
vserver export-policy new
vserver export-policy show
vserver fcp nodename
vserver fcp status
vserver iscsi nodename
vserver iscsi status
vserver modify
vserver new
vserver peer show
vserver show

Read-Only Commands
cluster peer show
network fcp adapter show
network interface show
network port show
security login role show
security login show
storage aggregate show
storage disk show
system health alert show
system health status show
system license show
volume efficiency show
volume qtree show
volume show
44
vserver export-policy rule show
vserver fcp interface show
Clustered Data ONTAP role privileges for Backup and Recovery - Direct Connect vsServer

All-Access Commands
job history show
lun delete
lun igroup add
lun igroup create
lun igroup delete
lun igroup new
lun igroup show
lun initiatorListMap show
lun map
lun mapped show
lun new
lun online
lun serial
lun show
lun unmap
network interface
security login profiles
security login role show-ontapi
set
snapmirror get-volume-status
snapmirror new
snapmirror show
snapmirror update
version
volume clone create
volume clone new
volume destroy
volume efficiency stat
volume file clone create
volume file show-disk-usage
volume mount
volume new
volume offline
volume qtree new
volume qtree show
volume show
volume snapshot create
volume snapshot delete
volume snapshot new
volume snapshot rename
volume snapshot restore-file
volume snapshot show
volume unmount
vserver export-policy new
vserver export-policy show
vserver fcp nodename
45
vserver
vserver
vserver
vserver
vserver

fcp status
iscsi nodename
iscsi status
peer show
Read-Only Commands
volume efficiency show
vserver export-policy rule show
vserver fcp interface show
(Data ONTAP operating in 7-Mode) Adding an RBAC role
using System Manager
Configuring RBAC for VSC when storage systems are running Data ONTAP operating in 7Mode requires three major steps:
1. Configure the roles using the useradmin set of commands.
2. Assign permissions for API (application programming interface) functions to these roles.
3. Add the users and/or groups to the roles.
You perform these steps on all the storage systems that host VMFS or NFS datastores.
To simplify configuring these roles on storage systems, you can use a tool such as the
“RBAC User Creator for Data ONTAP,” which is posted on the NetApp Communities
Forum at:
https://communities.netapp.com/docs/DOC-19074
The “RBAC User Creator for Data ONTAP” tool automatically handles setting up the Data
ONTAP privileges correctly.
If you want to manually configure RBAC, the steps that follow provide an example of how to
create a Data ONTAP RBAC role.
1. Enter the following command on the storage system.
You must enter this command as a single line. Use commas to separate the list of Data
ONTAP privileges following the -a option. Do not use spaces to separate the list of
privileges.
useradmin role add role_name -a capability_list
46
role_name: The name you assign to the role so you can identify that role.
capability_list: The comma-separated list of Data ONTAP privileges.
These
privileges are listed later in this article.
2. Create a user group with the role you set up by entering the following command:
useradmin group add group_name -r role_name
group_name: The name of the group you are creating.
role_name: The name of the role you created in the previous
step.
3. Create a user in the group by entering the following command:
useradmin user add user_name [-p password] -g group_name
user_name: The name of the user you are creating.
password: The password for this user. If you do not
specify a password, the system
prompts you for one.
group_name: The name of the group you created in the previous step.
4. Verify that the user was created correctly by entering the following command:
useradmin user list user_name
The user and group information is displayed.
Privileges available with Data ONTAP operating in 7-Mode
You can specify Data ONTAP 7-Mode privileges in one of these two ways:


Categories
Individual privileges
Specifying individual privileges limits what the account can do on the storage system.
If you specify the privileges by categories, the account can perform more tasks. Here are the
minimum privileges needed for any VSC operation:
login-*,api-*
If you are using Backup and Recovery or Provisioning and Cloning, you should include the
following privileges to provide the user with access to the storage system:
login-*,api-*,cli-*
If you want to specify individual privileges, the roles for each VSC capability are listed
below.
47
Data ONTAP operating in 7-Mode privileges for Monitoring and Host Configuration:
api-aggr-list-info
api-cf-get-partner
api-cf-status
(Data ONTAP 8.0.1 and later) api-copyoffload-show
api-disk-list-info
api-ems-autosupport-log
api-fcp-adapter-list-info
api-fcp-get-cfmode
api-fcp-service-status
(Data ONTAP 8.2 and later) api-feature-status-list-info
api-iscsi-service-status
(Data ONTAP 7.3.4 through Data ONTAP 8.1.2) api-license-list-info or
(Data ONTAP 8.2 and later) api-(Data ONTAP 8.2 and later) license-v2list-info
api-lun-get-vdisk-attributes
api-lun-list-info
api-lun-map-list-info
api-nfs-exportfs-list-rules
api-nfs-exportfs-list-rules-2
api-qtree-list
api-snapmirror-get-volume-status
api-snapshot-list-info
api-snmp-get
api-snmp-get-next
api-system-get-info
api-system-get-ontapi-version
api-system-get-version
api-useradmin-user-list
api-vfiler-list-info
api-volume-autosize-get
api-volume-list-info-iter-end
api-volume-list-info-iter-next
api-volume-list-info-iter-start
api-volume-options-list-info
login-http-admin
Data ONTAP operating in 7-Mode privileges for Provisioning and Cloning
Provisioning and Cloning Data ONTAP role: create clones
This role allows the VSC user to create clones of virtual machines. In addition to the
minimum set of Data ONTAP operating in 7-Mode privileges for VSC that were documented
above, you need the following privileges. Please note, these privileges cannot fit into a
single Data ONTAP role. They must be broken into two roles:
48
(Data ONTAP 8.0.1 and later) api-cloneapi-fcp-adapter-initiators-list-info
api-fcp-port-name-list-info
api-file-create-directory
api-file-delete-directory
api-file-delete-file
api-file-get-file-info
api-file-read-file
api-file-write-file
api-igroup-list-info
api-iscsi-adapter-initiators-list-info
api-iscsi-adapter-list-info
api-iscsi-connection-list-info
api-iscsi-portal-list-info
api-iscsi-session-list-info
api-lun-get-geometry
api-nfs-status
api-quota-report
(Data ONTAP 7.3.4 through Data ONTAP 8.1.2) api-raid-info-listdisk
(Data ONTAP 7.3.4 through Data ONTAP 8.1.2) api-raid-info-listplex
api-system-cli
api-useradmin-domainuser-list
api-useradmin-group-list
cli-cifs
cli-df
cli-ifconfig
cli-mv
cli-ndmpcopy
cli-ndmpd
security-api-vfiler
security-priv-diagnostic
Provisioning and Cloning Data ONTAP role: create storage
This role allows for the creation of volumes and Logical Unit Number (LUNs). In addition to
the previous role's Data ONTAP operating in 7-Mode privileges, you also need the following
privileges. Please note, these cannot fit in a single Data ONTAP role. They must be broken
into two roles:
api-igroup-add
api-igroup-create
api-igroup-set-attribute
api-lun-create-by-size
api-lun-create-from-file
api-lun-initiator-list-map-info
api-lun-map
api-lun-move
api-lun-online
api-lun-set-comment
api-lun-unmap
api-nfs-exportfs-append-rules-2
api-nfs-exportfs-load-exports
api-nfs-exportfs-modify-rule-2
49
api-sis-enable
api-sis-start
api-sis-stop
api-snapmirror-break
api-snapmirror-delete-schedule
api-snapmirror-get-status
api-snapmirror-initialize
api-snapmirror-off
api-snapmirror-on
api-snapmirror-release
api-snapmirror-resync
api-snapmirror-set-schedule
api-snapmirror-update
api-snapshot-create
api-snapshot-set-reserve
api-vfiler-add-storage
api-volume-autosize-set
api-volume-clone-create
api-volume-create
api-volume-restrict
api-volume-set-option
cli-iscsi
cli-lun
cli-qtree
cli-vfiler
Provisioning and Cloning Data ONTAP role: modify storage
This role allows the VSC user to resize and deduplicate storage when working with Data
ONTAP operating in 7-Mode. In addition to the privileges provided by the previous roles,
you also need the following privileges:
api-volume-size
api-sis-disable
api-lun-resize
(Data ONTAP 7.3.4 only) api-file-punch-hole
Provisioning and Cloning Data ONTAP role: destroy storage
This role allows the VSC user to destroy volumes and LUNs storage when working with
Data ONTAP operating in 7-Mode. In addition to the privileges provided by the previous
roles, you also need the following privileges:
api-volume-offline
api-volume-destroy
api-lun-offline
api-lun-destroy
Optimization and Migration
No additional APIs are required for Optimization and Recovery.
50
This plugin uses the same set of privileges as the 'Create Storage' role found in the
Provisioning and Cloning section.
Backup and Recovery
Backup and Recovery requires following privileges when working with a storage system
running Data ONTAP operating in 7-Mode. Please note, these privileges cannot fit into a
single Data ONTAP role. They must be broken into two roles:
api-fcp-adapter-initiators-list-info
api-fcp-node-get-name
api-file-create-directory
api-file-delete-file
api-file-list-directory-iter-end
api-file-list-directory-iter-next
api-file-list-directory-iter-start
api-igroup-add
api-igroup-create
api-igroup-destroy
api-igroup-list-info
api-igroup-set-attribute
api-iscsi-initiator-list-info
api-iscsi-node-get-name
api-lun-create-from-snapshot
api-lun-destroy
api-lun-get-serial-number
api-lun-initiator-list-map-info
api-lun-map
api-lun-online
api-lun-restore-status
api-lun-unmap
api-net-ifconfig-get
api-nfs-exportfs-append-rules-2
api-nfs-exportfs-modify-rule-2
api-nfs-exportfs-storage-path
api-snapmirror-get-status
api-snapmirror-list-destinations
api-snapmirror-update
api-snapshot-create
api-snapshot-delete
api-snapshot-rename
api-snapshot-restore-file
api-snapshot-restore-volume
api-system-api-list
api-system-cli
api-vfiler-create
api-volume-clone-create
api-volume-destroy
api-volume-offline
cli-ifconfig
cli-snap
cli-system
security-priv-diagnostic
51
Download