Skip to content

Connect to your Azure App account with the Splunk Add-on for Microsoft Cloud Services

Connect between the Splunk Add-on for Microsoft Cloud Services and your Azure App account so that you can ingest your Microsoft Cloud Services data into the Splunk platform. You can configure this connection using Splunk Web on your data collection node, or using the configuration files. To create an Azure App account, you need a Global Administrator to grant you the permissions.

Prerequisites

Before you complete these steps, follow the directions in Configure an application in Microsoft Entra ID for the Splunk Add-on for Microsoft Cloud Services to prepare your Microsoft account for this integration.

Connect to your account using Splunk Web

Access Splunk Web on the node of your Splunk platform installation that collects data for this add-on.

  1. Launch the add-on, then select Configuration.
  2. Select Azure App Account > Add Azure App Account.
  3. Enter a friendly Name for the account.
  4. Select the Authentication Type you want to use, then enter the required fields using the following Account attributes table.
  5. Select Add.

Connect to your account using configuration files

If you do not have access to Splunk Web on your data collection node, you can configure the connection to your account using the configuration files.

  1. Create or open $SPLUNK_HOME/etc/apps/Splunk_TA_microsoft-cloudservices/local/mscs_azure_accounts.conf.
  2. Add a stanza that matches the authentication type you want to use.

For client secret authentication, use:

[<account_stanza_name>]
client_id = <value>
auth_type = client_secret
client_secret = <value>
tenant_id = <value>

For certificate authentication, use:

[<account_stanza_name>]
client_id = <value>
auth_type = client_certificate
certificate_private_key = <PEM bundle containing the certificate and private key>
certificate_password = <optional private key password>
tenant_id = <value>

If you are creating the PEM bundle or uploading the certificate credentials to Microsoft Entra ID, see Configure a certificate and private key to enable service-to-service calls.

Account attributes

Attribute Corresponding name in Splunk Web Description
account_stanza_name Name Enter a friendly name for your Azure app account. Account name cannot contain any whitespace.
client_id Client ID Use the Client ID that Microsoft Entra ID automatically assigned to your integration application
auth_type Authentication type Select client_secret for client secret authentication or client_certificate for certificate-based authentication. Default: client_secret
client_secret Key (Client Secret) Enter the password for Client ID. Required when auth_type is client_secret.
certificate_private_key Certificate (PEM) Enter the PEM bundle containing both the certificate and private key. Required when auth_type is client_certificate.
certificate_password Private Key Password (Optional) Enter the private key password if the PEM bundle is encrypted. Omit this field if the private key is not encrypted.
tenant_id Tenant ID Enter the Tenant ID when you Create an application in the Splunk add-on for Microsoft Azure