Office 365 Feed

Details

ID	`Office 365 Feed`
Provider	Microsoft
Category	Data Enrichment & Threat Intelligence
From Version	5.5.0
Docker Image	`demisto/python3:3.12.13.10116658`
Supported Modules	Agentix XSIAM

README

The Office 365 IP Address and URL web service is a read-only API provided by Microsoft to expose the URLs and IPs used by Office 365. The Office 365 Feed integration fetches indicators from the service, with which you can create a list (allow list, block list, EDL, etc.) for your SIEM or firewall service to ingest and apply to its policy rules.

Configure Office 365 Feed on Cortex XSOAR

Navigate to Settings > Integrations > Servers & Services.
Search for Office 365 Feed.

Click Add instance to create and configure a new integration instance.

Parameter	Description	Example
Name	A meaningful name for the integration instance.	Office 365 Feed_worldwide_exchange
Fetch indicators	Select this option if you want this integration instance to fetch indicators from the Office 365 feed.	N/A
Regions	The regions from which to fetch indicators. Supports multi-select. For all regions, you need to select each region.
Services	The services for which to fetch indicators. Supports multi-select. For all services, select the “All” option.	Sharepoint, Exchange
Indicator Reputation	This reputation will be applied to all indicators fetched from this integration instance.	Good
Source Reliability	The reliability of the source providing the intelligence data, which affects how this indicator’s fields and reputation are populated.	A - Completely reliable
Traffic Light Protocol Color	The Traffic Light Protocol (TLP) designation to apply to indicators fetched from the feed. More information about the protocol can be found at https://us-cert.cisa.gov/tlp	N/A
feedExpirationPolicy	The method by which to expire indicators from this integration instance.	When removed from the feed
feedExpirationInterval
Feed Fetch Interval	How often to fetch indicators from this integration instance. You can specify the interval in days, hours, or minutes.	30 minutes
Bypass exclusion list	When selected, the exclusion list is ignored for indicators from this feed. This means that if an indicator from this feed is on the exclusion list, the indicator might still be added to the system.	N/A
Enrichment Excluded	Select this option to exclude the fetched indicators from the enrichment process.	False
Trust any certificate (not secure)	When selected, certificates are not checked.	N/A
Use system proxy settings	Runs the integration instance using the proxy server (HTTP or HTTPS) that you defined in the server configuration.	False

Click Test to validate the URLs and connection.

Commands

You can execute these commands from the Cortex XSOAR CLI, as part of an automation, or in a playbook.
After you successfully execute a command, a DBot message appears in the War Room with the command details.

Get indicators from the feed

Gets indicators from the feed.

Base Command

office365-get-indicators

Input

Argument Name	Description	Required
limit	The maximum number of results to return. The default value is 10.	Optional
indicator_type	The indicator type. Can be “IPs”, “URLs”, or “Both”. The default value is “IPs”.	Optional

Context Output

There is no context output for this command.

Command Example

!office365-get-indicators limit=”5”

Human Readable Output

Indicators from Office 365 Feed

value	type
0.0.0.0/0	CIDR
0.0.0.0/0	CIDR
0.0.0.0/0	CIDR
0.0.0.0/0	CIDR
0.0.0.0/0	CIDR
0.0.0.0/0	CIDR

Configuration parameters

feed — Fetch indicators
category — Category
regions — Regions (required)
services — Services (required)
allow_germany — Allow Germany
feedReputation — Indicator Reputation
feedReliability — Source Reliability (required)
tlp_color — Traffic Light Protocol Color
feedExpirationPolicy —
feedExpirationInterval —
feedFetchInterval — Feed Fetch Interval
feedTags — Tags
feedBypassExclusionList — Bypass exclusion list
enrichmentExcluded — Enrichment Excluded
insecure — Trust any certificate (not secure)
proxy — Use system proxy settings

Commands (1)

office365-get-indicators
Gets indicators from the feed.

Source

FeedOffice365.py FeedOffice365_test.py FeedOffice365.yml FeedOffice365_description.md

Download History Raw

category: Data Enrichment & Threat Intelligence
provider: Microsoft
commonfields:
  id: Office 365 Feed
  version: -1
configuration:
- display: Fetch indicators
  name: feed
  defaultvalue: 'true'
  type: 8
  required: false
  section: Collect
