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]

O ScubaGear é uma ferramenta de avaliação que verifica se a configuração de um tenant do Microsoft 365 (M365) está em conformidade com as políticas descritas nos documentos da Linha de Base de Configuração Segura do Secure Cloud Business Applications (SCuBA).

[!NOTE] Esta documentação pode ser lida usando o GitHub Pages.

Público-Alvo

O ScubaGear é destinado a administradores do M365 que desejam avaliar seus ambientes de tenant em relação às Linhas de Base de Configuração Segura da CISA.

Visão Geral

O ScubaGear usa um processo de três etapas:

• Etapa Um - O código PowerShell consulta as APIs do M365 para obter várias configurações.
• Etapa Dois - Em seguida, ele chama o Open Policy Agent (OPA) para comparar essas configurações com as políticas de segurança Rego escritas de acordo com os documentos da linha de base.
• Etapa Três - Por fim, ele relata os resultados da comparação como HTML, JSON e CSV.

Principais Recursos

Cobertura de Segurança da Linha de Base

Os controles do SCuBA foram mapeados tanto para o NIST SP 800-53 quanto para o framework MITRE ATT&CK.

• Linhas de Base

  • Microsoft Entra ID: Políticas de gerenciamento de identidade e acesso
  • Security Suite: Configurações de proteção avançada contra ameaças
  • Exchange Online: Configurações de segurança e conformidade de e-mail
  • Power BI: Configurações de segurança da ferramenta de visualização de dados baseada em nuvem
  • Power Platform: Configurações de segurança de aplicativos low-code
  • SharePoint: Colaboração de documentos e controles de acesso
  • Teams: Políticas de segurança de comunicação e reuniões

• Políticas Removidas

Interface de Configuração do Scuba

O SCuBA agora inclui uma interface gráfica de usuário que torna mais fácil do que nunca criar e gerenciar seus arquivos de configuração YAML. Esta ferramenta intuitiva ajuda a reduzir a complexidade da edição manual e simplifica o processo de configuração para sua organização. Para mais informações, consulte a documentação da Interface de Configuração.

Principais Recursos da Interface:

• Inicie com Start-ScubaConfigApp
• Assistente de configuração passo a passo cobrindo todas as opções de configuração
• Validação em tempo real com pré-visualização do YAML ao vivo
• Integração com o Microsoft Graph para seleção de usuários e grupos
• Importação/exportação contínua de arquivos de configuração existentes

Ideal para usuários que preferem uma interface visual em vez de ferramentas de linha de comando.

Saída do ScubaGear

• Relatórios HTML: Relatórios de conformidade interativos e fáceis de usar. Exemplo BaselineReports.html
• Saída JSON: Resultados estruturados para relatórios e análise. Exemplo ScubaResults.json
• Exportação CSV: Dados compatíveis com planilhas para análise. Exemplo ScubaResults.csv

Primeiros Passos

Antes de iniciar o ScubaGear, é importante garantir que seu ambiente esteja configurado corretamente. Isso inclui ter as dependências e permissões necessárias em vigor.

Consulte a seção de pré-requisitos para verificar se o seu sistema atende a todos os requisitos. Isso ajudará a evitar erros durante a execução e a garantir uma experiência tranquila ao usar o ScubaGear.

[!NOTE] Após instalar o ScubaGear em seu ambiente, recomendamos usar as funções e recursos de atualização integrados quando precisar atualizar para a versão mais recente. Consulte o Guia de Atualização para mais informações.

Guia de Início Rápido

O ScubaGear pode ser executado várias vezes para avaliar adequadamente as configurações de linha de base.

1. Primeira Execução (Sem Arquivo de Configuração): Inicie o ScubaGear sem um arquivo de configuração. Esta execução inicial gera um modelo de linha de base das configurações atuais do seu ambiente. Ela não faz alterações, mas ajuda você a entender a postura padrão.

2. Execuções Subsequentes (Com Arquivo de Configuração): Após revisar e editar o arquivo de configuração gerado, execute o ScubaGear novamente com o arquivo de configuração como entrada. Isso permite que o ScubaGear compare as configurações pretendidas com o ambiente real e eleve as discrepâncias de acordo.

[!IMPORTANT] O ScubaGear possui pré-requisitos específicos e depende de valores de configuração definidos para avaliar adequadamente seu tenant do Microsoft 365. Após sua execução inicial de avaliação, revise os resultados minuciosamente. Resolva quaisquer lacunas identificadas atualizando a configuração do seu tenant ou documentando aceitações de risco em um arquivo de configuração YAML usando exclusões, anotações ou omissões. Consulte as seções abaixo para orientações detalhadas.

Essa abordagem iterativa garante que o ScubaGear esteja alinhado com o seu ambiente e que todas as avaliações de políticas sejam baseadas na sua linha de base personalizada.

1. Instalar o ScubaGear

Para instalar o ScubaGear a partir do PSGallery, abra um terminal PowerShell 5 em um computador Windows e instale o módulo:

# Install ScubaGear
Install-Module -Name ScubaGear

2. Instalar Dependências

# Install the minimum required dependencies
Install-ScubaDependencies

3. Verificar a Instalação

# Check the version
Invoke-SCuBA -Version

4. Execute sua primeira avaliação