Directory Integration¶
Directory Integration lets Communication Services Administration securely retrieve and manage users, groups, and access assignments from the organization's identity management system, instead of maintaining user information separately.
Benefits¶
- Centralized identity management and simplified administration
- Consistent security governance and reduced duplication of user information
- Improved access management, aligned with existing organizational identity processes
Identity Types¶
Supported identity types
| Identity Type | Description |
|---|---|
| User | Individual directory account |
| Group | Directory security or administration group |
| Service Account | Non-interactive system account used for integrations and automation |
Different identity types may be assigned to Tenant Roles and Contact Center roles depending on business requirements.
User Management¶
Users may be assigned to Tenant Roles, Contact Center roles, Mailbox access roles, or administrative ownership assignments — for example, communication administrators, support personnel, supervisors, and managers.
When assigning permissions or ownership, administrators search for and select users from the directory. User information may include:
User information
| Information | Description |
|---|---|
| Display Name | User's name |
| User ID | Unique identifier |
| Email Address | Primary email address |
| Status | Active directory account |
Group Management¶
Groups let administrators assign permissions to multiple users at once, representing common responsibilities (e.g. Communication Administrators, Customer Support Team, Service Desk Supervisors, Finance Communications). When a group is assigned a role, its members inherit the associated permissions — simplifying administration, ensuring consistent permission assignment, and streamlining onboarding.
Example: all members of the Communication Administrators group receive the permissions associated with the Comms Admin role.
Identity Assignment and Ownership¶
Ownership can be assigned to individual users or to groups; using groups is generally recommended, as it simplifies ongoing access management.
Contact Center roles
| Role | Purpose |
|---|---|
| Owner | Overall administrative responsibility |
| Manager | Management oversight |
| Supervisor | Operational control |
| Agent | Communication operations |
Email Provider ownership derives from the owning Contact Center's role assignments and directory identities, keeping management responsibilities clearly defined and auditable.
Mailboxes may be assigned to specific users or groups, selected directly from the directory. Typical mailbox access types:
Mailbox access types
| Access Type | Description |
|---|---|
| Owner | Full mailbox management |
| Sender | Authorized to send messages |
| Viewer | Read-only visibility |
Searching for Users and Groups¶
Typical search attributes: user name, group name, email address, or identifier. Search results are presented for selection within the relevant administration page.
Managing Changes in the Directory¶
Directory information changes as users join, leave, transfer departments, or change group membership or administrative roles. Administrators should periodically review Communication Services access assignments to keep them aligned with organizational responsibilities.
Recommended governance practices:
- Use groups rather than individual users where possible.
- Review access regularly and remove access that is no longer required.
- Maintain clear, defined ownership for every Contact Center and communication resource.
Security benefits include centralized authentication management, consistent identity governance, reduced administrative overhead, improved auditability, and alignment with organizational security policies. Administrators should continue to follow organizational security standards when granting permissions and assigning administrative roles.
Troubleshooting Directory Integration¶
Common issues
| Scenario | Recommended Action |
|---|---|
| User cannot be found | Verify the user exists in the organizational directory |
| Group not visible | Confirm the group has been created and synchronized |
| Access not applied | Review role assignments and group membership |
| Ownership not displayed | Confirm directory information is available |
| Search returns no results | Verify search criteria and available permissions |