Collecter les journaux Tailscale

Compatible avec :

Ce document explique comment ingérer des journaux Tailscale dans Google Security Operations à l'aide de la fonctionnalité de streaming de journaux Amazon S3 native de Tailscale. Tailscale produit des données opérationnelles sous la forme de journaux d'audit de configuration et de journaux de flux réseau. Cette intégration utilise la fonctionnalité de streaming S3 intégrée de Tailscale pour envoyer automatiquement ces journaux à Google SecOps à des fins d'analyse et de surveillance.

Avant de commencer

Assurez-vous de remplir les conditions suivantes :

  • Instance Google SecOps
  • Accès privilégié à la console d'administration Tailscale (rôle de propriétaire, d'administrateur, d'administrateur réseau ou d'administrateur informatique)
  • Accès privilégié à AWS (S3, IAM)

Collecter les prérequis Tailscale (informations sur le tailnet)

  1. Connectez-vous à la console d'administration Tailscale.
  2. Notez le nom de votre tailnet (par exemple, example.com ou le nom de votre organisation).
  3. Assurez-vous de disposer du forfait requis :
    • Streaming des journaux d'audit de configuration : disponible avec les forfaits Personal, Personal Plus et Enterprise.
    • Streaming des journaux de flux réseau : disponible uniquement avec le forfait Enterprise.

Configurer un bucket AWS S3 et IAM pour Google SecOps

  1. Créez un bucket Amazon S3 en suivant ce guide de l'utilisateur : Créer un bucket.
  2. Enregistrez le nom et la région du bucket pour référence ultérieure (par exemple, tailscale-logs).
  3. Créez un utilisateur en suivant ce guide de l'utilisateur : Créer un utilisateur IAM.
  4. Sélectionnez l'utilisateur créé.
  5. Sélectionnez l'onglet Identifiants de sécurité.
  6. Cliquez sur Create Access Key (Créer une clé d'accès) dans la section Access Keys (Clés d'accès).
  7. Sélectionnez Service tiers comme Cas d'utilisation.
  8. Cliquez sur Suivant.
  9. Facultatif : ajoutez une balise de description.
  10. Cliquez sur Créer une clé d'accès.
  11. Cliquez sur Télécharger le fichier CSV pour enregistrer la clé d'accès et la clé d'accès secrète pour une utilisation ultérieure.
  12. Cliquez sur OK.
  13. Sélectionnez l'onglet Autorisations.
  14. Cliquez sur Ajouter des autorisations dans la section Stratégies d'autorisation.
  15. Sélectionnez Ajouter des autorisations.
  16. Sélectionnez Associer directement des règles.
  17. Recherchez et sélectionnez la règle AmazonS3FullAccess.
  18. Cliquez sur Suivant.
  19. Cliquez sur Ajouter des autorisations.

