Configuring Custom Attributes in Entra ID for Everbridge Integration

Description

When integrating Everbridge with Entra ID, you can add custom attributes to the synchronization of contact data. This process often involves using the onPremisesExtensionAttributes section to include additional information, such as location-based attributes, and may also include other Entra ID properties (for example, manager, business phone, or department).

Steps to Add Custom Attributes

To add custom attributes in the Entra ID integration with Everbridge:

1. Navigate to the Expand Attributes (or custom attributes) section in your Entra ID integration settings in the Everbridge Manager Portal.

2. Locate the onPremisesExtensionAttributes section, or the section where you define additional Entra ID / Microsoft Graph properties.

3. Add the desired custom attribute using the appropriate syntax and exact Microsoft Graph property name (for example, onPremisesExtensionAttributes.extensionAttribute3, businessPhones, department, jobTitle, or a simple manager property like manager.displayName).

4. Use the integration preview/test file to confirm that the new attributes are being returned before running a full sync.

Syntax for Custom Attributes

When adding a custom attribute from onPremisesExtensionAttributes, use the following format:

attributeName:number

For example, to add a location-based attribute like itLocationCode, use:

iTLocationCode:1

The number after the colon indicates how many of the attribute's items you want to select and sync.

Attribute/property names are case sensitive. Make sure you use the exact casing used by Microsoft Graph (for example, businessPhones, department, jobTitle). Incorrect casing or spacing (for example, an extra space after a comma in the list of attributes) can prevent that specific attribute from populating in Everbridge.

Location of Custom Attribute Configuration

Custom attributes should be added in the Expand Attributes (custom attributes) section of your Entra ID integration settings in the Everbridge Manager Portal. This is where you'll find (or define) the onPremisesExtensionAttributes section and any additional Microsoft Graph properties for configuring these fields.

Selecting and Syncing Custom Attributes

By adding custom attributes in this manner, you can select and sync specific attributes from the user entity during the integration process.