Enumerar grupos do Microsoft 365 num inquilino com os seus metadados

Descrição

O script all_groups.py permite enumerar todos os Grupos do Microsoft 365 num inquilino do Azure AD com os seus metadados:

• nome
• visibilidade: público ou privado
• descrição
• endereço de email
• proprietários
• membros
• Teams ativado?
• URL do SharePoint (ex: para ficheiros partilhados do Teams)

Tudo isto, mesmo para Grupos privados! Leia mais sobre isto no meu artigo de blog "Riscos do Microsoft Teams e dos Grupos do Microsoft 365"

O script reporting.py pegará na saída JSON de all_groups.py e gerará um ficheiro CSV que permite identificar rapidamente grupos privados ou públicos sensíveis.

Instalação

Requisito:

1. Descarregue o repositório
2. Instale os requisitos com

pip install -r requirements.txt

Utilização

Precisará de uma conta válida no inquilino. São suportados diferentes métodos de autenticação:

• via login + password (MFA não suportado)

python all_groups.py -u [email protected] -p MyPassw0rd

• via autenticação de dispositivo, que suporta MFA através do navegador. Execute e siga as instruções

python all_groups.py --device-code

Outros métodos também são oferecidos. Pode ler a documentação do ROADTools ou executar o script sem qualquer argumento para obter ajuda.

python all_groups.py

É só, não precisa de mais opções! A saída do script estará em all_groups.json no diretório atual.

Depois, se quiser uma saída mais bonita e concisa a partir deste JSON, utilize reporting.py para a transformar:

python reporting.py

Ele pega automaticamente no all_groups.json no diretório atual e gera all_groups.csv no mesmo diretório.

Agradecimentos

Este projeto utiliza para autenticação a muito útil roadlib do ROADTools por @dirkjanm