/o365

Get updated with Office 365 IPs and URLs changed by Microsoft (via Slack)

Primary LanguagePythonMIT LicenseMIT

Build Status GitHub release

o365

Script use

  • Get updated with Office 365 IPs and URLs changed by Microsoft (via Slack private channel).
  • "Almost" completely based on script provided by Microsoft - Managing Office 365 endpoints

Installation

sudo apt-get update
sudo apt-get install -y git
sudo apt-get install -y python3-pip
sudo python3 -m pip install -U pip
cd ~ && git clone https://github.com/pynetscript/o365.git && cd o365
sudo python3 -m pip install -r requirements.txt

Prerequisites

  • Add Slack application named "Bots"
    • Need to add API token provided by "Bots" at /etc/environment
    • username: mr-robot
    • icon_url: icon_url
  • Create a Private channel
    • My private channel is named #o365
    • Add "Bots" app to channel
  • Specify in the script values from your environment in lines 166, 168, 175, 185 and 197.
    • channel: #o365
    • username: mr-robot
    • icon_url: icon_url

Imgur

Imgur

Imgur

Imgur

Imgur

runner.py

  • If "clientrequestid_latestversion.txt" file exists in the same directory as "runner.py":

    • Fetch clientRequestId and Worldwide latest version.

  • Else:

    • Generate clientRequestId with uuid module.
    • Set Worldwide latest version to "0000000000".
    • Open/Create "clientrequestid_latestversion.txt" and write the data - eg.

  • Check the Worldwide latest version - eg.

  • If Online version is higher than version in "clientrequestid_latestversion.txt":

    • Print: New version of Office 365 worldwide commercial service instance endpoints detected
    • Write the new version number to "clientrequestid_latestversion.txt" - eg.
    • Download URLs, IPv4 prefixes and TCP/UDP ports that their category is either "Allow" or "Optimize" - eg.
    • Create and write all IPv4 prefixes in "o365_ipv4.csv" file
    • Create and write all URLs in "o365_url.csv" file
    • Store all TCP/UDP ports as a strings (separated by comma).
    • Send the data to Slack:
      • Channel: #o365
      • User: mr-robot
      • Icon_url: "icon_url" variable
      • Text: "text0" variable
    • Upload the data to Slack:
      • Channel: #o365
      • User: mr-robot
      • Icon_url: "icon_url" variable
      • File: "o365_ipv4.csv"
    • Upload the data to Slack:
      • Channel: #o365
      • User: mr-robot
      • Icon_url: "icon_url" variable
      • File: "o365_url.csv"
    • Send the data to Slack:
      • Channel: #o365
      • User: mr-robot
      • Icon_url: "icon_url" variable
      • Text: "text1" variable

  • Else (Online version equal to or lower than version in "clientrequestid_latestversion.txt":

    • Print: Office 365 worldwide commercial service instance endpoints are up-to-date.
    • Send a notification via Slack message:
      • Channel: #o365
      • User: mr-robot
      • Icon_url: "icon_url" variable
      • Text: "text" variable

cron job

  • Microsoft suggests that we run the script every hour so we can create a cron job to run the script at fixed times, dates, or intervals.
  • Need to give "execute" permission to "runner.py" for cron job to work (chmod 774 runner.py).

Demo (online version > version in "clientrequestid_latestversion.txt")

aleks@acorp:~/o365$ ./runner.py
22/08/2018 14:38:28 - New version of Office 365 worldwide commercial service instance endpoints detected.

Imgur

Demo (online version <= version in "clientrequestid_latestversion.txt")

aleks@acorp:~/o365$ ./runner.py 
22/08/2018 14:50:05 - Office 365 worldwide commercial service instance endpoints are up-to-date.

Imgur