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 tenant 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 tenant 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 de 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 a NIST SP 800-53 como al 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

• Políticas eliminadas

Interfaz 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:

• 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. Sample BaselineReports.html
• Salida JSON: Resultados estructurados para informes y análisis. Sample ScubaResults.json
• Exportación CSV: Datos compatibles con hojas de cálculo para su análisis. Sample ScubaResults.csv

Primeros pasos

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

Revise la sección de requisitos previos para verificar que tu 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 tu entorno, recomendamos usar las funciones y características de actualización integradas cuando necesites actualizar a la última versión. Consulta 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 línea base.

1. Primera ejecución (sin archivo de configuración): Inicia ScubaGear sin un archivo de configuración. Esta ejecución inicial genera una plantilla de línea base con la configuración actual de tu entorno. No realiza cambios, pero te 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, ejecuta ScubaGear nuevamente usando el archivo de configuración como entrada. Esto permite que ScubaGear compare tu 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 tu inquilino de Microsoft 365. Después de tu ejecución de evaluación inicial, revisa los resultados detenidamente. Aborda cualquier brecha identificada actualizando la configuración de tu inquilino o documentando las aceptaciones de riesgo en un archivo de configuración YAML mediante exclusiones, anotaciones u omisiones. Consulta las secciones a continuación para obtener orientación detallada.

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

1. Instalar ScubaGear

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

# Install ScubaGear
Install-Module -Name ScubaGear

2. Instalar dependencias

# Install the minimum required dependencies
Install-ScubaDependencies

3. Verificar la instalación

# Check the version
Invoke-SCuBA -Version

4. Ejecute su primera evaluación