ScubaGoggles

Développé par la CISA, ScubaGoggles est un outil d'évaluation qui vérifie que la configuration d'une organisation Google Workspace (GWS) est conforme aux politiques décrites dans les documents de base de configuration sécurisée des Secure Cloud Business Applications (SCuBA).

Pour la version Microsoft 365 (M365) de cet outil, voir ScubaGear.

Aperçu

Nous utilisons un processus en trois étapes :

1. Export. Dans cette étape, nous utilisons principalement l'API Google Admin SDK pour exporter et sérialiser tous les journaux et paramètres pertinents au format json. ScubaGoggles utilise également diverses autres API Google pour récupérer les métadonnées de l'organisation, les privilèges des utilisateurs, etc.
2. Verify. Comparez les paramètres exportés à l'étape précédente avec la configuration prescrite dans les référentiels. Nous effectuons cette comparaison à l'aide d'OPA Rego, un langage de requête déclaratif pour définir des politiques.
3. Report. Empaquetez les résultats au format HTML et JSON.

Table des matières

Installation

• Télécharger et installer le module Python
• Télécharger l'exécutable OPA
• Configurer les valeurs par défaut

Prérequis

• Autorisations
• API Google Cloud
• Créer un projet

Authentification

• Méthodes d'authentification
• Utilisation d'OAuth
• Utilisation d'un compte de service

Utilisation

• Utilisation : paramètres
• Utilisation : fichier de configuration
• Interface de configuration — formulaire web pour créer des fichiers de configuration
• Utilisation : exemples
• Examen des résultats
• Comparaison de deux exécutions — indique comment le résultat de chaque politique a changé entre deux exécutions
• Limitations

Dépannage

• Non autorisé à accéder à cette ressource
• macOS : erreur de vérification du certificat
• WinError 10013 : erreur de permission
• Impossible d'afficher le rapport HTML en raison de limitations de l'environnement
• ScubaGoggles signale des échecs pour les politiques SPF, DKIM et DMARC (GWS.GMAIL.2 à GWS.GMAIL.4) même si vous avez publié les enregistrements DNS applicables

Automatisation

• ScubaConnect - ScubaConnect est une infrastructure cloud-native, développée par la CISA, qui automatise l'exécution des outils d'évaluation ScubaGear et ScubaGoggles.

Divers

• Mappings
• Catalogue OSCAL

Licence du projet

Sauf mention contraire, ce projet est distribué sous la licence Creative Commons Zero. Avec l'approbation des développeurs, des contributions peuvent être soumises sous une licence compatible alternative. Si elles sont acceptées, ces contributions seront listées ici avec la licence appropriée.