Collecter les journaux de contexte Google Cloud Identity
Version de l'analyseur : 1.0
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
- Accédez à la consoleGoogle Cloud .
- Sélectionnez votre projet ou créez-en un.
- Dans le menu de navigation, accédez à Cloud Storage > Buckets.
- Cliquez sur Créer un bucket.
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 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-logspar le nom de votre bucket (unique au monde). - Remplacez
us-central1par la région de votre choix (par exemple,us-central1,europe-west1).
- Remplacez
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 :
- Accédez à la consoleGoogle Cloud .
- Sélectionnez votre projet.
- Accédez à Logging > Routeur de journaux.
- Cliquez sur Créer un récepteur.
Saisissez les informations suivantes :
- Nom du récepteur :
cloud-identity-context-sink - Description du récepteur : description facultative
- Cliquez sur Suivant.
- Nom du récepteur :
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.
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"Cliquez sur Suivant.
Vérifiez la configuration de votre récepteur, puis cliquez sur Créer un récepteur.
Copiez le compte de service affiché dans le message de confirmation (par exemple,
service-PROJECT_NUMBER@gcp-sa-logging.iam.gserviceaccount.com).Accédez à Cloud Storage > Buckets.
Sélectionnez votre bucket.
Accédez à l'onglet Autorisations.
Cliquez sur Accorder l'accès.
Collez l'adresse e-mail du compte de service de l'étape 9.
Attribuez le rôle Créateur d'objets Storage.
Cliquez sur Enregistrer.
Récupérer le 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.
- Sélectionnez Google Cloud Storage V2 comme Type de source.
- Cliquez sur Get Service Account (Obtenir un compte de service).
Une adresse e-mail de compte de service unique s'affiche, par exemple :
chronicle-12345678@chronicle-gcp-prod.iam.gserviceaccount.comCopiez 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
- Accédez à Cloud Storage > Buckets.
- Cliquez sur le nom du bucket.
- Accédez à l'onglet Autorisations.
- Cliquez sur Accorder l'accès.
- 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.
- 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
- 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.
- Sur la page suivante, cliquez sur Configurer un seul flux.
- Dans le champ Nom du flux, saisissez un nom pour le flux (par exemple,
Cloud Identity Context Logs). - Sélectionnez Google Cloud Storage V2 comme Type de source.
- Sélectionnez Google Cloud Identity Context comme type de journal.
- Cliquez sur Suivant.
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.
Cliquez sur Suivant.
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.