Skip to content

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 TypeDescription
UserIndividual directory account
GroupDirectory security or administration group
Service AccountNon-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

InformationDescription
Display NameUser's name
User IDUnique identifier
Email AddressPrimary email address
StatusActive 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

RolePurpose
OwnerOverall administrative responsibility
ManagerManagement oversight
SupervisorOperational control
AgentCommunication 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 TypeDescription
OwnerFull mailbox management
SenderAuthorized to send messages
ViewerRead-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

ScenarioRecommended Action
User cannot be foundVerify the user exists in the organizational directory
Group not visibleConfirm the group has been created and synchronized
Access not appliedReview role assignments and group membership
Ownership not displayedConfirm directory information is available
Search returns no resultsVerify search criteria and available permissions