Collecter les journaux Cloud Run

Compatible avec:

Google SecOps SIEM

Remarque :Cette fonctionnalité est couverte par les Conditions des offres avant disponibilité générale des conditions spécifiques du service Google Security Operations. Les fonctionnalités pré-DG (avant disponibilité générale) sont susceptibles de présenter une compatibilité limitée, et les modifications apportées à ces fonctionnalités peuvent ne pas être compatibles avec d'autres versions avant disponibilité générale. Pour en savoir plus, consultez les Consignes relatives au service d'assistance technique Google Security Operations et les Conditions spécifiques du service Google Security Operations.

Ce guide explique comment exporter les journaux Cloud Run vers Google Security Operations à l'aide de Cloud Storage. L'analyseur extrait des champs des journaux JSON et les transforme en Unified Data Model (UDM). Il gère différents formats de journaux, y compris les données de requête HTTP et les journaux d'audit système, en mappant les champs pertinents sur UDM, tout en enrichissant les données avec des libellés et des métadonnées spécifiques à Cloud Run.

Avant de commencer

• Assurez-vous de disposer d'une instance Google SecOps.
• Assurez-vous que Cloud Run est configuré et actif dans votre environnement Google Cloud .
• Assurez-vous de disposer d'un accès privilégié à Google Cloud.

Créer un bucket Google Cloud Storage

1. Connectez-vous à la console Google Cloud.

2. Accédez à la page Buckets Cloud Storage.

   Accéder à la page "Buckets"

3. Cliquez sur Créer.

4. Sur la page Créer un bucket, saisissez les informations concernant votre bucket. Après chacune de ces étapes, cliquez sur Continuer pour passer à l'étape suivante:

   1. Dans la section Premiers pas, procédez comme suit :

      1. Saisissez un nom unique qui répond aux exigences de dénomination des buckets, par exemple cloudrun-logs.

      2. Pour activer l'espace de noms hiérarchique, cliquez sur la flèche d'expansion pour développer la section Optimiser pour les charges de travail orientées fichiers et à forte intensité de données, puis sélectionnez Activer l'espace de noms hiérarchique sur ce bucket.

         Remarque :Vous ne pouvez pas activer l'espace de noms hiérarchique dans un bucket existant.

      3. Pour ajouter une étiquette de bucket, cliquez sur la flèche de développement pour développer la section Étiquettes.

      4. Cliquez sur Ajouter un libellé, puis spécifiez une clé et une valeur pour votre libellé.

   2. Dans la section Choisir l'emplacement de stockage de vos données, procédez comme suit :

      1. Sélectionnez un type d'emplacement.

      2. Utilisez le menu "Type d'emplacement" pour sélectionner un emplacement où les données d'objets de votre bucket seront stockées de manière permanente.

         Remarque :Si vous sélectionnez le type d'emplacement birégional, vous pouvez également choisir d'activer la réplication turbo à l'aide de la case à cocher correspondante.

      3. Pour configurer la réplication entre buckets, développez la section Configurer la réplication entre buckets.

   3. Dans la section Choisir une classe de stockage pour vos données, sélectionnez une classe de stockage par défaut pour le bucket, ou bien classe automatique pour une gestion automatique des classes de stockage des données de votre bucket.

   4. Dans la section Choisir comment contrôler l'accès aux objets, sélectionnez non pour appliquer la protection contre l'accès public, puis sélectionnez un modèle de contrôle des accès pour les objets de votre bucket.

      Remarque :Si la protection contre l'accès public est déjà appliquée par la règle d'administration de votre projet, la case à cocher Empêcher l'accès public est verrouillée.

   5. Dans la section Choisir comment protéger les données d'objet, procédez comme suit:

      1. Sélectionnez l'une des options sous Protection des données que vous souhaitez définir pour votre bucket.
      2. Pour choisir comment vos données d'objet seront chiffrées, cliquez sur la flèche d'expansion intitulée Chiffrement des données, puis sélectionnez une méthode de chiffrement des données.

5. Cliquez sur Créer.

Remarque :Assurez-vous d'accorder à votre compte de service Google SecOps les autorisations Lire ou Lire et écrire sur le bucket nouvellement créé.

Configurer l'exportation des journaux dans Cloud Run