Configurer la stratégie et le rôle IAM pour les importations S3

  1. Dans la console AWS, accédez à IAM > Règles > Créer une règle > onglet JSON.
  2. Saisissez la stratégie suivante :

    {
      "Version": "2012-10-17",
      "Statement": [
        {
          "Sid": "AllowTailscalePutObjects",
          "Effect": "Allow",
          "Action": [
            "s3:PutObject",
            "s3:PutObjectAcl"
          ],
          "Resource": "arn:aws:s3:::tailscale-logs/*"
        }
      ]
    }
    
    • Remplacez tailscale-logs si vous avez saisi un autre nom de bucket.
  3. Cliquez sur Suivant > Créer une règle.

  4. Accédez à IAM > Roles > Create role > Custom trust policy (IAM > Rôles > Créer un rôle > Stratégie d'approbation personnalisée).

  5. Saisissez la stratégie de confiance suivante :

    {
      "Version": "2012-10-17",
      "Statement": [
        {
          "Effect": "Allow",
          "Principal": {
            "AWS": "arn:aws:iam::982722776073:role/tailscale-log-streaming"
          },
          "Action": "sts:AssumeRole",
          "Condition": {
            "StringEquals": {
              "sts:ExternalId": "YOUR_TAILNET_NAME"
            }
          }
        }
      ]
    }
    
    • Remplacez YOUR_TAILNET_NAME par le nom réel de votre tailnet.
  6. Cliquez sur Suivant.

  7. Associez la règle créée à l'étape 1.

  8. Nommez le rôle TailscaleS3StreamingRole, puis cliquez sur Créer un rôle.

  9. Copiez l'ARN du rôle pour l'utiliser dans la configuration Tailscale.

Configurer le streaming de journaux S3 natif de Tailscale

Configurer le streaming des journaux d'audit de configuration

  1. Dans la console d'administration Tailscale, accédez à Journaux > Journaux de configuration.
  2. Cliquez sur Démarrer la diffusion.
  3. Sélectionnez Amazon S3 comme destination.
  4. Fournissez les informations de configuration suivantes :
    • ID de compte AWS : ID de votre compte AWS.
    • Nom du bucket S3 : tailscale-logs.
    • ARN du rôle : ARN du rôle IAM que vous avez créé.
    • Préfixe de clé S3 : tailscale/configuration/ (facultatif).
  5. Cliquez sur Démarrer la diffusion.
  6. Vérifiez que l'état est Actif.

Configurer le streaming des journaux de flux réseau (forfait Enterprise uniquement)

  1. Si ce n'est pas déjà fait, accédez à Settings > Network flow logs (Paramètres > Journaux de flux réseau) et activez les journaux de flux réseau pour votre tailnet.
  2. Accédez à Journaux > Journaux de flux réseau.
  3. Cliquez sur Démarrer la diffusion.
  4. Sélectionnez Amazon S3 comme destination.
  5. Fournissez les informations de configuration suivantes :
    • ID de compte AWS : l'ID de votre compte AWS
    • Nom du bucket S3 : tailscale-logs
    • ARN du rôle : ARN du rôle IAM que vous avez créé.
    • Préfixe de clé S3 : tailscale/network/ (facultatif)
  6. Cliquez sur Démarrer la diffusion.
  7. Vérifiez que l'état est Actif.

Facultatif : Créez un utilisateur et des clés IAM en lecture seule pour Google SecOps

  1. Dans la console AWS, accédez à IAM > Users > Add users (IAM > Utilisateurs > Ajouter des utilisateurs).
  2. Cliquez sur Add users (Ajouter des utilisateurs).
  3. Fournissez les informations de configuration suivantes :
    • Utilisateur : secops-reader
    • Type d'accès : Clé d'accès – Accès programmatique
  4. Cliquez sur Create User (Créer un utilisateur).
  5. Associez une stratégie de lecture minimale (personnalisée) : Utilisateurs > secops-reader > Autorisations > Ajouter des autorisations > Associer directement des stratégies > Créer une stratégie.
  6. Dans l'éditeur JSON, saisissez la stratégie suivante :

    {
      "Version": "2012-10-17",
      "Statement": [
        {
          "Effect": "Allow",
          "Action": ["s3:GetObject"],
          "Resource": "arn:aws:s3:::tailscale-logs/*"
        },
        {
          "Effect": "Allow",
          "Action": ["s3:ListBucket"],
          "Resource": "arn:aws:s3:::tailscale-logs"
        }
      ]
    }
    
  7. Définissez le nom sur secops-reader-policy.

  8. Accédez à Créer une règle > recherchez/sélectionnez > Suivant > Ajouter des autorisations.

  9. Accédez à Security credentials > Access keys > Create access key (Identifiants de sécurité > Clés d'accès > Créer une clé d'accès).

  10. Téléchargez le fichier CSV (ces valeurs sont saisies dans le flux).

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

  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.
  3. Dans le champ Nom du flux, saisissez un nom pour le flux (par exemple, Tailscale logs).
  4. Sélectionnez Amazon S3 V2 comme Type de source.
  5. Sélectionnez Tailscale comme Type de journal.
  6. Cliquez sur Suivant.
  7. Spécifiez les valeurs des paramètres d'entrée suivants :
    • URI S3 : s3://tailscale-logs/tailscale/
    • Options de suppression de la source : sélectionnez l'option de suppression de votre choix.
    • Âge maximal du fichier : incluez les fichiers modifiés au cours d'un certain nombre de jours. La valeur par défaut est de 180 jours.
    • ID de clé d'accès : clé d'accès utilisateur permettant d'accéder au bucket S3.
    • Clé d'accès secrète : clé secrète de l'utilisateur ayant accès au bucket S3.
    • Espace de noms de l'élément : espace de noms de l'élément.
    • Étiquettes d'ingestion : étiquette appliquée aux événements de ce flux.
  8. Cliquez sur Suivant.
  9. 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
exit_traf_src_port_label additional.fields Fusionné
exit_traf_txBytes_label additional.fields Fusionné
exit_traf_txPkts_label additional.fields Fusionné
nodeId_label additional.fields Fusionné
origin_label additional.fields Fusionné
phy_traf_rxBytes_label additional.fields Fusionné
phy_traf_rxPkts_label additional.fields Fusionné
phy_traf_txBytes_label additional.fields Fusionné
phy_traf_txPkts_label additional.fields Fusionné
target1_id_label additional.fields Fusionné
target1_type_label additional.fields Fusionné
vir_traf_rxBytes_label additional.fields Fusionné
vir_traf_rxPkts_label additional.fields Fusionné
vir_traf_txBytes_label additional.fields Fusionné
vir_traf_txPkts_label additional.fields Fusionné
action extensions.auth.type Mappé : LOGIN → AUTHTYPE_UNSPECIFIED
start metadata.event_timestamp Analysé en tant que ISO8601
event_type metadata.event_type Mappage direct
exit_traf.txPkts network.received_bytes Mappage direct
index network.received_bytes Mappé : 0 → uinteger
phy_traf.rxBytes network.received_bytes Mappage direct
phy_traf.rxPkts network.received_bytes Mappage direct
exit_traf.txBytes network.sent_bytes Mappage direct
index network.sent_bytes Mappé : 0 → uinteger
phy_traf.txBytes network.sent_bytes Mappage direct
phy_traf.txPkts network.sent_bytes Mappage direct
target1.name principal.asset.hostname Mappage direct
src_ip principal.asset.ip Fusionné
target1.name principal.hostname Mappage direct
src_ip principal.ip Fusionné
src_port principal.port Mappage direct
action security_result.action_details Mappage direct
action_details_label security_result.detection_fields Fusionné
eventGroupID_label security_result.detection_fields Fusionné
dst_ip target.asset.ip Fusionné
dst_ip target.ip Fusionné
dst_port target.port Mappage direct
actor_loginName target.user.email_addresses Fusionné
actor_display_name target.user.user_display_name Mappage direct
actor_id target.user.userid Mappage direct
N/A extensions.auth.type Constante : AUTHTYPE_UNSPECIFIED
N/A metadata.event_type Constante : GENERIC_EVENT

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.