명령 예제

지원되는 목적지에 대한 CLI 예:

IBM Cloud 로그

예

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 Logs, Cloud Object Storage 또는 Splunk )에 생성하려면 다음 단계를 따르십시오

1. 올바른 변수로 API 환경을 설정하십시오.
2. API 명령에 사용할 변수에 다음 값을 저장하십시오.

CRN URL 로 인코딩된 서비스 인스턴스의 전체 클라우드 리소스 이름(CRN).

ZONE_ID: 도메인 ID.

--request body: 로그푸시 작업 본문을 생성하는 정보( 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 로그

   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}