Netskope Help

Configure an Azure AD Application for CSA

To configure Azure for Security Assessment, you must log in to the Azure portal as a subscription owner or global administrator and configure the following tasks:

Step-1: Create an Azure AD Application

To create an Azure AD application, follow the steps below:

  1. Log in to portal.azure.com.

  2. Navigate to All services > Identity > Azure Active Directory.

  3. Click App registrations.

    Azure-AD-App_App-Regis.png
  4. Click + New registration and enter the following details:

    1. Name: Enter the name of the application.

    2. Supported account types: Keep the default selection to Accounts in this organizational directory only.

    3. Redirect URL (optional): Leave this blank.

    Azure_Regis-App.png
  5. Click Register.

For additional information, refer to the Microsoft Azure documentation located here.

Step-2: Get the Application ID and Directory ID

After registering the Azure AD application, the page redirects you to the Azure AD application Overview page. Note down the Application (client) ID and Directory (tenant) ID.

Azure_App-ID_Dir-ID.png

Note

These values will be required when you set up the Azure application instance in the Netskope UI.

Step-3: Get the Authentication Key

To get the authentication key, follow the steps below:

  1. On the left navigation bar of the Azure AD application page, click Certificates & secrets.

  2. Under Client secrets, click + New client secret and enter the following details:

    1. Description: Provide a description of the key.

    2. Expires: Set a duration for the key.

  3. Click Add.

    Azure_Setup-Auth-Key.png
  4. After you save the configuration changes, under Client secrets, the right-most column contains the authentication key. Copy the key value.

    Azure_Copy-Key-Value.png

    Important

    Ensure that you copy the key value as it is not accessible once you leave this page. The key value will be required when you set up the Azure application instance in the Netskope UI.

For additional information, refer to the Microsoft Azure documentation located here.

Step-4: Assign a Role to the Azure AD Application

To assign a role, follow the steps below:

  1. Log in to portal.azure.com.

  2. Navigate to All services > General > Subscriptions.

    Azure_All-serv_General_Subscrip.png
  3. On the Subscriptions page, click the appropriate subscription from the list.

  4. Click + Add > Add role assignment.

    Azure_Subscrip_Assign-Role.png

    To perform continuous security assessment of your Azure infrastructure, create a custom role with the following permissions.

    • Microsoft.Network/networkWatchers/queryFlowLogStatus/action - This permission gets the status of flow logging on a resource.

    • Microsoft.Web/sites/config/list/action - This permission lists web apps' security sensitive settings, such as publishing credentials, app settings and connection strings.

    Important

    If you are configuring a combination of features such as CSA, DLP, Threat Protection, and Forensics in a single instance, then you must create separate custom roles for each feature. For a combination of feature support, assign the roles based on the table below:

    Feature/Role

    Reader + Custom

    Inbuilt Contributor

    Storage Account Contributor

    DLP

    X

    X

    Threat Protection

    X

    X

    Security Assessment

    X

    X

    Forensic

    X

    X

    X

    DLP, Security Assessment

    X

    X

    DLP, Forensic

    X

    X

    Threat Protection, Security Assessment

    X

    X

    Threat Protection, Forensic

    X

    X

    Security Assessment, Forensic

    X

    X

    DLP, Threat Protection, Security Assessment, Forensic

    X

    X

    To create a custom role,

    1. Create a JSON file with the following script and save the file as NetskopeCSA.json.

      {
        "Name": "Netskope CSA Custom Role",
        "IsCustom": true,
        "Description": "Netskope CSA",
        "Actions": ["Microsoft.Web/sites/config/list/action", "Microsoft.Network/networkWatchers/queryFlowLogStatus/action"],
        "NotActions": [],
        "DataActions": [],
        "NotDataActions": [],
        "AssignableScopes": ["/subscriptions/<subscription-id>"]
      }

      To get the <subscription-id>:

      1. Navigate to All services > General > Subscriptions.

      2. Copy the subscription ID and replace the <subscription-id> parameter with the copied ID.

    2. Next, use the Azure PowerShell. Click the Cloud Shell icon on the top-center bar of the Azure portal page.

      Note

      The shell may prompt you to create and mount a storage account.

    3. On the PowerShell top navigation, select the Upload/Download files icon and then Upload.

      Azure_PowerShell.png
    4. Upload the NetskopCSA.json file. Then, on the PowerShell prompt, enter the following command:

      New-AzRoleDefinition -InputFile "NetskopeCSA.json"

      When you run this command, Azure creates a custom role Netskope CSA Custom Role with the Microsoft.Network/networkWatchers/queryFlowLogStatus/action and Microsoft.Web/sites/config/list/action permissions.

    5. Under Roles, assign the Reader and Netskope CSA Custom Role.

      Note

      If you have multiple subscriptions, you can group them under a Management Group and assign the role at the Management Group.

      Note

      As part of continuous security assessment, if you need Netskope to assess Key Vault, read this.

    6. Keep the Assign access to Azure AD user, group, or service principal.

    7. Under Select, search for the newly created Azure AD application and select it.

      Azure_Add-Role.png
    8. Click Save.

  5. Click Access control (IAM).

For additional information, refer to the Microsoft Azure documentation located here.

Step-5: List AD Users (CSA only)

Note

This procedure applies to continuous security assessment only.

For Netskope to list the AD users, you should grant the Directory.Read.All permission. To do so, follow the instructions below:

  1. Navigate to All services > Identity > Azure Active Directory.

  2. Click App registrations.

    Azure-AD-App_App-Regis.png
  3. Locate the Azure AD application you created earlier and click it.

  4. On the left navigation bar of the Azure AD application page, click API permissions.

  5. Under API permissions, click + Add a permission.

    Azure_Add-API-Perm.png
  6. Under Request API permissions, keep the Microsoft APIs tab selected. Scroll down and under Supported legacy APIs, select Azure Active Directory Graph.

    Azure_AD-Graph-API.png
  7. Under Azure Active Directory Graph, select Application permissions and under Directory, select Directory.Read.All permission. Click Add permissions.

    Azure_Direc-Read-All.png
  8. On the API permissions page, click Grant admin consent for Default Directory and then click Yes.

    Azure_Grant-Admin-Cons.png
Step-6: Assess Key Vault (CSA only)

Note

This procedure applies to continuous security assessment only.

As part of continuous security assessment, if you need Netskope to assess Key Vault, follow the instructions below:

Configure Access Policy on Key Vault
  1. Navigate to All services > Security > Key vaults.

  2. For each key vault, do the following:

    1. Click on a key vault, navigate to Access policies, and click + Add new.

      Azure_Key-Vault-Access-Policy.png
    2. Under Add access policy, enter the following:

      1. Select principal: Select the Azure AD application you created earlier.

      2. Key permissions: Select Key Management Operations > List.

      3. Secret permissions: Select Secret Management Operations > List.

      4. Certificate permissions: Select Certificate Management Permissions > List.

      5. Click OK.

      Azure_Key-Vault-Add-Access-Policy.png
    3. On the Access policies page, click Save.

      Azure_Key-Vault-Access-Policy-Save.png