AAD - Azure Active Directory

[AAD]

Azure AD is the primary data source in SCA and integrates your organization’s user profiles to provide access to company-wide contacts. Contacts are queried via the Microsoft Graph API, and accounts are managed in your Microsoft Entra ID (Azure AD) tenant.

App Configuration Parameters

Defaults (SecContacts.Defaults):

• AAD_Enabled → Enables or disables the Azure AD data source.

• AAD_InitValue → Sets the default position of the user’s switch for this data source (on = shown, off = hidden) when SCA is first launched.

• AADuseUPNasEmail_Option → Determines whether to use User Principal Name (UPN) as the email address.

• AADonlyEnabledAccounts_Option → 🆕Filters contacts to include only enabled accounts.

Customization / Organization:

• SecContacts.AADGroups → Organize contacts into separate data sources based on Azure AD groups.

• SecContacts.CustomDatasourceNames → Assign friendly display names for the data source.

Requirements for Contacts

Any AAD contact to be shown in SCA must have the following three fields populated:

1. First name

2. Last name

3. Valid phone number

Note: Every AAD account in your tenant that meets these requirements will appear as a contact in SCA. Only Member accounts are included; Guest accounts are ignored.

• Each data source, including AAD, can be hidden by the user if they do not want to see or use it.

• Hiding a data source does not affect Caller Identification — contacts from hidden sources will still resolve incoming calls.

• Use AADGroups to split contacts into multiple separate data sources (e.g., by department, region, or team).