Collecter les journaux du WAF Vercel

Compatible avec :

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

Vercel WAF est un pare-feu d'application Web intégré au réseau en périphérie Vercel pour protéger les applications sans serveur. Il inspecte les requêtes HTTP entrantes à la périphérie et applique des règles de sécurité pour bloquer le trafic malveillant avant qu'il n'atteigne votre application. Comme les journaux Vercel WAF doivent être exportés depuis la plate-forme Vercel, vous devez les importer dans un bucket Google Cloud Storage (GCS), puis configurer un flux Google SecOps pour les ingérer.

Avant de commencer

Assurez-vous de remplir les conditions suivantes :

  • Une instance Google SecOps
  • Un projet Google Cloud avec facturation activée
  • Un compte Vercel avec accès aux journaux WAF (forfait Pro ou Enterprise)
  • Un jeton d'API Vercel ou un drain de journaux configuré pour exporter les journaux WAF

Créer un bucket Google Cloud Storage

  1. Accédez à la console Google 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, vercel-waf-logs).
    Type d'emplacement Choisissez celle qui correspond le mieux à vos besoins (régionale, birégionale ou multirégionale).
    Emplacement Sélectionnez l'emplacement le plus proche de votre instance Google SecOps (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.

Exporter les journaux du WAF Vercel vers GCS

Vercel fournit des journaux WAF via des drains de journaux et l'API REST Vercel. Configurez l'exportation des journaux, puis importez-les dans GCS.

Les drains de journaux Vercel diffusent les journaux en temps réel vers un point de terminaison externe.

  1. Connectez-vous au tableau de bord Vercel.
  2. Accédez aux paramètres de votre équipe : Settings > Log Drains (Paramètres > Log Drains).
  3. Cliquez sur Add Log Drain (Ajouter un drain de journaux).
  4. Configurez le drain de journaux :
    • Format d'envoi : sélectionnez JSON.
    • Sources : sélectionnez Pare-feu pour inclure les événements WAF.
    • Environnements : sélectionnez les environnements à surveiller (Production, Preview, Development).
    • Point de terminaison : saisissez l'URL de votre récepteur intermédiaire (par exemple, un point de terminaison de fonction Cloud Run qui écrit dans GCS).
  5. Cliquez sur Add Log Drain (Ajouter un drain de journaux).
  6. Vérifiez que les journaux sont bien envoyés à votre point de terminaison.

Option B : Exporter via l'API REST Vercel

  1. Générez un jeton d'API Vercel dans Settings > Tokens (Paramètres > Jetons).
  2. Utilisez l'API REST Vercel pour récupérer les événements de pare-feu :

    curl -H "Authorization: Bearer YOUR_VERCEL_TOKEN" \
      "https://api.vercel.com/v1/security/firewall/events?teamId=YOUR_TEAM_ID&projectId=YOUR_PROJECT_ID&limit=100" \
      -o vercel-waf-events.json
    

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. Cliquez sur Configurer un flux unique.
  4. Dans le champ Nom du flux, saisissez un nom pour le flux (par exemple, Vercel WAF Logs).
  5. Sélectionnez Google Cloud Storage V2 comme Type de source.
  6. Sélectionnez Vercel WAF comme Type de journal.
  7. 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.com
    
  8. Copiez cette adresse e-mail pour l'utiliser à l'étape suivante.

Accorder des autorisations IAM au compte de service Google SecOps

Le compte de service Google SecOps doit disposer du rôle Lecteur des objets Storage sur votre bucket GCS.

  1. Accédez à Cloud Storage > Buckets.
  2. Cliquez sur le nom de votre bucket (par exemple, vercel-waf-logs).
  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 (par exemple, chronicle-12345678@chronicle-gcp-prod.iam.gserviceaccount.com).
    • Attribuer des rôles : sélectionnez Lecteur d'objets Storage.
  6. Cliquez sur Enregistrer.

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

    • URL du bucket de stockage : saisissez l'URI du bucket GCS :

      gs://vercel-waf-logs/vercel-waf/
      
      • Remplacez vercel-waf-logs par le nom de votre bucket GCS.
      • Remplacez vercel-waf par le chemin d'accès du préfixe que vous avez configuré.
    • Option de suppression de la source : sélectionnez l'option de suppression de votre choix :

      • Jamais : ne supprime jamais les fichiers après les transferts (recommandé pour les tests).
      • 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 : 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.

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

Table de mappage UDM

Champ du journal Mappage UDM Logique
record.requestId, record.proxy.timestamp, record.proxy.region, record.proxy.errorCode, record.proxy.vercelCache, record.proxy.pathType, record.proxy.referer, record.proxy.cacheId, record.proxy.wafAction, record.proxy.scheme, record.proxy.userAgent, record.environment additional.fields Métadonnées d'événement supplémentaires
metadata.event_type Type d'événement
record.deploymentId metadata.product_deployment_id ID de déploiement spécifique au produit
record.id metadata.product_log_id ID de journal spécifique au produit
record.proxy.method network.http.method Méthode HTTP
record.statusCode network.http.response_code Code de réponse HTTP
record.source principal.asset.hostname Nom d'hôte de l'élément associé au compte principal
record.host principal.hostname Nom d'hôte du compte principal
record.message security_result.description Description du résultat de sécurité
record.proxy.wafRule security_result.rule_name Nom de la règle qui a déclenché le résultat de sécurité
record.level security_result.severity Gravité du résultat de sécurité
record.proxy.wafRule security_result.threat_name Nom de la menace
record.proxy.clientIp target.asset.ip Adresse IP de l'élément
record.projectId target.cloud.project.id ID du projet sur le cloud
record.projectName target.cloud.project.name Nom du projet cloud
record.proxy.path target.file.full_path Chemin d'accès complet au fichier
record.proxy.clientIp target.ip Adresse IP de la cible
record.executionRegion target.location.name Nom de l'emplacement
record.proxy.vercelId target.user.userid ID de l'utilisateur cible
metadata.product_name Nom du produit
metadata.vendor_name Nom du fournisseur

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