Collecter les journaux de contexte Google Cloud Identity

Version de l'analyseur : 1.0

Compatible avec :

Ce document explique comment ingérer des journaux Google Cloud Identity Context dans Google Security Operations à l'aide de Cloud Storage V2.

Cloud Identity Context fournit des informations sur les utilisateurs et les appareils pour les décisions d'accès basées sur l'identité, y compris la stratégie de l'appareil, les attributs utilisateur et les appartenances à des groupes utilisées pour enrichir le contexte de sécurité.

Avant de commencer

Assurez-vous de remplir les conditions suivantes :

  • Une instance Google SecOps
  • Un projet Google Cloud avec l'API Cloud Storage activée
  • Autorisations de créer et de gérer des buckets Cloud Storage
  • Autorisations de gérer les stratégies IAM (Identity and Access Management) sur les buckets Cloud Storage
  • Un environnement Google Workspace ou Cloud Identity avec des utilisateurs et des appareils
  • Autorisations IAM pour créer des récepteurs de journaux dans le projet Google Cloud
  • Un rôle d'administrateur Logging (roles/logging.admin) ou des autorisations équivalentes

Créer un bucket Cloud Storage

Utiliser la console Google Cloud

  1. Accédez à la consoleGoogle Cloud .
  2. Sélectionnez votre projet ou créez-en un.
  3. Dans le menu de navigation, accédez à Cloud Storage > Buckets.
  4. Cliquez sur Créer un bucket.
  5. Fournissez les informations de configuration suivantes :

    Paramètre Valeur
    Attribuez un nom au bucket Saisissez un nom unique (par exemple, cloud-identity-context-logs).
    Type d'emplacement Choisissez celle qui correspond le mieux à vos besoins (régionale, birégionale ou multirégionale).
    Emplacement Sélectionnez l'emplacement (par exemple, us-central1).
    Classe de stockage Standard (recommandé pour les journaux fréquemment consultés)
    Access control (Contrôle des accès) Uniforme (recommandé)
    Outils de protection Facultatif : Activez la gestion des versions d'objets ou la règle de conservation
  6. Cliquez sur Créer.

Utiliser l'outil de ligne de commande gcloud

  • Vous pouvez également créer un bucket à l'aide de la commande gcloud :

      gcloud storage buckets create gs://cloud-identity-context-logs \
        --location=us-central1 \
        --default-storage-class=STANDARD
    
    • Remplacez cloud-identity-context-logs par le nom de votre bucket (unique au monde).
    • Remplacez us-central1 par la région de votre choix (par exemple, us-central1, europe-west1).

Exporter les journaux de contexte Cloud Identity vers Cloud Storage

Les journaux de contexte Cloud Identity sont collectés dans Cloud Logging. Pour les exporter vers Cloud Storage, créez un récepteur Logging :

  1. Accédez à la consoleGoogle Cloud .
  2. Sélectionnez votre projet.
  3. Accédez à Logging > Routeur de journaux.
  4. Cliquez sur Créer un récepteur.
  5. Saisissez les informations suivantes :

    • Nom du récepteur : cloud-identity-context-sink
    • Description du récepteur : description facultative
    • Cliquez sur Suivant.
  6. Dans la section Sélectionner le service de récepteur :

    • Sélectionnez Bucket Cloud Storage comme service de récepteur.
    • Sélectionnez le bucket que vous avez créé précédemment.
    • Cliquez sur Suivant.
  7. Dans la section Sélectionner les journaux à inclure dans le récepteur, utilisez le filtre suivant :

        resource.type="audited_resource"
        protoPayload.serviceName="cloudidentity.googleapis.com"
    
  8. Cliquez sur Suivant.

  9. Vérifiez la configuration de votre récepteur, puis cliquez sur Créer un récepteur.

  10. Copiez le compte de service affiché dans le message de confirmation (par exemple, service-PROJECT_NUMBER@gcp-sa-logging.iam.gserviceaccount.com).

  11. Accédez à Cloud Storage > Buckets.

  12. Sélectionnez votre bucket.

  13. Accédez à l'onglet Autorisations.

  14. Cliquez sur Accorder l'accès.

  15. Collez l'adresse e-mail du compte de service de l'étape 9.

  16. Attribuez le rôle Créateur d'objets Storage.

  17. Cliquez sur Enregistrer.

Récupérer le 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. Sélectionnez Google Cloud Storage V2 comme Type de source.
  4. Cliquez sur Get Service Account (Obtenir un compte de service).
  5. Une adresse e-mail de compte de service unique s'affiche, par exemple :

        chronicle-12345678@chronicle-gcp-prod.iam.gserviceaccount.com
    
  6. Copiez cette adresse e-mail. Vous en aurez besoin lors de la tâche suivante.

Accorder des autorisations IAM au compte de service Google SecOps

Utiliser la console Google Cloud

  1. Accédez à Cloud Storage > Buckets.
  2. Cliquez sur le nom du bucket.
  3. Accédez à l'onglet Autorisations.
  4. Cliquez sur Accorder l'accès.
  5. Fournissez les informations de configuration suivantes :
    • Ajouter des comptes principaux : collez l'adresse e-mail du compte de service Google SecOps.
    • Attribuer des rôles : sélectionnez Lecteur des objets Storage.
  6. Cliquez sur Enregistrer.

