Overview

As part of its operation the OpenDNS Connector service syncs a list of users, groups and computers from Active Directory using the LDAP protocol.  This article describes how to check that the OpenDNS_Connector account has the correct permissions to read those objects.

Each object (users/groups/computers) in Active Directory has ACL security permissions associated with it, and each object must allow the OpenDNS_Connector user account to read its attributes.

Default permissions 

By default all authenticated users can read the properties of users/groups/computers, so the OpenDNS_Connector user does not require any extra permissions to do the LDAP sync.

 The default permissions are normally set as follows:

1)  The 'Pre-Windows 2000 Compatible Access' group is assigned read (read all properties) permissions on the domain for 'Descendant User Objects', 'Descendant Group Objects' and 'Descendant Computer Objects'. 

You can double-check this as follows:

• Open Active Directory Users and Computers
  
• Click on 'View' and check the 'Advanced Features' option.
• Right-click on the Domain object and select 'Properties' then 'Security > Advanced'
• Select the 'Pre Windows 2000 Compatible Access' entry with 'Special' permissions:
  
• Click 'Edit' to see these permissions in detail. 
• Select 'Descendant User objects' in the Applies to section
• Look for the following permissions:
  
  
• Repeat these steps for 'Descendant Group objects' and 'Descendant Computer objects'
  

2)  The All 'Authenticated Users' group is a member of 'Pre-Windows 2000 Compatible Access' group which provides the above settings to all users.

• Right-click on the Pre-Windows 2000 Compatible Access group, which is normally in the Builtin AD container. 
• Select 'Properties' and go to the 'Members' tab. 
• Check if 'Authenticated Users' is listed. 
  
  

However, in some AD environments this permissions model could have been changed and authenticated users may have been removed. This could manifest itself as some users being missing from the Umbrella Dashboard, or group memberships being incorrect. If this is the case, add the OpenDNS_Connector user to this group, restart the connector service and the missing items will show up in Umbrella. 

View effective access

You can use the Windows 'Effective Access' tool to see if the OpenDNS_Connector user is able to read a particular object which is missing (or which has incorrect group membership).

• Open Active Directory Users and Computers
  
• Click on 'View' and check the 'Advanced Features' option.
• Find the user object and right-click to select 'Properties'
• Go to the 'Security > Advanced > Effective Access' (note this may say 'Effective Permissions')
• Click on 'Select a user' then select the 'OpenDNS_Connector' user account.
• Click 'OK' then 'View Effective Access'
• Make sure the connector user is able to read all properties:
  

Setting OpenDNS_Connector LDAP permissions

The 'Delegate Control' wizard in AD is a quick way to assign the necessary permissions to the 'OpenDNS_Connector' user:

1) Go to Administrative Tools and open the Active Directory Users and Computers snap-in.
2) Right click on the domain that includes the OpenDNS_Connector and select "Delegate Control...", then click Next.  
3) Add the OpenDNS_Connector user, then click Next.  
4) Select "Read all user information" and click Next.  [See picture 3.]
7) Click Finish.  [See picture 6.]

Appendix:  userPerms script

 The attached powershell script is another method to get the permissions of a specific object (eg. user) in AD.  Please include the output of this script when contacting Umbrella Technical support.