1. Sur la page Google Cloud Bienvenue, cliquez sur l'icône Cloud Run.
2. Recherchez Journalisation dans la barre de recherche en haut de la page, puis cliquez sur Entrée.
3. Dans l'explorateur de journaux, filtrez les journaux en sélectionnant Cloud Run dans Nom du journal, puis cliquez sur Appliquer.
4. Dans le menu, cliquez sur Autres actions > Créer un récepteur.
5. Fournissez les configurations suivantes :
   1. Détails du récepteur: saisissez un nom et une description.
   2. Cliquez sur Suivant.
   3. Destination du récepteur: sélectionnez Bucket Cloud Storage.
   4. Bucket Cloud Storage: sélectionnez le bucket créé précédemment ou créez-en un.
   5. Cliquez sur Suivant.
   6. Choisir des journaux à inclure dans le récepteur: un journal par défaut est renseigné lorsque vous sélectionnez une option dans le bucket Cloud Storage.
   7. Cliquez sur Suivant.
   8. Facultatif: Choisir des journaux à exclure du récepteur: sélectionnez les journaux que vous ne souhaitez pas transmettre au récepteur.
6. Cliquez sur Créer un récepteur.

Configurer un flux dans Google SecOps pour ingérer les journaux Cloud Run

1. Accédez à SIEM Settings > Feeds (Paramètres du SIEM > Flux).
2. Cliquez sur Ajouter.
3. Dans le champ Nom du flux, saisissez un nom pour le flux (par exemple, Journaux Cloud Run).
4. Sélectionnez Google Cloud Storage comme Type de source.
5. Sélectionnez GCP Cloud Run comme Type de journal.
6. Cliquez sur Obtenir un compte de service comme compte de service Chronicle.
7. Cliquez sur Suivant.

8. Spécifiez les valeurs des paramètres d'entrée suivants:

   • URI du bucket Storage: Google Cloud URL du bucket Storage au format gs://my-bucket/<value>.
   • L'URI est: sélectionnez Répertoire incluant des sous-répertoires.

   • Options de suppression de la source: sélectionnez l'option de suppression de votre choix.

     Remarque :Si vous sélectionnez l'option Delete transferred files ou Delete transferred files and empty directories, assurez-vous d'avoir accordé les autorisations appropriées au compte de service.

   • Espace de noms des éléments: espace de noms des éléments.

   • Libellés d'ingestion: libellé appliqué aux événements de ce flux.

9. Cliquez sur Suivant.

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

Tableau de mappage UDM

