Office 365 Feed

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.

Data Enrichment & Threat Intelligence · Office 365 Feed · Feed

Details

IDOffice 365 Feed
ProviderMicrosoft
CategoryData Enrichment & Threat Intelligence
From Version5.5.0
Docker Imagedemisto/python3:3.12.13.10116658
Supported ModulesAgentix 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

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

  3. 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
  4. 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 
## Office 365 IP Address and URL web service:
https://docs.microsoft.com/en-us/office365/enterprise/office-365-ip-web-service
#### Prototypes to choose from:
- o365-api.china-any
- o365-api.china-common
- o365-api.china-exchange
- o365-api.china-sharepoint
- o365-api.china-skype
- o365-api.germany-any
- o365-api.germany-common
- o365-api.germany-exchange
- o365-api.germany-sharepoint
- o365-api.germany-skype
- o365-api.usgovdod-any
- o365-api.usgovdod-common
- o365-api.usgovdod-exchange
- o365-api.usgovdod-sharepoint
- o365-api.usgovdod-skype
- o365-api.usgovgcchigh-any
- o365-api.usgovgcchigh-common
- o365-api.usgovgcchigh-exchange
- o365-api.usgovgcchigh-sharepoint
- o365-api.usgovgcchigh-skype
- o365-api.worldwide-any
- o365-api.worldwide-common
- o365-api.worldwide-exchange
- o365-api.worldwide-sharepoint
- o365-api.worldwide-skype