Collecter les journaux IONIX de gestion de la surface d'attaque

Compatible avec :

Ce document explique comment configurer IONIX Gestion de la surface d'attaque pour transférer des journaux vers Google Security Operations à l'aide de webhooks.

IONIX est une plate-forme de gestion de la surface d'attaque externe (EASM) qui détecte, évalue et valide les risques de sécurité sur les ressources accessibles sur Internet et la chaîne d'approvisionnement numérique de votre organisation. IONIX fournit des éléments d'action pour les résultats DNS, les problèmes d'infrastructure à clé publique, les expositions au cloud et les failles, en proposant des workflows de correction hiérarchisés.

Avant de commencer

Assurez-vous de remplir les conditions suivantes :

  • Une instance Google SecOps
  • IONIX Attack Surface Management est compatible avec le push HTTP POST pour la diffusion des journaux
  • Accès à la console Google Cloud (pour la création de clés API)
  • Un compte de portail IONIX actif avec un accès administrateur à Paramètres > Intégrations

Créer un flux de webhook dans Google SecOps

Créer le flux

  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. Sur la page suivante, cliquez sur Configurer un seul flux.
  4. Dans le champ Nom du flux, saisissez un nom pour le flux (par exemple, IONIX ASM Logs).
  5. Sélectionnez Webhook comme type de source.
  6. Sélectionnez IONIX comme type de journal.
  7. Cliquez sur Suivant.
  8. Spécifiez les valeurs des paramètres d'entrée suivants :
    • Délimiteur de division (facultatif) : saisissez un délimiteur pour diviser les événements multilignes. Valeurs courantes :
      • \n : délimiteur de saut de ligne (le plus courant pour NDJSON)
      • Laissez ce champ vide si chaque requête contient un seul événement.
    • 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 sur l'écran Finaliser, puis cliquez sur Envoyer.

Générer et enregistrer une clé secrète

Après avoir créé le flux, vous devez générer une clé secrète pour l'authentification :

  1. Sur la page d'informations du flux, cliquez sur Générer une clé secrète.
  2. Une boîte de dialogue affiche la clé secrète.
  3. Copiez et enregistrez la clé secrète de manière sécurisée.

Obtenir l'URL du point de terminaison du flux

  1. Accédez à l'onglet Détails du flux.
  2. Dans la section Informations sur le point de terminaison, copiez l'URL du point de terminaison du flux.
  3. Le format d'URL est le suivant :

    https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import
    

    Où {region} est la région de votre instance Google SecOps (par exemple, us, europe ou asia-southeast1) et {parent} est le chemin d'accès à la ressource au format projects/<PROJECT_ID>/locations/<LOCATION>/instances/<INSTANCE_ID>/logTypes/<LOG_TYPE>.

  4. Enregistrez cette URL pour les étapes suivantes.

  5. Cliquez sur OK.

Créer Google Cloud une clé API

Google SecOps nécessite une clé API pour l'authentification. Créez une clé API restreinte dans la console Google Cloud .

Créer la clé API

  1. Accédez à la page Identifiants de la consoleGoogle Cloud .
  2. Sélectionnez votre projet (celui associé à votre instance Google SecOps).
  3. Cliquez sur Créer des identifiants > Clé API.
  4. Une clé API est créée et s'affiche dans une boîte de dialogue.
  5. Cliquez sur Modifier la clé API pour restreindre la clé.

Restreindre la clé API

  1. Sur la page des paramètres de la clé API :
    • Nom : saisissez un nom descriptif (par exemple, Google SecOps Webhook API Key).
  2. Sous Restrictions relatives aux API :
    1. Sélectionnez Restreindre la clé.
    2. Dans le menu déroulant Sélectionner des API, recherchez et sélectionnez API Google SecOps (ou API Chronicle).
  3. Cliquez sur Enregistrer.
  4. Copiez la valeur de la clé API dans le champ Clé API en haut de la page.
  5. Enregistrez la clé API de manière sécurisée.

Configurer le webhook IONIX Attack Surface Management

IONIX prend en charge de manière native l'envoi de données d'événements liés à la sécurité à des points de terminaison externes via HTTP POST à l'aide de son framework d'intégration. L'intégration est configurée dans le portail IONIX et utilise le même mécanisme que l'intégration Splunk HEC, adaptée pour transférer des données vers le point de terminaison du webhook Google SecOps.

Créer l'URL de webhook

  • Combinez l'URL du point de terminaison Google SecOps et la clé API en une seule URL :

    <ENDPOINT_URL>?key=<API_KEY>&secret=<SECRET_KEY>
    
    • Exemple :

      https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import?key=AIzaSyD...&secret=abcd1234...
      

