Configure Azure Active Directory Users inputs for the Splunk Add on for Microsoft Azure

Note

Azure Active Directory has been renamed to Microsoft Entra ID.

Before you enable inputs, complete the previous steps in the configuration process:

• Create an Azure AD App Registration
• Connect to your Azure Account with Splunk Add-on for Microsoft Azure

Configure your inputs on the Splunk platform instance responsible for collecting data for this add-on, usually a heavy forwarder. You can configure inputs using Splunk Web, which is a best practice, or by using the configuration files.

Data Collected

Azure Active Directory (Azure AD) user account objects.

Required Microsoft API Permissions

API	Permissions
Microsoft Graph	(Application) User.Read.All

Configure inputs using Splunk Web

Configure your inputs using Splunk Web on the Splunk platform instance responsible for collecting data for this add-on, usually a heavy forwarder.

1. In the Splunk Add-on for Microsoft Azure, click Inputs.
2. Click Create New Input and then select Azure Active Directory Users.
3. Enter the Name, Interval, Index, Azure App Account, Tenant ID, Environment, and other parameters using the information in the input parameter table below.

Configure inputs using configuration files

Configure your inputs using the configuration files on the Splunk platform instance responsible for collecting data for this add-on, usually a heavy forwarder.

1. Create or modify a file named inputs.conf under $SPLUNK_HOME/etc/apps/TA-MS-AAD/local.
2. Add the following stanza:

[MS_AAD_user://<input_stanza_name>]
azure_app_account = <value>
endpoint = <value>
environment = <value>
index = <value>
interval = <value>
tenant_id = <value>
user_sourcetype = <value>

3. Save and restart the Splunk platform.

Verify that the value listed for azure_app_account matches the account entry in ta_ms_aad_account.conf.

Input Parameters

Each attribute in the following table corresponds to a field in Splunk Web.

Attribute	Corresponding field in Splunk Web	Description
[MS_AAD_user://input_stanza_name]	Name	A friendly name for your input.
azure_app_account	Azure Account	The Azure App account from which you want to gather data.
endpoint	Endpoint	The Microsoft Graph endpoint used to retrieve data. Valid options are v1.0 and beta
environment	Environment	The Azure environment. Valid options are public and gov.
tenant_id	Tenant ID	The Azure Active Directory Tenant ID (a.k.a. Directory ID)
user_sourcetype	User Sourcetype	The sourcetype to use for this input.
filter	Query Parameters (optional)	OData parameters.
interval	Interval	The number of seconds to wait before the Splunk platform runs the command again.
index	Index	The index in which to store Azure data.