Exemples de commande

Exemples de CLI pour les destinations prises en charge :

IBM Cloud Logs

Exemple

ibmcloud cis logpush-job-create 601b728b86e630c744c81740f72570c3 --destination "ibmcl://604a309c-585c-4a42-955d-76239ccc1905.ingress.us-south.logs.cloud.ibm.com/logs/v1/singles?ibm_api_key=xxxxxxxx" --name logpushJobGen --enable true --fields RayID --dataset http_requests --frequency high --instance 1a9174b6-0106-417a-844b-c8eb43a72f63

Cloud Object Storage :
Exemple

   ```sh {: pre}
   ibmcloud cis logpush-job-create 31984fea73a15b45779fa0df4ef62f9b --destination cos://cis-test-bucket/logs/{DATE}?region=us&instance-id=f75e6d90-4212-4026-851c-d572071146cd&ibm_api_key=XXX --name logpushcreate --enable true --fields all --timestamps rfc3339 --dataset http_requests --frequency low -i cis-demo --output JSON
   ```

IBM QRadar

Exemple

ibmcloud cis logpush-job-create 31984fea73a15b45779fa0df4ef62f9b --destination https://qradar.example.com:8088 --name logpushJobQRadar --enable true --fields RayID --dataset http_requests --frequency high --instance 1a9174b6-0106-417a-844b-c8eb43a72f63

Splunk

Exemple

ibmcloud cis logpush-job-create 601b728b86e630c744c81740f72570c3 --destination splunk://cis-analytics.ibm.com:8088/services/collector/raw?header_Authorization=Splunk%20e6d94e8c-5792-4ad1-be3c-29bcaee0197d&channel=f1aafa4f-684f-4c29-a040-7fe184b03712&sourcetype=cloudflare:json&insecure-skip-verify=false --name logpushJobSplunk --enable true --fields RayID --dataset http_requests --frequency high --instance 1a9174b6-0106-417a-844b-c8eb43a72f63

Personnalisé HTTP

Exemple

ibmcloud cis logpush-job-create 601b728b86e630c744c81740f72570c3 --destination https://logs.example.com?header_Authorization=a64VuywesDu5Aq" --name logpushJobGen --enable true --fields RayID --dataset http_requests --frequency high --instance 1a9174b6-0106-417a-844b-c8eb43a72f63

Obtenir les champs de journalisation disponibles pour un ensemble de données avec l'API

Les champs du journal peuvent être spécifiés dans le site logpull_options d'un travail Logpush pour personnaliser ce qui est envoyé à la destination. Pour obtenir les champs de journalisation disponibles pour un jeu de données Logpush, procédez comme suit :

1. Configurez l'environnement de votre API avec les variables appropriées.
2. Stockez les valeurs suivantes dans les variables destinées à être utilisées dans la commande d'API :

CRN: CRN complet codé en URL de l'instance de service.

ZONE_ID: L'ID de domaine.

DATASET: L'ensemble de données Logpush en cours d'inspection. Un des éléments suivants : http_requests, range_events, dns_logs, firewall_events.

1. Lorsque toutes les variables sont initiées, créez le travail logpush :

   curl -X GET https://api.cis.cloud.ibm.com/v2/$CRN/zones/$ZONE_ID/logpush/datas/$DATASET/fields \
   --header "Content-Type: application/json" \
   --header "X-Auth-User-Token: Bearer $IAM_TOKEN"'
   

Création d'une tâche Logpush pour envoyer les logs vers votre destination

Pour créer une tâche Logpush vers votre destination ( IBM Cloud Logs, Cloud Object Storage, ou Splunk ), procédez comme suit :

1. Configurez l'environnement de votre API avec les variables appropriées.
2. Stockez les valeurs suivantes dans les variables destinées à être utilisées dans la commande d'API :

CRN: Le nom complet de la ressource cloud (CRN) de l'instance de service, codé sur URL.

ZONE_ID: L'ID de domaine.

--request body: Informations pour créer le corps du travail de Logpush ( logpush_job_DESTINATION_req ) où DESTINATION est l'une des valeurs suivantes :

name: Le nom du travail de connexion.

enabled: Indique si le travail est activé. Les valeurs admises sont true ou false.

logpull_options: La chaîne de configuration. Par exemple, fields=RayID,ZoneID&timestamps=rfc3339.

