Desired State Configuration

The Desired State Configuration page allows you to define and manage expected configurations for various objects within the environment. This ensures that critical settings remain consistent and compliant with organizational policies.

Configuration Options

  • Object Type: Select the type of object to be configured. At this time, Active Directory and Entra ID groups are supported.

Active Directory

  • Search: Find specific objects within the selected type. This will pre-populate the Domain and Identifier fields.
  • Domain: Specify the domain associated with the object.
  • Tenant ID: Specify the tenant GUID with the object.
  • Identifier: Enter the distinguishedName for the group.
  • Attributes: Define key attributes to monitor. At this time, only member is supported and will be automatically selected.
  • Credential: Assign a credential for authentication, if necessary. If automatic rollback is enabled, this credential must have sufficient permission to modify the selected attributes.

Entra ID

  • Search: Find specific objects within the selected type. This will pre-populate the TenantID and Object ID fields.
  • Tenant ID: Specify the tenant GUID with the object.
  • Object ID: Enter ID (guid) for the group.
  • Attributes: Define key attributes to monitor. At this time, only members is supported and will be automatically selected.
  • Credential: Assign a credential for authentication, if necessary. If automatic rollback is enabled, this credential must have sufficient permission to modify the selected attributes.

Notification and Rollback Options

  • Automatically rollback changes: Enable this to revert any unintended modifications.
  • Send email notification on deviation: Receive alerts when an object deviates from its desired state.
  • Send email notification after rollback: Get notified when automatic rollback occurs.
  • Email Recipients: Specify recipients who should receive notifications.

Saving the Configuration

After filling in all required fields, click Save to apply the configuration. The system will use the current state as the expected configuration and will alert you if it deviates.


Entra ID Permissions Requirements

When configuring Entra ID operations within the system, you must register an Entra ID application in your tenant for use as the credentials. This application requires specific API permissions to enable directory and group-related actions.

Minimum Required Permissions

To enable standard read operations (such as viewing users, groups, and memberships), the application must be granted the following Microsoft Graph application permissions:

  • Directory.Read.All
  • Group.Read.All
  • GroupMember.Read.All

These permissions allow the application to:

  • Access directory data
  • Read group properties and memberships
  • Query group membership for users and devices
Note: These must be application (not delegated) permissions and must be granted admin consent.

Permissions for Automatic Rollback

If your environment uses automatic rollback, the required permissions change from read-only to read-write. In this case, the Entra ID application must be granted the following permissions:

  • Directory.ReadWrite.All
  • Group.ReadWrite.All
  • GroupMember.ReadWrite.All

These elevated permissions are necessary to:

  • Restore modified directory objects
  • Recreate or delete group memberships during rollback operations
Security Tip: Ensure that these permissions are carefully controlled and only assigned when automatic rollback functionality is explicitly needed.