Setting Up a Service Account

You need a service account to collect log data for InsightIDR. However, the account you use must meet specific requirements to work with InsightIDR.

You can designate an existing user account, or create a service account, that meets all of the following requirements:

Active Directory Permissions

The Active Directory event source collects the domain controller security log, so your service account must be a domain account that is member of the Domain Admins group.

Alternatives to Domain Admin Accounts

If you do not want to add the service account to the Domain Admins group, there are three options you can employ:

  • Insight Agent
  • NXLog
  • Non-Admin Domain Controller Account

Insight Agent

You can install the Insight Agent on each domain controller, which is the preferred alternative to providing a Domain Admin account. If you decide to install the Insight Agent on your domain controllers, you do not need to create a domain account in the Domain Admins group.

You must create a Support case to request that the Insight Agent collect the logs.

Verify your configuration

  1. From the left menu, click Log Search to view your raw logs to ensure events are making it to the Collector. Search and filter on the logsets for all Endpoint Agent Logs which are located under Active Directory Admin Activity, Asset Authentication and Host to IP Observations.
  2. Run the query where(source_json.isDomainController=true)groupby(source_json.computerName) to filter only on Domain Controllers and return a grouping by Domain Controller.
  3. Verify that you can see parsed events for Domain Controllers coming through.

NXLog

If you do not want to use the Insight Agent, using NXLog is the next preferred alternative. Learn how to use NXLog to collect security log events.

Non-Admin Domain Controller Account

Lastly, you can create a Non-Admin domain controller account. Note that Rapid7 does not support this method.

LDAP Permissions

The collection of the LDAP event sources requires a domain account with read permissions to all users and groups in the domain.

Microsoft DNS Permissions

The Microsoft DNS event source requires that you use a service account that is a domain account with read permissions to the DNS audit trail written to the share of each DNS server.

When you configure logging in the DNS Management tool, you must specify where you want the log to go. Then you must manually create a folder for the log and place it there. You can name the log file anything you want during its configuration. To grant read permissions, create a file share and grant the service account access to the file share and the NTFS file system.

See DNS for more information.

Microsoft DHCP Permissions

The Microsoft DHCP event source requires that you use a service account with read permissions to collect log files, located by default here: C:\Windows\system32\dhcp.

To grant read permissions, create a file share and grant the service account access to the file share and the NTFS file system.

If you choose to collect DHCP logs from the default path, you must use the Pattern Match field and use DhcpSrvLog*.log as the pattern match. However, you can move the DHCP logs to a different location if it is more convenient. See Microsoft DHCP for more information.

Create a File Share

You can enable file sharing on Windows machines to share folders and disk volumes. The following are the three ways to enable a file share:

Create a File Share with Windows File Explorer

To enable file share using Windows File Explorer:

  1. Find the folder you want to share and right click it.
  2. Select Properties from the menu.
  3. Click the Advanced Sharing button.
  4. Select the “Share This Folder” box.
  5. Click the Permissions button.
  6. Select the users or groups who will have access to this folder. By default, the “Everyone” group has read access.
  7. After you select all users and groups that need access to the shared folder, select the Full Control option under the “Allow” column.
  8. Click OK.

Create a File Share with PowerShell

PowerShell is a command line shell for tasks and scripting languages.

To grant file share permissions with PowerShell:

  1. Open PowerShell as an Administrator.
  2. Run the command New-SmbShare -Name scripts -Path 'E:scripts' -FullAccess Everyone to grant all users access to the shared folder(s).

Create a File Share with Server Manager

If you have the File Server role installed, you can use PowerShell or a similar tool to apply the proper permissions on the Server Manager.

To grant file share permissions in Server Manager:

  1. In PowerShell, run Get-WindowsFeature -Name FS-FileServer to confirm that Windows has the file server role. If it does not, install it with the command Install-WindowsFeature -Name FS-FileServer -IncludeAllSubFeature -IncludeManagementTools.
  2. Open Server Manager.
  3. Select Files and Storage Services > Shares.
  4. On the right hand side, click the Shares dropdown and select New Share.
  5. When the New Share Wizard appears, choose a file share profile.
  6. Complete the File Share Wizard to create the file share.

Endpoint Monitor

See Endpoint Monitor for more information.