命令示例

CLI示例支持的目的地：

IBM Cloud Logs

示例

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

示例

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

示例

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

示例

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

自定义 HTTP

示例

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

使用API获取数据集的可用日志字段

日志字段可以在Logpush作业的 logpull_options 中指定，以自定义发送到目的地的内容。 要获取Logpush数据集的可用日志字段，请按照以下步骤操作：

1. 使用正确的变量设置 API 环境。
2. 在变量中存储以下值，以便在 API 命令中使用：

CRN：服务实例的完整 URL 编码CRN。

ZONE_ID: 域名 ID。

DATASET：正在检查Logpush数据集。 http_requests, range_events, dns_logs, firewall_events 中的一个。

1. 启动所有变量后，创建 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"'
   

创建一个Logpush任务，将日志发送到您的目的地

要创建一个目标为（ IBM Cloud 日志、Cloud Object Storage 或 Splunk ）的 Logpush 作业，请按照以下步骤操作：

1. 使用正确的变量设置 API 环境。
2. 在变量中存储以下值，以便在 API 命令中使用：

CRN：服务实例的完整 URL 编码云资源名称（CRN）。

ZONE_ID: 域名 ID。

--request body：创建Logpush作业正文的信息（ logpush_job_DESTINATION_req ），其中 DESTINATION 为以下值之一：

name：Logpush 工作的名称。

enabled：工作是否已启用。 true 或 false。

logpull_options：配置字符串。 例如，fields=RayID,ZoneID&timestamps=rfc3339。

dataset：提取的数据集。 http_requests, dns_logs, range_events, firewall_events 中的一个。

frequency: CIS 向您的目标位置发送日志批次的频率。 high 或 low。

1. 启动所有变量后，创建 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"
      }'
   

   自定义 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}