Skip to content

This guide walks you through creating a Microsoft Entra application, assigning Azure RBAC roles for Network Watcher flow logs, and gathering the configuration needed to create an Azure Network Security integration with Synqly.

This provider currently supports flow logs written to Azure Blob Storage. Log Analytics destinations are not supported.

Prefer virtual network (VNet) flow logs for new setups. Network security group (NSG) flow logs are still readable when already configured, but Azure blocked creating new NSG flow logs as of June 30, 2025, and plans to retire them on September 30, 2027; migrate to VNet flow logs when possible. See Migrate from NSG flow logs to VNet flow logs.

Before you begin, ensure that you have:

  • Access to the Microsoft Entra admin center with the Application Developer role (or other permissions that allow creating an app registration)
  • Access to an Azure subscription with a Network Watcher and flow logs publishing to an Azure Storage account
  • Permission to assign Azure RBAC roles to a service principal

Required Permissions

PermissionPurpose
Microsoft.Network/networkWatchers/flowLogs/readDiscover Network Watcher flow log configurations
Storage Blob Data ReaderList and download flow log blobs from the destination storage account

Assign Reader (or a custom role that includes Microsoft.Network/networkWatchers/flowLogs/read) on the Network Watcher resource, resource group, or subscription, and assign Storage Blob Data Reader on the storage account or container that receives flow log data. Control-plane Reader on the storage account alone is not sufficient to download blobs.

Create an Entra Application and Service Principal

1. Create an application and service principal

  1. Sign in to the Microsoft Entra admin center with an account that can create app registrations.
  2. Go to Entra IDApp registrations, then select New registration.
  3. Enter a Name for the application.
  4. For Supported account types, choose Accounts in this organizational directory only (single tenant) unless you need a multi-tenant app. If you are unsure, choose the single-tenant option. For more information, see Tenancy in Microsoft Entra ID.
  5. Select Register.
  6. On the Overview page, copy the Application (client) ID and Directory (tenant) ID and store them in a safe location.

For more details, see Register an application with the Microsoft identity platform.

2. Create an application client secret

  1. In the app registration, go to Certificates & secretsClient secrets.
  2. Select New client secret, enter a description and expiration, then select Add.
  3. Copy the secret Value immediately and store it with the client ID and tenant ID. You will not be able to view the value again after you leave the page.

3. Assign Azure RBAC roles

Assign the roles from Required Permissions to the application's service principal.

Assign Reader on the Network Watcher scope:

  1. In the Azure portal, navigate to the Network Watcher resource (or the resource group or subscription that contains it).
  2. Go to Access control (IAM)+ AddAdd role assignment.
  3. Search for Reader, select it, and click Next.
  4. Click + Select members, add the application from step 1, and click Select.
  5. Click Review + assign.

Assign Storage Blob Data Reader on the flow log storage account:

  1. In the Azure portal, navigate to the storage account (or container) that receives Network Watcher flow logs.
  2. Go to Access control (IAM)+ AddAdd role assignment.
  3. Search for Storage Blob Data Reader, select it, and click Next.
  4. Click + Select members, add the application from step 1, and click Select.
  5. Click Review + assign.

For more details, see Assign Azure roles using the Azure portal.

4. Gather Network Watcher values

  1. In the Azure portal, navigate to your Network Watcher resource.
  2. On the Overview page, note the following values:
    • Subscription ID
    • Resource group
    • Name (Network Watcher name)

Configure the Integration

Create your integration by supplying the following values.

Integration ParameterDescription
Client IDThe Application (client) ID from the Entra app registration Overview page
Client SecretThe client secret Value from Certificates & secrets
Tenant IDThe Directory (tenant) ID from the Entra app registration Overview page
Subscription IDThe Azure subscription ID that contains the Network Watcher
Resource GroupThe Azure resource group name that contains the Network Watcher
Network Watcher NameThe name of the Network Watcher resource
Azure Cloud (optional)Microsoft cloud environment. public (default) or government
Traffic Log Configuration IDs (optional)Flow log short names or full ARM IDs ending in .../flowLogs/{name}. When omitted, all configurations discoverable by the Network Watcher are used