ScubaGear

[![GitHub Release][github-release-img]][release] [![PSGallery Release][psgallery-release-img]][psgallery] [![CI Pipeline][ci-pipeline-img]][ci-pipeline] [![Functional Tests][functional-test-img]][functional-test] [![GitHub License][github-license-img]][license] [![GitHub Downloads][github-downloads-img]][release] [![PSGallery Downloads][psgallery-downloads-img]][psgallery] [![GitHub Issues][github-issues-img]][github-issues]

ScubaGear es una herramienta de evaluación que verifica que la configuración de un inquilino de Microsoft 365 (M365) cumpla con las políticas descritas en los documentos de la línea base de configuración segura de Secure Cloud Business Applications (SCuBA).

[!NOTE] Esta documentación se puede leer usando GitHub Pages.

Público objetivo

ScubaGear está dirigido a administradores de M365 que desean evaluar sus entornos de inquilino frente a las líneas base de configuración segura de CISA.

Descripción general

ScubaGear utiliza un proceso de tres pasos:

• Paso uno - El código de PowerShell consulta las API de M365 para obtener diversas configuraciones.
• Paso dos - Luego llama a Open Policy Agent (OPA) para comparar estas configuraciones con las políticas de seguridad Rego escritas según los documentos de la línea base.
• Paso tres - Finalmente, informa los resultados de la comparación en HTML, JSON y CSV.

Características principales

Cobertura de seguridad de la línea base

Los controles de SCuBA se han mapeado tanto con NIST SP 800-53 como con el marco MITRE ATT&CK.

• Líneas base

  • Microsoft Entra ID: Políticas de gestión de identidades y accesos
  • Security Suite: Configuraciones de protección avanzada contra amenazas
  • Exchange Online: Configuraciones de seguridad y cumplimiento del correo electrónico
  • Power BI: Configuraciones de seguridad de la herramienta de visualización de datos basada en la nube
  • Power Platform: Configuraciones de seguridad de aplicaciones de código bajo
  • SharePoint: Colaboración de documentos y controles de acceso
  • Teams: Políticas de seguridad de comunicaciones y reuniones
  • Super Intelligence (SI): Configuraciones de seguridad y gobernanza de SI y agentes de SI (en desarrollo)

• Políticas eliminadas

Interfaz de usuario de configuración de Scuba

SCuBA ahora incluye una interfaz gráfica de usuario que facilita más que nunca la creación y gestión de tus archivos de configuración YAML. Esta herramienta intuitiva ayuda a reducir la complejidad de la edición manual y agiliza el proceso de configuración para tu organización. Para obtener más información, consulta la documentación de la interfaz de configuración.

Características principales de la interfaz de usuario:

• Se inicia con Start-ScubaConfigApp
• Asistente de configuración paso a paso que cubre todas las opciones de configuración
• Validación en tiempo real con vista previa de YAML en vivo
• Integración con Microsoft Graph para la selección de usuarios y grupos
• Importación/exportación fluida de archivos de configuración existentes

Ideal para usuarios que prefieren una interfaz visual en lugar de herramientas de línea de comandos.

Salida de ScubaGear

• Informes HTML: Informes de cumplimiento interactivos y fáciles de usar. Ejemplo BaselineReports.html
• Salida JSON: Resultados estructurados para informes y análisis. Ejemplo ScubaResults.json
• Exportación CSV: Datos compatibles con hojas de cálculo para su análisis. Ejemplo ScubaResults.csv

Primeros pasos

Antes de lanzar ScubaGear, es importante asegurarse de que su entorno esté configurado correctamente. Esto incluye contar con las dependencias y los permisos necesarios.

Revise la sección de requisitos previos para verificar que su sistema cumple con todos los requisitos. Esto ayudará a evitar errores durante la ejecución y garantizará una experiencia fluida al usar ScubaGear.

[!NOTE] Después de instalar ScubaGear en su entorno, recomendamos usar las funciones y características de actualización integradas cuando necesite actualizar a la última versión. Consulte la Guía de actualización para obtener más información.

Guía de inicio rápido

ScubaGear se puede ejecutar varias veces para evaluar correctamente la configuración de las líneas base.

1. Primera ejecución (sin archivo de configuración): Inicie ScubaGear sin un archivo de configuración. Esta ejecución inicial genera una plantilla de línea base con la configuración actual de su entorno. No realiza cambios, pero le ayuda a comprender la postura predeterminada.

2. Ejecuciones posteriores (con archivo de configuración): Después de revisar y editar el archivo de configuración generado, ejecute ScubaGear nuevamente con el archivo de configuración como entrada. Esto permite que ScubaGear compare su configuración prevista con el entorno real y señale las discrepancias correspondientes.

[!IMPORTANT] ScubaGear tiene requisitos previos específicos y depende de valores de configuración definidos para evaluar correctamente su inquilino de Microsoft 365. Después de su ejecución de evaluación inicial, revise los resultados a fondo. Aborde las brechas identificadas actualizando la configuración de su inquilino o documentando las aceptaciones de riesgo en un archivo de configuración YAML mediante exclusiones, anotaciones u omisiones. Consulte las secciones a continuación para obtener orientación detallada.

Este enfoque iterativo garantiza que ScubaGear esté alineado con su entorno y que todas las evaluaciones de políticas se basen en su línea base personalizada.

1. Instalar ScubaGear

Para instalar ScubaGear desde PSGallery, abra una terminal de PowerShell 5 en un equipo Windows e instale el módulo:

# Install ScubaGear
Install-Module -Name ScubaGear

2. Instalar dependencias

# Install the minimum required dependencies
Install-ScubaDependencies