Utiliser l'outil de ligne de commande gcloud

  • Exécutez la commande suivante :

      gcloud storage buckets add-iam-policy-binding gs://cloud-identity-context-logs \
        --member="serviceAccount:<SECOPS_SERVICE_ACCOUNT_EMAIL>" \
        --role="roles/storage.objectViewer"
    

    Remplacez :

    • cloud-identity-context-logs : par le nom de votre bucket.
    • <SECOPS_SERVICE_ACCOUNT_EMAIL> : par l'adresse e-mail du compte de service Google SecOps.

Configurer un flux dans Google SecOps pour ingérer les journaux de contexte Cloud Identity

  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. Sur la page suivante, cliquez sur Configurer un seul flux.
  4. Dans le champ Nom du flux, saisissez un nom pour le flux (par exemple, Cloud Identity Context Logs).
  5. Sélectionnez Google Cloud Storage V2 comme Type de source.
  6. Sélectionnez Google Cloud Identity Context comme type de journal.
  7. Cliquez sur Suivant.
  8. Spécifiez les valeurs des paramètres d'entrée suivants :

    • URI du bucket de stockage : saisissez l'URI du bucket Cloud Storage :

        gs://cloud-identity-context-logs/
      
    • Option de suppression de la source : sélectionnez l'option de suppression de votre choix :

      • Ne jamais supprimer les fichiers : ne supprime jamais aucun fichier après le transfert.
      • Supprimer les fichiers transférés et les répertoires vides : supprime les fichiers et les répertoires vides une fois le transfert réussi.
    • Âge maximal du fichier (jours) : incluez les fichiers modifiés au cours d'un certain nombre de jours. La valeur par défaut est 180.

    • Espace de noms de l'élément : espace de noms de l'élément.

    • Étiquettes d'ingestion : étiquettes appliquées à tous les événements de ce flux.

  9. Cliquez sur Suivant.

  10. Vérifiez la configuration de votre nouveau flux sur l'écran Finaliser, puis cliquez sur Envoyer.

Pour en savoir plus sur les flux Google SecOps, consultez la documentation sur les flux Google SecOps. Pour en savoir plus sur les exigences de chaque type de flux, consultez Configuration des flux par type.

Si vous rencontrez des problèmes lors de la création de flux, contactez l'assistance Google SecOps.

Référence sur le mappage de champs

L'analyseur de contexte Cloud Identity extrait les informations d'identité des utilisateurs et des appareils de Cloud Identity, y compris les attributs utilisateur, les adresses e-mail, les appartenances à des groupes, les chemins d'accès aux unités organisationnelles et les données de stratégie d'appareil. Il mappe ces champs sur le modèle UDM entity avec le type d'entité USER.

Table de mappage UDM

Champ du journal Mappage UDM Logique
product_object_id entity.asset.product_object_id Mappage direct
data.protoPayload.requestMetadata.callerIp entity.ip Fusionné
authorizationInfodata_granted_label entity.labels Fusionné
authorizationInfodata_permission_label entity.labels Fusionné
authorizationInfodata_resource_label entity.labels Fusionné
data_logname_label entity.labels Fusionné
field_ entity.labels Fusionné
referencedTables_datasetId_label entity.labels Fusionné
referencedTables_projectId_label entity.labels Fusionné
referencedTables_tableId_label entity.labels Fusionné
referencedViews_datasetId_label entity.labels Fusionné
referencedViews_projectId_label entity.labels Fusionné
referencedViews_tableId_label entity.labels Fusionné
value entity.location.country_or_region Mappage direct
data.protoPayload.resourceName entity.resource.name Mappage direct
company_name entity.user.company_name Renommé/Mappé
depart entity.user.department Fusionné
organisation entity.user.department Fusionné
alias entity.user.email_addresses Fusionné
data.protoPayload.authenticationInfo.principalEmail entity.user.email_addresses Fusionné
email entity.user.email_addresses Fusionné
emails entity.user.email_addresses Fusionné
primaryEmail entity.user.email_addresses Fusionné
employeeId entity.user.employee_id Mappage direct
employee_id entity.user.employee_id Mappage direct
ext.value entity.user.employee_id Mappage direct
first_name entity.user.first_name Mappage direct
givenName entity.user.first_name Mappage direct
name.givenName entity.user.first_name Mappage direct
orgUnitPath entity.user.group_identifiers Fusionné
familyName entity.user.last_name Mappage direct
last_name entity.user.last_name Mappage direct
name.familyName entity.user.last_name Mappage direct
office_address.country_or_region entity.user.office_address.country_or_region Mappage direct
office_address.state entity.user.office_address.state Mappage direct
number entity.user.phone_numbers Fusionné
data.insertId entity.user.product_object_id Mappage direct
id entity.user.product_object_id Mappage direct
title entity.user.title Mappage direct
familyName entity.user.user_display_name Mappage direct
givenName entity.user.user_display_name Mappage direct
name.fullName entity.user.user_display_name Mappage direct
user_display_name entity.user.user_display_name Mappage direct
data.insertId entity.user.userid Mappage direct
userid entity.user.userid Mappage direct
windows_sid entity.user.windows_sid Mappage direct
value metadata.event_timestamp Analysé en tant que ISO8601
N/A metadata.description Constante : From BigQuery
N/A metadata.entity_type Constante : USER
N/A metadata.product_entity_id Constante : unknown
N/A metadata.product_name Constante : Cloud Identity
N/A metadata.vendor_name Constante : Google

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.