Skip to main content

User Active Directory datasource

User Active Directory datasources allow you to fetch and display employee information from Microsoft Active Directory, including user profiles, organizational structure, presence status, and profile pictures. This integration provides access to your organization's directory information for employee displays, organizational charts, and user status boards.

Prerequisites​

Before creating a User Active Directory datasource, ensure you have:

  • Microsoft credential with User Active Directory scope configured
  • Appropriate permissions to access organizational directory information
  • Understanding of your organization's Active Directory structure
  • Knowledge of which user information you want to display
  • Compliance with privacy policies regarding employee data display
  • Admin consent for the application if required by your organization
  • Network access to Microsoft Graph API endpoints
Microsoft Graph Integration

User Active Directory datasources leverage Microsoft Graph API for directory access. Ensure your Microsoft credential is properly configured with appropriate permissions and admin consent. Check with your IT administrator if you encounter permission-related errors.

Create datasource​

Go to Settings > Datasources and open the External Datasources tab. Click Add external datasource, then on the Choose a datasource type screen select User Active Directory.

Basic Configuration​

1. Microsoft Credential Selection Select a Microsoft credential with User Active Directory scope:

  • Choose from available Microsoft credentials configured in Cloud Credentials
  • Credential must include User Active Directory permissions
  • Verify the credential has proper admin consent if required
  • Ensure the credential account has directory read permissions

2. Profile Picture Select if you want to fetch profile pictures of users or not

3. Scope and User Filtering Select if Only internal members should be included in the filtering

Filter which users to include in the directory data by:

  • Name
  • Department name
  • Job title
  • Manager name
  • Manager job title
  • Manager department name
  • Office location
Directory Filtering Best Practices

Consider privacy and relevance when filtering directory data. Display only information appropriate for the viewing audience and location. Lobby displays might show general contact information, while department displays can include more detailed organizational data.

Advanced Configuration Options​

4. Advanced settings The caching options are explained in Refresh and caching. Active, Continue refreshing despite errors, Connection settings and shuffling lists (Process and filter data) are explained in Advanced datasource settings.

5. Update Schedule Set how often the datasource updates under Refresh settings: a Simple interval or an Advanced schedule (cron). Learn more: Refresh and caching

Directory Update Frequency

Employee directory information typically changes less frequently than other data sources. Daily or even weekly updates are often sufficient unless your organization has high employee turnover or frequently changing organizational structure. Consider privacy implications of real-time presence data.

6. Save Configuration After configuring credential, filtering, and privacy settings, click Save to create the datasource.

Directory Datasource Testing

After saving, verify the directory data preview shows expected users with appropriate information. Test filtering settings to ensure only intended user data is included. Verify profile images are loading correctly.