Netskope LogoNetskope Logo
  • Security Services
  • AI Services
  • Networking Services
  • Analytics Services
  • Integrations
  • getting-started.svgGetting Started
    • Support
    • Community
    • Netskope.com
    © 2026 All Rights Reserved. Netskope Inc.
    Home
    Netskope Cloud Exchange
    Threat Exchange Module
    Configure 3rd-party Threat Exchange Plugins
    Microsoft Defender Threat Intelligence Plugin for Threat Exchange

    Microsoft Defender Threat Intelligence Plugin for Threat Exchange

    Release Notes

    1.0.0

    Added

    • Initial Release.
    • Fetch Indicators of type URL (Hostnames and IP Addresses) from the Threat Intelligence Profile along with their reputation. This plugin does not support pushing indicators to Microsoft Defender Threat Intelligence platform.

    This document explains how to configure the Microsoft Defender Threat Intelligence v1.0.0 plugin for the Threat Exchange module of the Netskope Cloud Exchange platform. This plugin is used to pull indicators of type URLs (Hostnames and IP Addresses) from Microsoft Defender Threat Intelligence platform from the Intelligence Profiles. The Plugin does not support sharing indicators to Microsoft Defender Threat Intelligence platform.

    Prerequisites

    To complete this configuration, you need:

    • A Netskope Tenant (or multiple, for example, production and development/test instances).
    • A Netskope Cloud Exchange tenant with the Tenant plugin and Threat Exchange plugin already configured.
    • An Application created on the Microsoft Identity platform, and it’s Tenant ID, Client ID, and Client Secret.
    • Connectivity to Microsoft Identity platform.
    Microsoft Defender Threat Intelligence Plugin Support

    This plugin is used to pull indicators of type URLs (Hostnames and IP Addresses) from the Microsoft Defender Threat Intelligence platform from the Intelligence Profiles. The Plugin does not support sharing indicators to the Microsoft Defender Threat Intelligence platform.

    Fetched Indicator TypesShared Indicator Types
    URL (Hostnames, IP Address)Not Supported

    Note

    • Only those Intelligence profiles will be fetched whose kind is actor.
    • Kind: A categorization of the type of this intelligenceProfile. The possible values are: actor, tool, unknownFutureValue.
    Mappings
    Pull Mapping
    Cloud Exchange FieldsMicrosoft Defender Threat Intelligence Fields
    valueartifact.id from List indicators response
    typeURL (static)
    firstSeenfirstSeenDateTime
    lastSeenlastSeenDateTime
    reputationscore from Get hostReputation response
    tagsclassification from Get hostReputation response
    commentstradecraft.content from List Intelligence Profile

    The fields selected based on the description of the fields available in the platform are:

    • Tradecraft: Formatted information featuring a description of the distinctive tactics, techniques, and procedures (TTP) of the group, followed by a list of all known custom, commodity, and publicly available implants used by the group.
    • Reputation is mapped with score: The score can range from 1-100, so the mapping of the score provided is using the following: normalized_score = round (score / 10). iIf the score is between 0-100, it will be considered as 1.
    Permissions

    ThreatIntelligence.Read.All (*attached to the Application whose Client Credentials are used).*

    API Details
    List of APIs used
    API EndpointMethodUse case
    <TENANT_ID>/oauth2/tokenPOSTGenerate Auth Token
    /security/threatIntelligence/intelProfilesGETFetch Intelligence Profiles
    /security/threatIntelligence/intelProfiles/<INTEL_PROFILE_ID>/indicatorsGETFetch Indicator from a single Intelligence Profile
    /security/threatIntelligence/hosts/<HOST_ID>/reputationGETFetching Reputation for a single indicator

    Note

    • The List intelProfiles used in the plugin only supports Global Service as the National Cloud Deployments, and the plugin supports only the below Base Endpoint: https://login.microsoftonline.com. This is used for Generating the Authorization Token.
    • Microsoft Graph APIs Base URL for v1.0: https://graph.microsoft.com/v1.0
    Get Auth Token

    Endpoint: <TENANT_ID>/oauth2/token

    Method: POST

    Data

    KeyValue
    scopehttps://graph.microsoft.com/.default
    client_id<CLIENT_ID>
    client_secret<CLIENT_SECRET>
    grant_typeclient_credentials

    Headers

    KeyValue
    User-Agentnetskope-ce-5.0.0-cte-microsoft-defender-threat-intelligence-v1.0.0
    Content-Typeapplication/x-www-form-urlencoded
    Acceptapplication/json

    Sample Response

    {
      "token_type": "Bearer",
      "expires_in": 3599,
      "ext_expires_in": 3599,
      "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsIng1dCI6Ik1uQ19WWmNBVGZNNXBP..."
    }
    Fetching Intelligence Profile

    Endpoint: /security/threatIntelligence/intelProfiles

    Method: GET

    Parameters

    KeyValue
    $filterfirstActiveDateTime ge <checkpoint>
    $selectid,tradecraft,kind
    $top100

    Headers

    KeyValue
    User-Agentnetskope-ce-5.0.0-cte-microsoft-defender-threat-intelligence-v1.0.0
    AuthorizationBearer <ACCESS_TOKEN>
    Content-Typeapplication/json

    Sample Response

    HTTP/1.1 200 OK
    Content-Type: application/json
    
    {
      "value": [
        {
          "@odata.type": "#microsoft.graph.security.intelligenceProfile",
          "id": "9b01de37bf66d1760954a16dc2b52fed2a7bd4e093dfc8a4905e108e4843da80",
          "kind": "actor",
          "title": "Aqua Blizzard",
          "firstActiveDateTime": "2020-02-24T00:00:00Z",
          "aliases": [
              "Primitive Bear",
              "ACTINIUM",
              "SectorC08",
              "shuckworm",
              "Gamaredon",
              "UNC530",
              "Armageddon"
          ],
          "targets": [
              "Government Agencies & Services: Defense",
              "Government Agencies & Services: Law Enforcement",
              "Non-Government Organization: Human Rights Organization"
          ],
          "countriesOrRegionsOfOrigin": [
            {
              "@odata.type": "microsoft.graph.security.intelligenceProfileCountryOrRegionOfOrigin",
              "label": "Country/Region",
              "code": "Country/Region code"
            }
          ],
          "summary": {
            "@odata.type":"microsoft.graph.security.formattedContent",
            "content": "The actor that Microsoft tracks as Aqua Blizzard (ACTINIUM) is
    a nation-state activity group based out of ...",
            "format": "text"
          },
          "description": {
            "@odata.type": "microsoft.graph.security.formattedContent",
            "content": "## Snapshot\r\nThe actor that Microsoft tracks as Aqua Blizzard (ACTINIUM) is a nation-state activity group based out of ...",
            "format": "markdown"
          },
          "tradecraft": {
            "@odata.type": "microsoft.graph.security.formattedContent",
            "content": "Aqua Blizzard (ACTINIUM) primarily uses spear phishing emails
    to infect targets. These emails harness remote template injection to
    load malicious code or content. Typically, ...",
            "format": "markdown"
          }
        }
      ]
    }
    
    Fetch Indicator from a single Intelligence Profile

    Endpoint: /security/threatIntelligence/intelProfiles/<INTEL_PROFILE_ID>/indicators

    Method: GET

    Data: NA

    Headers

    KeyValue
    User-Agentnetskope-ce-5.0.0-cte-microsoft-defender-threat-intelligence-v1.0.0
    AuthorizationBearer <ACCESS_TOKEN>
    Content-Typeapplication/json

    Sample Response

    HTTP/1.1 200 OK
    Content-Type: application/json
     
    {
      "value": [
        {
          "@odata.type": "#microsoft.graph.security.intelligenceProfileIndicator",
          "id": "ff3eecd2-a2be-27c2-8dc0-40d1c0eada55",
          "source": "microsoft",
          "firstSeenDateTime": "2022-05-02T23:09:20.000Z",
          "lastSeenDateTime": null,
          "artifact": {
              "@odata.type": "#microsoft.graph.security.hostname",
              "id": "fake-malicious.site"
          }
        }
      ]
    }
    artifact.id will be fetched as the indicator value
    Fetching Reputation for a Single Indicator

    Endpoint: /security/threatIntelligence/hosts/<HOST_ID>/reputation

    Method: GET

    Data: NA

    Headers:

    KeyValue
    User-Agentnetskope-ce-5.0.0-cte-microsoft-defender-threat-intelligence-v1.0.0
    Content-Typeapplication/x-www-form-urlencoded
    Acceptapplication/json

    Sample Response

    HTTP/1.1 200 OK
    Content-Type: application/json
     
    {
        "@odata.type": "#microsoft.graph.security.hostReputation",
        "id": "1e3b9ded-abb6-1828-c4ef-a5ca48b287a0",
        "classification": "malicious",
        "score": 100,
        "rules": [
          {
            "name": "Microsoft Defender Threat Intelligence Intel Article",
            "description": "Activity Snapshot: DPRK Actors Target Maritime Sector",
            "severity": "high",
            "relatedDetailsUrl": "https://ti.defender.microsoft.com/article/831b70a4"
          },
          {
            "name": "Name server",
            "description": "Domain is using a name server that has been associated with suspicious behavior",
            "severity": "medium",
            "relatedDetailsUrl": null
          },
          {
            "name": "Registrar",
            "description": "Domains registered using this registrar are frequently associated with suspicious behavior",
            "severity": "medium",
            "relatedDetailsUrl": null
          },
          {
            "name": "Resolving IP Address",
            "description": "192.168.1.1",
            "severity": "low",
            "relatedDetailsUrl": "https://ti.defender.microsoft.com/search?query=192.168.1.1"
          }
      ]
    }
    User Agent

    netskope-ce-5.0.0-cte-microsoft-defender-threat-intelligence-v1.0.0

    Workflow
    1. Generate configuration parameter.
    2. Configure the Netskope Tenant
    3. Configure the Netskope CTE plugin
    4. Configure the Microsoft Defender Threat Intelligence plugin
    5. Add Business Rule
    6. Add Sharing

    Generate the Configuration Parameter on the Microsoft Identity Platform

    Follow the steps provided in the links to generate the necessary plugin credentials.

    • Register the Application:
      • https://learn.microsoft.com/en-us/graph/auth/auth-concepts#register-the-application
      • https://learn.microsoft.com/en-us/graph/auth-register-app-v2
    • Add Client Secret: https://learn.microsoft.com/en-us/graph/auth-register-app-v2#option-2-add-a-client-secret
    • Configure Permissions for Microsoft Graph: https://learn.microsoft.com/en-us/graph/auth-v2-service?tabs=http#2-configure-permissions-for-microsoft-graph
    • Permission needed: ThreatIntelligence.Read.All
    • Request administrator consent: https://learn.microsoft.com/en-us/graph/auth-v2-service?tabs=http#3-request-administrator-consent

    Configure the Microsoft Defender Threat Intelligence Plugin

    1. In Cloud Exchange, go to Settings > Plugin Store.

    2. Search for and select the Microsoft Defender Threat Intelligence v1.0.0 (CTE) plugin.

    3. Enter the Basic Information:

      • Configuration Name: Unique name for the configuration.
      • Sync Interval: Leave the default.
      • Aging Criteria: Expiry time of the plugin in days (Default: 90).
      • Override Reputation: Set a value to override the reputation of indicators received from this configuration.
      • Enable SSL Validation: Enable for SSL Certificate validation.
      • Use System Proxy: Enable if the proxy is required for communication.
    4. Click Next and enter the Configuration Parameters:

      • Tenant ID: Tenant ID of your Azure application.
      • Application (client) ID: Application (client) ID of your Azure application.
      • Client Secret: Client Secret of your Azure application.
      • Initial Range: Number of days Threat IoCs to pull in the initial run.
    5. Click Save.

    Configure a Threat Exchange Business Rule for Microsoft Defender Threat Intelligence

    To share indicators fetched from Microsoft Defender Threat Intelligence to Netskope and vice versa, you need to have a business rule that will filter out the indicators that you want to share. To configure a business rule:

    1. In Threat Exchange, go to Business Rules and click Create New Rule.
    2. Add the filter(s) according to your requirements in the rule and click Save.

    Configure Threat Exchange Sharing for Microsoft Defender Threat Intelligence

    To share IoCs pulled from Microsoft Defender Threat Intelligence to Cloud Exchange:

    1. In Threat Exchange, go to Sharing and click Add Sharing Configuration.
    2. Select your Source Configuration (Microsoft Defender Threat Intelligence), Business Rule, Destination Configuration (CTE Netskope), and Target. When finished, click Save.
    Since this plugin does not support sharing IoCs from Cloud Exchange to the Microsoft Defender Threat Intelligence platform, you can share the IoCs pulled from it and share it to your Netskope tenant. Follow steps in the Netskope plugin configuration guide to share IoCs pulled from Microsoft Defender Threat Intelligence plugin to your Netskope tenant.
    In this Topic
    • Microsoft Defender Threat Intelligence Plugin for Threat Exchange