Esempi di comando

Esempi di CLI per le destinazioni supportate:

Log IBM Cloud

Esempio

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

Esempio

   ```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

Esempio

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

Esempio

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

Personalizzato HTTP

Esempio

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

Ottenere i campi di log disponibili per un set di dati con l'API

I campi del registro possono essere specificati nel sito logpull_options di un lavoro Logpush per personalizzare l'invio alla destinazione. Per ottenere i campi di log disponibili per un set di dati Logpush, procedere come segue:

1. Configura il tuo ambiente API con le variabili corrette.
2. Memorizza i seguenti valori nelle variabili da utilizzare nel comando API:

CRN: Il CRN completo codificato da URL dell'istanza di servizio.

ZONE_ID: L'ID del dominio.

DATASET: Il set di dati Logpush da ispezionare. Uno di http_requests, range_events, dns_logs, firewall_events.

1. Quando tutte le variabili sono state inizializzate, creare il lavoro 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"'
   

Creare un lavoro Logpush per inviare i log alla propria destinazione

Per creare un lavoro Logpush verso la destinazione ( IBM Cloud Logs, Cloud Object Storage o Splunk ), procedere come segue:

1. Configura il tuo ambiente API con le variabili corrette.
2. Memorizza i seguenti valori nelle variabili da utilizzare nel comando API:

CRN: Il nome completo della risorsa cloud (CRN) codificato da URL dell'istanza del servizio.

ZONE_ID: L'ID del dominio.

--request body: Informazioni per creare il corpo del lavoro Logpush ( logpush_job_DESTINATION_req ) dove DESTINATION è uno dei seguenti valori:

name: Il nome del processo Logpush.

enabled: se il lavoro è abilitato. O true o false.

logpull_options: La stringa di configurazione. Ad esempio, fields=RayID,ZoneID&timestamps=rfc3339.

dataset: il set di dati estratto. Uno di http_requests, dns_logs, range_events, firewall_events.

frequency: La frequenza con cui CIS invia i batch di log alla destinazione specificata. O high o low.

1. Quando tutte le variabili sono state inizializzate, creare il lavoro Logpush:

   Log IBM Cloud

   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"
      }'
   

   Personalizzato 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}