Collecter les journaux d'audit Okera Dynamic Access Platform (ODAP)

Compatible avec :

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

  1. Accédez au fichier YAML de configuration de votre cluster Okera.
  2. Recherchez la section de configuration des journaux d'audit.
  3. 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 Azure
      • okera-ops et okera-audit : noms de vos conteneurs
  4. Enregistrez le fichier de configuration.

  5. Mettez à jour le cluster Okera à l'aide du chart Helm :

    helm upgrade okera okera/okera -f your-config.yaml
    
  6. Vé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_logs fournit 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

  1. Créez un utilisateur IAM avec un accès en lecture au bucket S3 contenant les journaux d'audit Okera.
  2. 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 AmazonS3ReadOnlyAccess ou une stratégie personnalisée avec les autorisations s3:GetObject et s3:ListBucket.

Pour Google Cloud Storage

  1. Récupérez l'adresse e-mail du compte de service Google SecOps :

    1. Accédez à Paramètres > Gestion des données > Flux. Si vous utilisez une plate-forme SIEM uniquement, accédez à Paramètres > Flux.
    2. Cliquez sur Ajouter un flux d'actualités.
    3. Cliquez sur Configurer un flux unique.
    4. Saisissez un nom pour le flux (par exemple, okera-audit-logs).
    5. Sélectionnez Google Cloud Storage V2 comme Type de source.
    6. Sélectionnez Okera DAP comme type de journal.
    7. Cliquez sur Get Service Account (Obtenir un compte de service).
    8. Copiez l'adresse e-mail du compte de service affichée.
  2. Accordez au compte de service l'accès à votre bucket GCS :

    1. Accédez à Cloud Storage > Buckets dans la console GCP.
    2. Cliquez sur le bucket contenant les journaux d'audit Okera.
    3. Accédez à l'onglet Autorisations.
    4. Cliquez sur Accorder l'accès.
    5. Dans Ajouter des comptes principaux, collez l'adresse e-mail du compte de service Google SecOps.
    6. Dans Attribuer des rôles, sélectionnez Lecteur d'objets Storage.
    7. Cliquez sur Enregistrer.

Pour Azure Blob Storage

  1. Récupérez la clé d'accès au compte de stockage :

    1. Dans le portail Azure, accédez à votre compte de stockage.
    2. Sélectionnez Clés d'accès sous Sécurité et mise en réseau.
    3. Cliquez sur Afficher les clés.
    4. Copiez la clé 1 ou la clé 2.
  2. Notez le point de terminaison du service Blob :

    • Format : https://yourstorageaccount.blob.core.windows.net/

Configurer un flux dans Google SecOps pour ingérer les journaux d'audit Okera ODAP

Pour Amazon S3

  1. Accédez à Paramètres > Gestion des données > Flux. Si vous utilisez une plate-forme SIEM uniquement, accédez à Paramètres > Flux.
  2. Cliquez sur Ajouter un flux d'actualités.
  3. Cliquez sur Configurer un flux unique.
  4. Saisissez un nom unique pour le nom du flux (par exemple, okera-audit-s3).
  5. Sélectionnez Amazon S3 V2 comme Type de source.
  6. Sélectionnez Okera DAP comme type de journal.
  7. Cliquez sur Suivant, puis sur Envoyer.
  8. 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.
  9. Cliquez sur Suivant, puis sur Envoyer.

Pour Google Cloud Storage

  1. Accédez à Paramètres > Gestion des données > Flux. Si vous utilisez une plate-forme SIEM uniquement, accédez à Paramètres > Flux.
  2. Cliquez sur Ajouter un flux d'actualités.
  3. Cliquez sur Configurer un flux unique.
  4. Saisissez un nom unique pour le nom du flux (par exemple, okera-audit-gcs).
  5. Sélectionnez Google Cloud Storage V2 comme Type de source.
  6. Sélectionnez Okera DAP comme type de journal.
  7. Cliquez sur Suivant.
  8. 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.
  9. Cliquez sur Suivant, puis sur Envoyer.

Pour Azure Blob Storage

  1. Accédez à Paramètres > Gestion des données > Flux. Si vous utilisez une plate-forme SIEM uniquement, accédez à Paramètres > Flux.
  2. Cliquez sur Ajouter un flux d'actualités.
  3. Cliquez sur Configurer un flux unique.
  4. Saisissez un nom unique pour le nom du flux (par exemple, okera-audit-azure).
  5. Sélectionnez Microsoft Azure Blob Storage V2 comme Type de source.
  6. Sélectionnez Okera DAP comme type de journal.
  7. Cliquez sur Suivant.
  8. 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.
  9. Cliquez sur Suivant, puis sur Envoyer.

Vérifier l'ingestion des journaux d'audit

  1. Attendez 10 à 15 minutes que l'ingestion initiale se termine.
  2. Accédez à Recherche dans Google SecOps.
  3. 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"
    
  4. Vérifiez que les événements s'affichent avec des codes temporels récents.

  5. Vérifiez l'état du flux :

    1. Accédez à Paramètres > Gestion des données > Flux. Si vous utilisez une plate-forme SIEM uniquement, accédez à Paramètres > Flux.
    2. Recherchez votre flux d'audit Okera.
    3. Vérifiez que l'état est Actif.
    4. 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:GetObject et s3: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_DIR est 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 :

  1. Consultez la documentation sur les journaux d'audit Databricks Unity Catalog.
  2. Configurer la diffusion des journaux d'audit Unity Catalog vers Cloud Storage
  3. Créer un flux Google SecOps pour les journaux d'audit Unity Catalog
  4. Conservez les deux flux pendant la période de migration.
  5. 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.