Skip to content

Tenant Roles and Role-Based Access Control

Tenant Roles provide centralized control over administrative permissions within Communication Services, letting organizations assign administrative access to users, groups, and service accounts while maintaining governance and security.

About Tenant Roles

Tenant Roles are managed centrally and apply across all Communication Services administration features. They let administrators view tenant-level role assignments, assign and update roles, remove role assignments, review current access permissions, and maintain governance and accountability.

Role Types

Tenant roles

RolePurposeTypical Responsibilities
Comms AdminCommunication Services administration and configuration.• Managing Contact Centers, Email Providers, Mailboxes, and Email Templates
• Sending test communications
• Monitoring communication activities
• Managing Tenant Roles
PII OfficerPrivacy, governance, and data protection oversight.• Reviewing communication activities
• Supporting privacy compliance initiatives
• Monitoring access to sensitive information
• Participating in governance processes

Note: A user, group, or service account may be assigned to one or both roles depending on business requirements.

Accessing Tenant Roles

  1. Navigate to Configurations.
  2. Select Tenant Roles.
  3. Review existing role assignments.

Tenant Roles page

Tenant Roles page

The page provides a consolidated view of all administrative role assignments, and includes tenant information, current role assignments, and controls to add, edit, and remove assignments.

Tenant information

InformationDescription
Tenant NameCurrent tenant
Tenant IDTenant identifier

Assigning Roles

Tenant Roles are assigned to Users, Groups, or Service Accounts, all shown in a single list, with the Roles column listing every role held (e.g. "Comms Admin" or "Comms Admin | PII Officer").

To create a role assignment:

  1. Open the Tenant Roles page and select Add Role Assignment.
  2. Select one or more users, groups, or service accounts.
  3. Select the required role(s): Comms Admin, PII Officer, or both.
  4. Save the configuration.

Adding a role assignment

Adding a role assignment

To edit a role assignment: locate the record, select Edit, update the assigned roles, and save.

Tenant roles query and response data shape

Tenant roles query and response data shape

To remove a role assignment: select Remove and confirm. Cancel abandons the operation; a failed removal leaves the assignment unchanged.

Read-Only Access

Users without sufficient administrative permissions may have read-only access: they can view existing assignments but cannot create, edit, or remove them. The application shows: "You do not have permission to update tenant roles."

Common Administrative Scenarios

Assigning a new administrator: open Tenant Roles, select Add Role Assignment, select the user, assign the Comms Admin role, and save — the user then receives access according to organizational policies.

Assigning a group: instead of assigning individual users, assign roles to a group so all members inherit the permissions — giving centralized management, simplified onboarding, and reduced administrative overhead.

Assigning multiple roles: a single user may hold more than one role, allowing them to perform multiple administrative responsibilities.

Error Handling

Common scenarios

ScenarioBehavior
Permission deniedError message displayed
Assignment cannot be savedChanges are not applied
Duplicate assignment attemptedValidation message displayed
Role information unavailableLoad error displayed
Network or service issueRetry option available

Best Practices

  • Apply the principle of least privilege — assign only the permissions required for a user's responsibilities.
  • Use groups where possible to simplify administration and reduce maintenance effort.
  • Review assignments regularly and remove access no longer required (e.g. when users change roles or leave).
  • Separate administrative responsibilities across multiple individuals rather than concentrating all permissions in one user.