Champ de journal	Mappage UDM	Logique
httpRequest.latency	target.resource.attribute.labels.[]	La valeur de httpRequest.latency du journal brut est utilisée comme valeur pour un libellé avec la clé http_request_latency dans target.resource.attribute.labels.
httpRequest.protocol	network.application_protocol	Si httpRequest.protocol contient HTTP, le champ UDM est défini sur HTTP.
httpRequest.remoteIp	principal.asset.ip	La valeur de httpRequest.remoteIp du journal brut est utilisée.
httpRequest.remoteIp	principal.ip	La valeur de httpRequest.remoteIp du journal brut est utilisée.
httpRequest.requestMethod	network.http.method	La valeur de httpRequest.requestMethod du journal brut est utilisée.
httpRequest.requestSize	network.sent_bytes	La valeur de httpRequest.requestSize du journal brut est convertie en entier sans signature et utilisée.
httpRequest.requestUrl	target.url	La valeur de httpRequest.requestUrl du journal brut est utilisée.
httpRequest.responseSize	network.received_bytes	La valeur de httpRequest.responseSize du journal brut est convertie en entier sans signature et utilisée.
httpRequest.serverIp	target.asset.ip	La valeur de httpRequest.serverIp du journal brut est utilisée.
httpRequest.serverIp	target.ip	La valeur de httpRequest.serverIp du journal brut est utilisée.
httpRequest.status	network.http.response_code	La valeur de httpRequest.status du journal brut est convertie en entier et utilisée.
httpRequest.userAgent	network.http.parsed_user_agent	La valeur de httpRequest.userAgent dans le journal brut est analysée en tant que chaîne user-agent.
httpRequest.userAgent	network.http.user_agent	La valeur de httpRequest.userAgent du journal brut est utilisée.
insertId	metadata.product_log_id	La valeur de insertId du journal brut est utilisée.
labels.instanceId	additional.fields.[]	La valeur de labels.instanceId est utilisée comme valeur pour un libellé avec la clé instanceId dans additional.fields.
labels.run.googleapis.com_execution_name	additional.fields.[]	La valeur de labels.run.googleapis.com_execution_name est utilisée comme valeur pour un libellé avec la clé execution_name dans additional.fields.
labels.run.googleapis.com_task_attempt	additional.fields.[]	La valeur de labels.run.googleapis.com_task_attempt est utilisée comme valeur pour un libellé avec la clé task_attempt dans additional.fields.
labels.run.googleapis.com_task_index	additional.fields.[]	La valeur de labels.run.googleapis.com_task_index est utilisée comme valeur pour un libellé avec la clé task_index dans additional.fields.
logName	metadata.product_event_type	La valeur de logName du journal brut est utilisée.
resource.labels.configuration_name	target.resource.attribute.labels.[]	La valeur de resource.labels.configuration_name est utilisée comme valeur pour un libellé avec la clé configuration_name dans target.resource.attribute.labels.
resource.labels.job_name	additional.fields.[]	La valeur de resource.labels.job_name est utilisée comme valeur pour un libellé avec la clé job_name dans additional.fields.
resource.labels.location	target.location.name	La valeur de resource.labels.location du journal brut est utilisée.
resource.labels.project_id	target.resource.attribute.labels.[]	La valeur de resource.labels.project_id est utilisée comme valeur pour un libellé avec la clé project_id dans target.resource.attribute.labels.
resource.labels.revision_name	target.resource.attribute.labels.[]	La valeur de resource.labels.revision_name est utilisée comme valeur pour un libellé avec la clé revision_name dans target.resource.attribute.labels.
resource.labels.service_name	target.resource.attribute.labels.[]	La valeur de resource.labels.service_name est utilisée comme valeur pour un libellé avec la clé service_name dans target.resource.attribute.labels.
resource.type	target.resource.resource_subtype	La valeur de resource.type du journal brut est utilisée.
severity	security_result.severity	Si la valeur de severity correspond à Info (sans distinction de casse), le champ UDM est défini sur INFORMATIONAL.
textPayload	additional.fields.[]	La valeur de textPayload est utilisée comme valeur pour un libellé avec la clé Textpayload dans additional.fields.
timestamp	metadata.event_timestamp	La valeur de timestamp du journal brut est analysée en tant que code temporel.
timestamp	timestamp	La valeur de timestamp du journal brut est analysée en tant que code temporel. Déterminé par la logique de l'analyseur en fonction de la présence de certains champs. La valeur par défaut est GENERIC_EVENT. Si has_principal_ip, has_target_ip et httpRequest.protocol correspondent à HTTP, la valeur est définie sur NETWORK_HTTP. Codé en dur sur GCP_RUN. Codé en dur sur GCP_RUN. Codé en dur sur Google Cloud Platform. Codé en dur sur GOOGLE_CLOUD_PLATFORM.

Modifications

2024-01-22

Amélioration :

• Ajout d'un mappage pour les journaux dont le nom de journal est projects/1234/logs/run.googleapis.com%2Fstderr, projects/1234/logs/run.googleapis.com%2Fstdout, projects/1234/logs/run.googleapis.com%2Frequests et projects/1234/logs/run.googleapis.com%2Fvarlog%2Fsystem.
• Mappage de httpRequest.latency sur target.resource.attribute.labels.
• Mappage de resource.labels.configuration_name sur target.resource.attribute.labels.
• Mappage de resource.labels.revision_name sur target.resource.attribute.labels.
• Mappage de resource.labels.service_name sur target.resource.attribute.labels.
• Mappage de httpRequest.protocol sur network.application_protocol.
• Mappage de httpRequest.requestMethod sur network.http.method.
• Mappage de httpRequest.requestSize sur network.sent_bytes.
• Mappage de httpRequest.requestUrl sur target.url.
• Mappage de httpRequest.responseSize sur network.received_bytes.
• Mappage de httpRequest.remoteIp sur principal.ip et principal.asset.ip.
• httpRequest.serverIp a été mappé sur "target.ipandtarget.asset.ip".
• Mappage de httpRequest.status sur network.http.response_code.
• Mappage de httpRequest.userAgent sur network.http.user_agent.
• Mappage de logName sur metadata.product_event_type.
• Mappage de textPayload sur additional.fields.
• Mappage de labels.run.googleapis.com_execution_name sur additional.fields.
• Mappage de labels.run.googleapis.com_task_attempt sur additional.fields.
• Mappage de labels.run.googleapis.com_task_index sur additional.fields.
• Mappage de labels.instanceId sur additional.fields.
• Mappage de resource.labels.job_name sur additional.fields.

2023-04-13

Amélioration :

• Définissez target.resource.attribute.cloud.environment sur GOOGLE_CLOUD_PLATFORM.
• Définissez target.resource.name sur la valeur du nom de ressource complet.

2022-07-13

• Analyseur créé

Vous avez encore besoin d'aide ? Obtenez des réponses de membres de la communauté et de professionnels Google SecOps.