- defaultvalue: All
  display: Category
  name: category
  options:
  - All
  - Optimize
  - Allow
  - Default
  type: 16
  required: false
  section: Connect
- defaultvalue: All
  display: Regions
  name: regions
  options:
  - All
  - China
  - Germany
  - USGovDoD
  - USGovGCCHigh
  - Worldwide
  required: true
  type: 16
  section: Connect
- display: Services
  name: services
  defaultvalue: 'All'
  type: 16
  required: true
  options:
  - Common
  - Exchange
  - Sharepoint
  - Skype
  - All
  - MEM
  section: Connect
- defaultvalue: 'false'
  display: Allow Germany
  name: allow_germany
  required: false
  type: 8
  additionalinfo: In some cases, the Germany endpoints can be unavailable for some users. By default, we exclude Germany to prevent the fetch indicators from failing.
  section: Connect
- additionalinfo: Indicators from this integration instance will be marked with this reputation
  defaultvalue: Good
  display: Indicator Reputation
  name: feedReputation
  options:
  - None
  - Good
  - Suspicious
  - Bad
  type: 18
  required: false
  section: Collect
- additionalinfo: Reliability of the source providing the intelligence data
  display: Source Reliability
  name: feedReliability
  options:
  - A - Completely reliable
  - B - Usually reliable
  - C - Fairly reliable
  - D - Not usually reliable
  - E - Unreliable
  - F - Reliability cannot be judged
  required: true
  type: 15
  defaultvalue: A - Completely reliable
  section: Collect
- name: tlp_color
  display: Traffic Light Protocol Color
  options:
  - RED
  - AMBER
  - GREEN
  - WHITE
  type: 15
  additionalinfo: The Traffic Light Protocol (TLP) designation to apply to indicators fetched from the feed
  required: false
  section: Collect
- defaultvalue: suddenDeath
  display: ''
  name: feedExpirationPolicy
  type: 17
  options:
  - never
  - interval
  - indicatorType
  - suddenDeath
  required: false
  section: Collect
  advanced: true
- defaultvalue: '20160'
  display: ''
  name: feedExpirationInterval
  type: 1
  required: false
  section: Collect
  advanced: true
- display: Feed Fetch Interval
  name: feedFetchInterval
  type: 19
  defaultvalue: '30'
  required: false
  section: Collect
  advanced: true
- additionalinfo: Supports CSV values.
  display: Tags
  name: feedTags
  type: 0
  required: false
  section: Collect
  advanced: true
- display: Bypass exclusion list
  name: feedBypassExclusionList
  type: 8
  additionalinfo: When selected, the exclusion list is ignored for indicators from this feed. This means that if an indicator from this feed is on the exclusion list, the indicator might still be added to the system.
  defaultvalue: 'true'
  required: false
  section: Collect
  advanced: true
- display: Enrichment Excluded
  name: enrichmentExcluded
  type: 8
  required: false
  additionalinfo: Select this option to exclude the fetched indicators from the enrichment process.
  defaultvalue: 'false'
  hidden:
  - xsoar_on_prem
  section: Collect
- display: Trust any certificate (not secure)
  name: insecure
  type: 8
  required: false
  section: Connect
  advanced: true
- display: Use system proxy settings
  name: proxy
  type: 8
  required: false
  section: Connect
  advanced: true
description: The Office 365 IP Address and URL web service is a read-only API provided by Microsoft to expose the URLs and IPs used by Office 365. The Office 365 Feed integration fetches indicators from the service, with which you can create a list (allow list, block list, EDL, etc.) for your SIEM or firewall service to ingest and apply to its policy rules.
display: Office 365 Feed
name: Office 365 Feed
script:
  commands:
  - arguments:
    - defaultValue: '10'
      description: The maximum number of results to return. The default value is 10.
      name: limit
    - auto: PREDEFINED
      defaultValue: IPs
      description: The indicator type. Can be "IPs", "URLs", or "Both". The default value is "IPs".
      name: indicator_type
      predefined:
      - IPs
      - URLs
      - Both
    description: Gets indicators from the feed.
    name: office365-get-indicators
  dockerimage: demisto/python3:3.12.13.10116658
  feed: true
  runonce: false
  script: '-'
  subtype: python3
  type: python
tests:
- Office365_Feed_Test
fromversion: 5.5.0
sectionorder:
- Connect
- Collect