Collecter les journaux du WAF Vercel
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
- Accédez à la console Google 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, 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. 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.
Option A : Configurer les drains de journaux Vercel (recommandé)
Les drains de journaux Vercel diffusent les journaux en temps réel vers un point de terminaison externe.
- Connectez-vous au tableau de bord Vercel.
- Accédez aux paramètres de votre équipe : Settings > Log Drains (Paramètres > Log Drains).
- Cliquez sur Add Log Drain (Ajouter un drain de journaux).
- 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).
- Cliquez sur Add Log Drain (Ajouter un drain de journaux).
Vérifiez que les journaux sont bien envoyés à votre point de terminaison.
Option B : Exporter via l'API REST Vercel
- Générez un jeton d'API Vercel dans Settings > Tokens (Paramètres > Jetons).
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
- 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.
- Cliquez sur Configurer un flux unique.
- Dans le champ Nom du flux, saisissez un nom pour le flux (par exemple,
Vercel WAF Logs). - Sélectionnez Google Cloud Storage V2 comme Type de source.
- Sélectionnez Vercel WAF comme Type de journal.
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 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.
- Accédez à Cloud Storage > Buckets.
- Cliquez sur le nom de votre bucket (par exemple,
vercel-waf-logs). - 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 (par exemple,
chronicle-12345678@chronicle-gcp-prod.iam.gserviceaccount.com). - Attribuer des rôles : sélectionnez Lecteur d'objets Storage.
- Ajouter des comptes principaux : collez l'adresse e-mail du compte de service Google SecOps (par exemple,
Cliquez sur Enregistrer.
Configurer le flux 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.
- Cliquez sur Configurer un flux unique.
- Dans le champ Nom du flux, saisissez un nom pour le flux (par exemple,
Vercel WAF Logs). - Sélectionnez Google Cloud Storage V2 comme Type de source.
- Sélectionnez Vercel WAF comme Type de journal.
- Cliquez sur Suivant.
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-logspar le nom de votre bucket GCS. - Remplacez
vercel-wafpar le chemin d'accès du préfixe que vous avez configuré.
- Remplacez
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.
Cliquez sur Suivant.
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.