[Infra] Generar inventario Microsoft 365 - scripts y checklist

Resumen

Este issue centraliza los artefactos y pasos para generar un inventario completo del tenant Microsoft 365 (usuarios, grupos, licencias, roles, dominios, app registrations). No ejecutar nada sin aprobación explícita.

Archivos añadidos en este repositorio (revisar antes de ejecutar):

• docs/m365-inventory-checklist.md — checklist y comandos de ejemplo (az REST + MS Graph PowerShell)
• scripts/m365-export.sh — script Bash listo para Cloud Shell (usa az rest + jq)
• scripts/m365-export.ps1 — script PowerShell listo para Cloud Shell (usa Microsoft.Graph SDK)
• docs/m365-inventory-template.csv — CSV template para resultados
• docs/m365-inventory-template.json — JSON schema template
• docs/m365-inventory-risks.md — evaluación de riesgos y owners sugeridos

Referencias existentes en repo:

• SIGE-M365-Integration-Deliverable.md
• SIGE-M365-Integration-Inventory.csv

Instrucciones para administrador (Cloud Shell)

1. Abrir Cloud Shell (Azure) o máquina con az + jq + pwsh + Microsoft.Graph SDK
2. Clonar repo: git clone https://github.com/SIGE-SYSTEMS-TI/SIGE-PROJECT-Cloud.git && cd SIGE-PROJECT-Cloud
3. Revisar los archivos listados arriba y solicitar aprobación a Security/Identity Owners
4. Ejecutar (Bash):
   bash ./scripts/m365-export.sh --out ./exports
   o (PowerShell):
   pwsh ./scripts/m365-export.ps1 -OutputPath ./exports

Permisos y scopes necesarios

• Directory.Read.All, User.Read.All, Group.Read.All, Application.Read.All, Domain.Read.All, RoleManagement.Read.Directory, License.Read.All
• Con MS Graph PowerShell: Connect-MgGraph -Scopes 'User.Read.All','Group.Read.All','Application.Read.All','Directory.Read.All','Domain.Read.All','RoleManagement.Read.Directory','License.Read.All'

Salidas esperadas

• JSON/CSV por categoría en ./exports (users-.json/csv, groups-.json/csv, applications-.json, domains-.json, subscribedSkus-.json, directoryRoles-.json, etc.)

Acciones solicitadas

• Review de scripts por Cloud/Identity owner
• Aprobación de Security owner para ejecutar
• Ejecución en Cloud Shell y adjuntar resultados (o subir a storage seguro y pegar link)
• Marcar este issue con el link a los resultados y resumen

Notas

• Los scripts son de solo lectura. No obstante, revisar scopes y endpoints.
• No ejecutar desde este agente sin confirmación adicional.

Artefactos relacionados:

• SIGE-M365-Integration-Deliverable.md (consulte requisitos y entregables)
• SIGE-M365-Integration-Inventory.csv (inventario previo generado)

Estado y seguimiento

• Este issue se actualizará con progreso: revisión, aprobación, ejecución, resultados.

Generado por: Agente M365-Inventory (m365-tenant-foundation)

Start by reviewing docs/m365-inventory-checklist.md, scripts/m365-export.sh, and scripts/m365-export.ps1, then compare them with the existing M365 deliverable and inventory files. Confirm the required scopes and approval steps with the Cloud/Identity and Security owners before any execution. Done means approved scripts have been run in Cloud Shell and the categorized results are securely attached or linked with a summary.