Each VMware Cloud Director predefined role contains a default set of rights required to perform operations included in common workflows. By default, all predefined global tenant roles are published to every organization in the system.
Predefined Provider Roles
By default, the provider roles that are local only to the provider organization are the System Administrator and Multisite System roles. System administrators can create additional custom provider roles.
- System Administrator
- The System Administrator role exists only in the provider organization. The System Administrator role includes all rights in the system. For a list of rights available only to the System administrator role, see #GUID-438B2F8C-65B0-4895-AF40-6506E379A89D. The System administrator credentials are established during installation and configuration. A System Administrator can create additional system administrator and user accounts in the provider organization.
- Multisite System
- Used for running the heartbeat process for multisite deployments. This role has only a single right, Multisite: System Operations, which gives a permission to make a Cloud Director OpenAPI request that retrieves the status of the remote member of a site association.
Predefined Global Tenant Roles
By default, the predefined global tenant roles and the rights they contain are published to all organizations. System Administrators can unpublish rights and global tenant roles from individual organizations. System Administrators can edit or delete predefined global tenant roles. System administrators can create and publish additional global tenant roles.
- Organization Administrator
- After creating an organization, a System Administrator can assign the role of Organization Administrator to any user in the organization. A user with the predefined Organization Administrator role can manage users and groups in their organization and assign them roles, including the predefined Organization Administrator role. Roles created or modified by an Organization Administrator are not visible to other organizations.
- Catalog Author
- The rights associated with the predefined Catalog Author role allow a user to create and publish catalogs.
- vApp Author
- The rights associated with the predefined vApp Author role allow a user to use catalogs and create vApps.
- vApp User
- The rights associated with the predefined vApp User role allow a user to use existing vApps.
- Console Access Only
- The rights associated with the predefined Console Access Only role allow a user to view virtual machine state and properties and to use the guest OS.
- Defer to Identity Provider
-
Rights associated with the predefined
Defer to Identity Provider role are determined based on information received from the user's OAuth or SAML Identity Provider. To qualify for inclusion when a user or group is assigned the
Defer to Identity Provider role, a role or group name supplied by the Identity Provider must be an exact, case-sensitive match for a role or group name defined in your organization.
- If an OAuth Identity Provider defines the user, the user is assigned the roles named in the roles array of the user's OAuth token.
- If a SAML Identity Provider defines the user, the user is assigned the roles named in the SAML attribute whose name appears in the RoleAttributeName element, which is in the SamlAttributeMapping element in the organization's OrgFederationSettings.
Except the Defer to Identity Provider role, each predefined role includes a set of default rights. Only a System Аdministrator can modify the rights in a predefined role. If a System administrator modifies a predefined role, the modifications propagate to all instances of the role in the system.
Rights in Predefined Global Tenant Roles
GET https://cloud.example.com/api/admin/org/org-id/role/role-idYou can also use the adminRole query and filter on the organization UUID.
GET https://cloud.example.com/api/query?type=adminRole&format=records&filter=org==https://cloud.example.com/api/org/org-id
- In the top navigation bar, click Administration.
- From the left panel under Provider Access Control, select Roles.
- Click the name of the role you want to view.
Various rights are common to multiple predefined global roles. These rights are granted by default to all new organizations, and are available for use in other roles created by the Оrganization Аdministrator. For a list of the rights in predefined tenant roles, see #GUID-AE42A8F6-868C-4FC0-B224-87CA0F3D6350.