Configurer l'intégration sur le portail IONIX

  1. Connectez-vous à votre portail IONIX (par exemple, https://<your-portal-name>.ionix.com).
  2. Accédez à Paramètres > Intégrations.
  3. Cliquez sur Intégration Splunk > Paramètres.
  4. Fournissez les informations de configuration suivantes :

    • Jeton HEC : saisissez la clé secrète générée à partir du flux de webhook Google SecOps.
    • Serveur Splunk : saisissez l'URL complète du point de terminaison du webhook Google SecOps, avec la clé API ajoutée en tant que paramètre de requête. Utilisez le format suivant :

      https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import?key=<API_KEY>
      
  5. Configurez l'intervalle d'envoi pour définir la fréquence à laquelle IONIX envoie des données au point de terminaison (par exemple, toutes les 60 minutes).

  6. Remplissez tous les champs de données supplémentaires pertinents pour votre environnement.

  7. Cliquez sur Enregistrer.

  8. Activez l'intégration en basculant le bouton d'intégration sur Activé.

  9. Les données commenceront à apparaître dans Google SecOps au cours d'un cycle d'intervalle d'envoi. La distribution initiale des données peut prendre jusqu'à une heure.

Alternative : Utiliser l'API REST IONIX avec un script personnalisé

Si l'intégration native de Splunk HEC ne répond pas à vos besoins, vous pouvez utiliser l'API REST IONIX pour extraire des données et les transférer vers Google SecOps.

Générer une clé API IONIX

  1. Connectez-vous au portail IONIX.
  2. Cliquez sur Paramètres de l'API.
  3. Indiquez un nom pour le jeton.
  4. Sélectionnez le type de jeton :
    • Lecture seule (recommandé pour la collecte de données)
    • Lecture/écriture
  5. Définissez une date d'expiration pour le jeton.
  6. Cliquez sur Créer un jeton.
  7. Copiez le jeton généré et enregistrez-le de manière sécurisée.

Points de terminaison de l'API IONIX

Utilisez les points de terminaison d'API suivants pour récupérer les données de sécurité d'IONIX :

Point de terminaison Description
/api/v1/remediation/action-items/open/ Éléments d'action ouverts (domaines, point de terminaison racine)
/api/v1/remediation/action-items/all/detailed Toutes les actions avec des informations détaillées
/api/v1/discovery/org-assets/export-discovery-evidence Preuves de risque et de découverte des éléments
/api/v1/discovery/org-assets Éléments de l'organisation (inclut la date de première détection)
/api/v1/tests Résultats des tests de sécurité
  • Exemple de requête API

    curl -X GET "https://api.portal.ionix.io/api/v1/remediation/action-items/all/detailed" \
        -H "Authorization: Token <IONIX_API_KEY>" \
        -H "Content-Type: application/json"
    

Transférer des données vers Google SecOps

  • Après avoir récupéré les données de l'API IONIX, transférez-les au point de terminaison du webhook Google SecOps :

    curl -X POST "<ENDPOINT_URL>?key=<API_KEY>&secret=<SECRET_KEY>" \
        -H "Content-Type: application/json" \
        -d @ionix_events.json
    

Référence des méthodes d'authentification

Les flux de webhook Google SecOps sont compatibles avec plusieurs méthodes d'authentification. Choisissez la méthode compatible avec votre fournisseur.

Si votre fournisseur accepte les en-têtes HTTP personnalisés, utilisez cette méthode pour une sécurité renforcée.

  • Format de la requête :

    POST <ENDPOINT_URL> HTTP/1.1
    Content-Type: application/json
    x-goog-chronicle-auth: <API_KEY>
    x-chronicle-auth: <SECRET_KEY>
    
    {
            "event": "data",
            "timestamp": "2025-01-15T10:30:00Z"
    }
    

Avantages :

  • Clé API et code secret non visibles dans l'URL
  • Plus sécurisé (les en-têtes ne sont pas enregistrés dans les journaux d'accès du serveur Web)
  • Méthode privilégiée lorsque le fournisseur la prend en charge

Méthode 2 : Paramètres de requête

Si votre fournisseur n'accepte pas les en-têtes personnalisés, ajoutez les identifiants à l'URL.

  • Format d'URL :

    <ENDPOINT_URL>?key=<API_KEY>&secret=<SECRET_KEY>
    
    • Exemple :
    https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import?key=AIzaSyD...&secret=abcd1234...
    
  • Format de la requête :

    POST <ENDPOINT_URL>?key=<API_KEY>&secret=<SECRET_KEY> HTTP/1.1
    Content-Type: application/json
    
    {
            "event": "data",
            "timestamp": "2025-01-15T10:30:00Z"
    }
    

Inconvénients :

  • Identifiants visibles dans l'URL
  • Peut être consigné dans les journaux d'accès du serveur Web
  • Moins sécurisé que les en-têtes

Méthode 3 : Hybride (URL + en-tête)

Certaines configurations utilisent une clé API dans l'URL et une clé secrète dans l'en-tête.

  • Format de la requête :

    POST <ENDPOINT_URL>?key=<API_KEY> HTTP/1.1
    Content-Type: application/json
    x-chronicle-auth: <SECRET_KEY>
    
    {
            "event": "data",
            "timestamp": "2025-01-15T10:30:00Z"
    }
    

Noms des en-têtes d'authentification

Google SecOps accepte les noms d'en-tête suivants pour l'authentification :

  • Pour une clé API :

    • x-goog-chronicle-auth (recommandé)
    • X-Goog-Chronicle-Auth (non sensible à la casse)
  • Pour la clé secrète :

    • x-chronicle-auth (recommandé)
    • X-Chronicle-Auth (non sensible à la casse)

Table de mappage UDM

Pour savoir comment les champs de journal IONIX sont mappés aux champs du modèle de données unifié (UDM) de Google Security Operations, recherchez le type de journal IONIX dans la documentation de référence sur les analyseurs par défaut compatibles.

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.