dataset: fichier extrait. Un des éléments suivants : http_requests, dns_logs, range_events, firewall_events.

frequency: fréquence à laquelle CIS envoie des lots de journaux à votre destination. Les valeurs admises sont high ou low.

1. Lorsque toutes les variables sont initiées, créez le travail logpush :

   IBM Cloud Logs

   curl -X POST https://api.cis.cloud.ibm.com/v2/$CRN/zones/$ZONE_ID/logpush/jobs \
   --header "Content-Type: application/json" \
   --header "X-Auth-User-Token: Bearer $IAM_TOKEN" \
   --data '{
      "ibmcl": {
         "instance_id": "f8k3309c-585c-4a42-955d-76239cccf8k3",
         "region": "us-south",
         "api_key": "f8k3NQI22dPwNVCcmS62YFL1tm9vaehY6C9jxdtnf8k3"
      },
      "ibmcl_names": {
         "application_name": "cis-edge-logs",
         "subsystem_name": "stage-firewall-logs"
      }
      "dataset": "http_requests",
      "enabled": true,
      "logpull_options": "fields=RayID,ZoneID&timestamps=rfc3339",
      "name": "CIS-Edge-Requests",
      "frequency": "low"
   }'
   

   {: pre}
   
   Cloud Object Storage
   :   ```sh
      curl -X POST https://api.cis.cloud.ibm.com/v2/$CRN/zones/$ZONE_ID/logpush/jobs \
      --header "Content-Type: application/json" \
      --header "X-Auth-User-Token: Bearer $IAM_TOKEN" \
      --data '{
         "cos": {
            "bucket_name": "example_bucket",
            "path": "temp/",
            "id": "cos_instance_id",
            "region": "us-east"
         },
         "dataset": "firewall_events",
         "enabled": false,
         "name": "CIS-Firewall-COS",
         "frequency": "low",
         "logpull_options": "fields=RayID,ZoneID&timestamps=rfc3339",
         "ownership_challenge": "xxxxxxx"
      }'
   

   IBM QRadar

   curl -X POST https://api.cis.cloud.ibm.com/v2/$CRN/zones/$ZONE_ID/logpush/jobs \
   --header "Content-Type: application/json" \
   --header "X-Auth-User-Token: Bearer $IAM_TOKEN" \
   --data '{
      "qradar": {
         "url": "https://example.qradar.ibmcloud.com",
         "port": 8088
      },
      "dataset": "firewall_events",
      "enabled": false,
      "name": "CIS-Firewall-QRadar",
      "frequency": "low",
      "logpull_options": "fields=RayID,CacheResponseBytes,CacheResponseStatus,CacheCacheStatus&timestamps=rfc3339"
   }'
   

   {: pre}
   
   Splunk
   :   ```sh
      curl -X POST https://api.cis.cloud.ibm.com/v2/$CRN/zones/$ZONE_ID/logpush/jobs \
      --header "Content-Type: application/json" \
      --header "X-Auth-User-Token: Bearer $IAM_TOKEN" \
      --data '{
         "splunk": {
            "endpoint_url": "example.splunkcloud.com:8088/services/collector/raw",
            "channel_id": "def3c136-7a01-4655-b17f-8e25a780ef2c",
            "skip_verify": false,
            "source_type": "cloudflare:json",
            "auth_token": "Splunk fake3585-0f38-4d62-8b43-c4b78584fake"
         },
         "dataset": "http_requests",
         "enabled": true,
         "name": "CIS-Splunk-Logpush",
         "frequency": "high",
         "logpull_options": "fields=RayID,CacheResponseBytes,CacheResponseStatus,CacheCacheStatus&timestamps=rfc3339"
      }'
   

   Personnalisé HTTP

   curl -X POST https://api.cis.cloud.ibm.com/v2/$CRN/zones/$ZONE_ID/logpush/jobs \
   --header "Content-Type: application/json" \
   --header "X-Auth-User-Token: Bearer $IAM_TOKEN" \
   --data '{
      "destination_conf": "https://logs.example.com?header_Authorization=a64VuywesDu5Aq",
      "dataset": "http_requests",
      "enabled": true,
      "name": "CIS-Custom-Logpush",
      "frequency": "high",
      "logpull_options": "fields=RayID,CacheResponseBytes,CacheResponseStatus,CacheCacheStatus&timestamps=rfc3339"
   }'
   

   {: pre}