Collecter les journaux d'audit Okera Dynamic Access Platform (ODAP)
Ce document explique comment ingérer les journaux d'audit Okera Dynamic Access Platform (ODAP) dans Google Security Operations à l'aide d'un espace de stockage cloud (Amazon S3, Google Cloud Storage ou Azure Blob Storage).
Okera Dynamic Access Platform (ODAP) est une plate-forme de contrôle des accès et de gouvernance des données qui fournit un contrôle des accès ultraprécis, une découverte et une classification automatisées des données, ainsi qu'une journalisation d'audit complète pour les lacs de données et les plates-formes d'analyse. La plate-forme génère des journaux d'audit au format JSON qui capturent tous les événements d'accès aux données, les modifications de règles et les actions d'administration.
Avant de commencer
Assurez-vous de remplir les conditions préalables suivantes :
- Une instance Google SecOps
- Un déploiement Okera ODAP actif (version 2.0 ou ultérieure)
- Accès administrateur à la configuration du cluster Okera (chart Helm ou configuration YAML)
- Accès privilégié à l'une des plates-formes cloud suivantes :
- AWS (S3, IAM) pour le stockage Amazon S3
- GCP (Cloud Storage, IAM) pour Google Cloud Storage
- Azure (comptes de stockage) pour Azure Data Lake Storage Gen2
- Le cluster Okera doit disposer d'un accès en écriture à l'emplacement de stockage cloud.
Configurer l'exportation des journaux d'audit Okera ODAP
Les journaux d'audit Okera ODAP sont configurés via le fichier de configuration YAML du cluster et déployés à l'aide du chart Helm Okera. Les journaux d'audit sont écrits au format JSON dans un emplacement de stockage cloud partagé.
Déterminer votre plate-forme de stockage cloud
Choisissez l'une des plates-formes de stockage cloud suivantes en fonction de votre déploiement Okera :
- Amazon S3 : pour les clusters Okera exécutés sur AWS
- Google Cloud Storage : pour les clusters Okera exécutés sur GCP
- Azure Data Lake Storage Gen2 : pour les clusters Okera exécutés sur Azure
Configurer l'emplacement de stockage des journaux d'audit
- Accédez au fichier YAML de configuration de votre cluster Okera.
- Recherchez la section de configuration des journaux d'audit.
Configurez la destination du journal d'audit en fonction de votre plate-forme cloud :
Pour Amazon S3 :
WATCHER_LOG_DST_DIR: "s3://your-company/okera/ops/" WATCHER_AUDIT_LOG_DST_DIR: "s3://your-company/okera/audit/" WATCHER_S3_REGION: "us-east-1" WATCHER_S3_ENCRYPT: "true" WATCHER_AUDIT_UPLOAD_INTERVAL_SEC: "15"Remplacez les éléments suivants :
your-company: nom de votre bucket S3.us-east-1: votre région AWS
Pour Google Cloud Storage :
WATCHER_LOG_DST_DIR: "gs://your-company/okera/ops/" WATCHER_AUDIT_LOG_DST_DIR: "gs://your-company/okera/audit/" WATCHER_AUDIT_UPLOAD_INTERVAL_SEC: "15"Remplacez les éléments suivants :
your-company: nom de votre bucket GCS
Pour Azure Data Lake Storage Gen2 :
WATCHER_LOG_DST_DIR: "abfs://okera-ops@yourstorageaccount.dfs.core.windows.net/" WATCHER_AUDIT_LOG_DST_DIR: "abfs://okera-audit@yourstorageaccount.dfs.core.windows.net/" WATCHER_AUDIT_UPLOAD_INTERVAL_SEC: "15"Remplacez les éléments suivants :
yourstorageaccount: nom de votre compte de stockage Azureokera-opsetokera-audit: noms de vos conteneurs
Enregistrez le fichier de configuration.
Mettez à jour le cluster Okera à l'aide du chart Helm :
helm upgrade okera okera/okera -f your-config.yamlVérifiez que les journaux d'audit sont écrits à l'emplacement configuré :
Pour S3 :
aws s3 ls s3://your-company/okera/audit/Pour GCS :
gsutil ls gs://your-company/okera/audit/Pour Azure :
az storage blob list --account-name yourstorageaccount --container-name okera-audit
Format des journaux d'audit
Les journaux d'audit Okera sont écrits au format JSON avec les caractéristiques suivantes :
- Chaque fichier contient plusieurs enregistrements JSON, un par ligne (format NDJSON).
- Les enregistrements incluent tous les événements d'accès aux données, les modifications de règles et les actions d'administration.
- Les fichiers sont organisés par date dans l'emplacement de stockage.
- L'ensemble de données
okera_system.audit_logsfournit une vue interrogeable des données d'audit.
Configurer l'accès au stockage cloud pour Google SecOps
Suivez le guide approprié ci-dessous en fonction de votre plate-forme de stockage cloud :
Pour Amazon S3
- Créez un utilisateur IAM avec un accès en lecture au bucket S3 contenant les journaux d'audit Okera.
- Suivez les étapes du guide de configuration d'AWS S3 pour :
- Créer un utilisateur IAM
- Générer des clés d'accès
- Accordez
AmazonS3ReadOnlyAccessou une stratégie personnalisée avec les autorisationss3:GetObjectets3:ListBucket.
Pour Google Cloud Storage
Récupérez l'adresse e-mail du compte de service Google SecOps :
- Accédez à Paramètres > Gestion des données > Flux. Si vous utilisez une plate-forme SIEM uniquement, accédez à Paramètres > Flux.
- Cliquez sur Ajouter un flux d'actualités.
- Cliquez sur Configurer un flux unique.
- Saisissez un nom pour le flux (par exemple,
okera-audit-logs). - Sélectionnez Google Cloud Storage V2 comme Type de source.
- Sélectionnez Okera DAP comme type de journal.
- Cliquez sur Get Service Account (Obtenir un compte de service).
- Copiez l'adresse e-mail du compte de service affichée.
Accordez au compte de service l'accès à votre bucket GCS :
- Accédez à Cloud Storage > Buckets dans la console GCP.
- Cliquez sur le bucket contenant les journaux d'audit Okera.
- Accédez à l'onglet Autorisations.
- Cliquez sur Accorder l'accès.
- Dans Ajouter des comptes principaux, collez l'adresse e-mail du compte de service Google SecOps.
- Dans Attribuer des rôles, sélectionnez Lecteur d'objets Storage.
- Cliquez sur Enregistrer.
Pour Azure Blob Storage
Récupérez la clé d'accès au compte de stockage :
- Dans le portail Azure, accédez à votre compte de stockage.
- Sélectionnez Clés d'accès sous Sécurité et mise en réseau.
- Cliquez sur Afficher les clés.
- Copiez la clé 1 ou la clé 2.
Notez le point de terminaison du service Blob :
- Format :
https://yourstorageaccount.blob.core.windows.net/
- Format :
Configurer un flux dans Google SecOps pour ingérer les journaux d'audit Okera ODAP
Pour Amazon S3
- Accédez à Paramètres > Gestion des données > Flux. Si vous utilisez une plate-forme SIEM uniquement, accédez à Paramètres > Flux.
- Cliquez sur Ajouter un flux d'actualités.
- Cliquez sur Configurer un flux unique.
- Saisissez un nom unique pour le nom du flux (par exemple,
okera-audit-s3). - Sélectionnez Amazon S3 V2 comme Type de source.
- Sélectionnez Okera DAP comme type de journal.
- Cliquez sur Suivant, puis sur Envoyer.
Spécifiez les valeurs des champs suivants :
- URI S3 :
s3://your-company/okera/audit/ - Option de suppression de la source : sélectionnez Jamais (recommandé pour conserver les journaux d'audit).
- Âge maximal du fichier : incluez les fichiers modifiés au cours d'un certain nombre de jours (180 jours par défaut).
- ID de clé d'accès : clé d'accès de l'utilisateur IAM avec accès en lecture au bucket S3.
- Clé d'accès secrète : clé secrète de l'utilisateur IAM
- Espace de noms de l'élément : espace de noms de l'élément
- Étiquettes d'ingestion : étiquette à appliquer aux événements de ce flux.
- URI S3 :
Cliquez sur Suivant, puis sur Envoyer.
Pour Google Cloud Storage
- Accédez à Paramètres > Gestion des données > Flux. Si vous utilisez une plate-forme SIEM uniquement, accédez à Paramètres > Flux.
- Cliquez sur Ajouter un flux d'actualités.
- Cliquez sur Configurer un flux unique.
- Saisissez un nom unique pour le nom du flux (par exemple,
okera-audit-gcs). - Sélectionnez Google Cloud Storage V2 comme Type de source.
- Sélectionnez Okera DAP comme type de journal.
- Cliquez sur Suivant.
Spécifiez les valeurs des champs suivants :
- URL du bucket de stockage :
gs://your-company/okera/audit/ - Option de suppression de la source : sélectionnez Jamais (recommandé pour conserver les journaux d'audit).
- Âge maximal du fichier : incluez les fichiers modifiés au cours d'un certain nombre de jours (180 jours par défaut).
- Espace de noms de l'élément : espace de noms de l'élément
- Étiquettes d'ingestion : étiquette à appliquer aux événements de ce flux.
- URL du bucket de stockage :
Cliquez sur Suivant, puis sur Envoyer.
Pour Azure Blob Storage
- Accédez à Paramètres > Gestion des données > Flux. Si vous utilisez une plate-forme SIEM uniquement, accédez à Paramètres > Flux.
- Cliquez sur Ajouter un flux d'actualités.
- Cliquez sur Configurer un flux unique.
- Saisissez un nom unique pour le nom du flux (par exemple,
okera-audit-azure). - Sélectionnez Microsoft Azure Blob Storage V2 comme Type de source.
- Sélectionnez Okera DAP comme type de journal.
- Cliquez sur Suivant.
Spécifiez les valeurs des champs suivants :
- URI Azure :
https://yourstorageaccount.blob.core.windows.net/okera-audit/ - Option de suppression de la source : sélectionnez Jamais (recommandé pour conserver les journaux d'audit).
- Âge maximal du fichier : incluez les fichiers modifiés au cours d'un certain nombre de jours (180 jours par défaut).
- Clé partagée : clé d'accès au compte de stockage
- Espace de noms de l'élément : espace de noms de l'élément
- Étiquettes d'ingestion : étiquette à appliquer aux événements de ce flux.
- URI Azure :
Cliquez sur Suivant, puis sur Envoyer.
Vérifier l'ingestion des journaux d'audit
- Attendez 10 à 15 minutes que l'ingestion initiale se termine.
- Accédez à Recherche dans Google SecOps.
Exécutez une requête de recherche pour vérifier que les journaux d'audit Okera sont bien ingérés :
metadata.vendor_name = "Okera"Vérifiez que les événements s'affichent avec des codes temporels récents.
Vérifiez l'état du flux :
- Accédez à Paramètres > Gestion des données > Flux. Si vous utilisez une plate-forme SIEM uniquement, accédez à Paramètres > Flux.
- Recherchez votre flux d'audit Okera.
- Vérifiez que l'état est Actif.
- Vérifiez le code temporel de la dernière ingestion réussie.
Dépannage
Aucun journal n'apparaît dans Google SecOps
- Vérifier qu'Okera écrit des journaux d'audit dans l'emplacement de stockage cloud configuré
- Vérifiez que le chemin de stockage dans la configuration du flux correspond au paramètre
WATCHER_AUDIT_LOG_DST_DIR. - Vérifier que les autorisations Cloud Storage sont correctement configurées
- Vérifier l'état du flux pour détecter les messages d'erreur
Erreurs liées aux autorisations
- S3 : vérifiez que l'utilisateur IAM dispose des autorisations
s3:GetObjectets3:ListBucket. - GCS : vérifiez que le compte de service Google SecOps dispose du rôle Lecteur des objets de l'espace de stockage.
- Azure : vérifiez que la clé d'accès au compte de stockage est correcte et qu'elle n'a pas expiré.
Okera n'écrit pas de journaux d'audit
- Vérifier que la configuration de
WATCHER_AUDIT_LOG_DST_DIRest correcte - Vérifiez que le cluster Okera dispose d'autorisations d'écriture sur l'emplacement de stockage cloud.
- Vérifier que la mise à jour du chart Helm a bien été appliquée
- Recherchez dans les journaux du cluster Okera les erreurs liées aux importations de journaux d'audit.
Migration vers Databricks Unity Catalog
Si vous prévoyez de migrer d'Okera ODAP vers Databricks Unity Catalog :
- Consultez la documentation sur les journaux d'audit Databricks Unity Catalog.
- Configurer la diffusion des journaux d'audit Unity Catalog vers Cloud Storage
- Créer un flux Google SecOps pour les journaux d'audit Unity Catalog
- Conservez les deux flux pendant la période de migration.
- Mettre hors service le flux Okera une fois la migration terminée
Pour obtenir de l'aide concernant Okera ODAP ou la migration vers Unity Catalog, contactez l'assistance Databricks.
Table de mappage UDM
| Champ du journal | Mappage UDM | Logique |
|---|---|---|
| extensions.auth.type | extensions.auth.type | Type d'authentification |
| json_entry.request_time | metadata.event_timestamp | Code temporel de l'événement |
| metadata.event_type | metadata.event_type | Type d'événement |
| json_entry.statement_type | metadata.product_event_type | Type d'événement spécifique au produit |
| metadata.product_name | metadata.product_name | Nom du produit |
| metadata.vendor_name | metadata.vendor_name | Nom du fournisseur/de l'entreprise |
| json_entry.session_id | network.session_id | Identifiant de session |
| json_entry.connected_user | principal.user.userid | Identifiant utilisateur |
| json_entry.auth_failure | security_result.action | Mesure appliquée |
| json_entry.status | security_result.summary | Résumé du résultat de sécurité |
| json_entry.client_application | target.application | Nom de l'application |
| json_entry.client_network_address | target.ip | Adresse IP |
| json_entry.client_network_address | target.port | Numéro du port |
| json_entry.request_id | target.resource.attribute.labels | Paires clé-valeur d'attributs pour la ressource |
| json_entry.num_results_read | target.resource.attribute.labels | |
| json_entry.num_results_returned | target.resource.attribute.labels | |
| json_entry.peak_memory_usage | target.resource.attribute.labels | |
| json_entry.statement | target.resource.attribute.labels | |
| json_entry.bytes_scanned | target.resource.attribute.labels | |
| json_entry.for_reporting | target.resource.attribute.labels | |
| json_entry.auth_failure | target.resource.attribute.labels | |
| json_entry.default_db | target.resource.name | Nom de la ressource |
| target.resource.resource_type | target.resource.resource_type | Type de ressource |
| json_entry.user | target.user.userid | Identifiant utilisateur |
Journal des modifications
Afficher le journal des modifications de cet analyseur
Vous avez encore besoin d'aide ? Obtenez des réponses de membres de la communauté et de professionnels Google SecOps.