Skip to content

Enumerate Microsoft 365 Groups in a tenant with their metadata

License

Notifications You must be signed in to change notification settings

cnotin/m365_groups_enum

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Enumerate Microsoft 365 Groups in a tenant with their metadata

Description

The all_groups.py script allows to enumerate all Microsoft 365 Groups in a Azure AD tenant with their metadata:

  • name
  • visibility: public or private
  • description
  • email address
  • owners
  • members
  • Teams enabled?
  • SharePoint URL (e.g. for Teams shared files)

All of this, even for private Groups! Read more about this on my blog article "Risks of Microsoft Teams and Microsoft 365 Groups"

The reporting.py script will take the JSON output from all_groups.py and generates a CSV files allowing to quickly identify sensitive private or public groups.

Installation

Requirement: Python 3 only

  1. Download the repository
  2. Install requirements with
pip install -r requirements.txt

Usage

You will need a valid account on the tenant. Different authentication methods are supported:

  • via login + password (MFA not supported)
python all_groups.py -u [email protected] -p MyPassw0rd
  • via device authentication, which supports MFA via the browser. Launch then follow instructions
python all_groups.py --device-code

Other methods are also offered. You can read the ROADTools documentation or run the script without any argument to get help.

python all_groups.py

That's all, you don't need more options! The script output will be in all_groups.json in the current directory.

Then, if you want a nicer and more concise output from this JSON, use reporting.py to transform it:

python reporting.py

It automatically takes all_groups.json in the current directory, and outputs to all_groups.csv in the same directory.

Acknowledgements

This project uses for authentication the very helpful roadlib from ROADTools by @dirkjanm

About

Enumerate Microsoft 365 Groups in a tenant with their metadata

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages