Cloudflare

통합 버전: 2.0

제품 사용 사례

항목 보강 실행

Google Security Operations에서 Cloudflare 통합 구성

Google SecOps에서 통합을 구성하는 방법에 대한 자세한 내용은 통합 구성을 참고하세요.

통합 매개변수

다음 매개변수를 사용하여 통합을 구성합니다.

매개변수 표시 이름 유형 기본값 필수 항목 설명
API 루트 문자열 https://api.cloudflare.com 예 Cloudflare 인스턴스의 API 루트입니다.
API 토큰 비밀번호 해당 사항 없음 예 Cloudflare 인스턴스의 API 토큰입니다.
계정 이름 문자열 해당 사항 없음 예 통합에서 사용해야 하는 계정의 이름입니다.
SSL 확인 체크박스 선택 아니요 사용 설정하면 Cloudflare 서버 연결에 사용되는 SSL 인증서가 유효한지 확인합니다.

토큰 구성 방법

  1. 프로필 설정으로 이동하여 API 토큰을 클릭합니다.
  2. 토큰 만들기> 맞춤 토큰 만들기로 이동하여 다음 권한을 선택합니다.
계정 계정 WAF 읽기
계정 규칙 정책 읽기
계정 계정 필터 목록 수정
계정 계정 방화벽 액세스 수정
계정 DNS 방화벽 읽기
계정 계정 설정 읽기
영역 영역 WAF 수정
영역 영역 설정 읽기
영역 영역 읽기
영역 로그 읽기
영역 방화벽 서비스 수정
영역 방화벽 서비스 읽기
영역 애널리틱스 읽기

필수 권한 목록

작업

규칙 목록에 IP 추가

설명

Cloudflare의 규칙 목록에 IP 주소를 추가합니다. 지원되는 항목: IP 주소

매개변수

매개변수 표시 이름 유형 기본값 필수 항목 설명
규칙 이름 문자열 해당 사항 없음 예 규칙 목록 항목을 추가할 규칙 목록의 이름을 지정합니다.
설명 문자열 해당 사항 없음 아니요 새로 추가된 규칙 목록 항목의 설명을 지정합니다.

실행

이 작업은 IP 주소 항목에서 실행됩니다.

작업 결과

스크립트 결과
스크립트 결과 이름 값 옵션 예
is_success True/False is_success:False
JSON 결과
{
    "result": {
        "operation_id": "f16b978552ca49f88b36fe628de31142"
    },
    "success": true,
    "errors": [],
    "messages": []
}
케이스 월
결과 유형 값 / 설명 유형
출력 메시지*

작업이 실패하거나 플레이북 실행을 중지하지 않습니다.

하나의 항목에 대해 200 상태 코드가 보고된 경우 (is_success=true): 'Cloudflare의 {name} 규칙 목록에 다음 항목을 추가했습니다: {entity.identifier}.'

항목 하나에 대해 성공하지 못한 경우 (is_success=true): '작업이 Cloudflare의 {name} 규칙 목록에 다음 항목을 추가할 수 없습니다. {entity.identifier}.'

모두 성공하지 못한 경우 (is_success=false): '제공된 항목이 {name} 규칙 목록에 추가되지 않았습니다.'

작업이 실패하고 플레이북 실행을 중지합니다.

잘못된 사용자 인증 정보, 서버 연결 없음과 같은 치명적인 오류가 보고되는 경우: ''규칙 목록에 IP 추가' 작업을 실행하는 동안 오류가 발생했습니다. 이유: {0}'.format(error.Stacktrace)

목록을 찾을 수 없는 경우: "'규칙 목록에 IP 추가' 작업을 실행하는 동안 오류가 발생했습니다. 이유: Cloudflare에 규칙 목록 {name}이(가) 없습니다.''

목록이 유효한 종류가 아닌 경우: ''규칙 목록에 IP 추가' 작업을 실행하는 중에 오류가 발생했습니다. 이유: 규칙 목록 {name}이(가) 'IP' 유형이 아닙니다.'

 일반

규칙 목록에 URL 추가

설명

Cloudflare의 규칙 목록에 URL을 추가합니다. 지원되는 항목: URL

매개변수

매개변수 표시 이름 유형 기본값 필수 항목 설명
규칙 이름 문자열 해당 사항 없음 예 규칙 목록 항목을 추가할 규칙 목록의 이름을 지정합니다.
소스 URL 문자열 해당 사항 없음 예 규칙 목록 항목의 소스 URL을 지정합니다.
설명 문자열 해당 사항 없음 아니요 새로 추가된 규칙 목록 항목의 설명을 지정합니다.
상태 코드 DDL

301

가능한 값은 다음과 같습니다.

  • 301
  • 302
  • 307
  • 308
 아니요 규칙 목록 항목의 상태를 지정합니다.
쿼리 문자열 유지 체크박스 선택 해제 아니요 사용 설정하면 규칙 목록 항목이 쿼리 문자열을 유지합니다.
하위 도메인 포함 체크박스 선택 해제 아니요 사용 설정된 경우 규칙 목록 항목에 하위 도메인이 포함됩니다.
하위 경로 일치 체크박스 선택 해제 아니요 사용 설정된 경우 규칙 목록 항목이 하위 경로와 일치합니다.
경로 서픽스 보존 체크박스 선택 해제 아니요 사용 설정된 경우 규칙 목록 항목은 경로 접미사를 유지합니다.

실행

이 작업은 IP 주소 항목에서 실행됩니다.

작업 결과

스크립트 결과
스크립트 결과 이름 값 옵션 예
is_success True/False is_success:False
JSON 결과
{
    "result": {
        "operation_id": "f16b978552ca49f88b36fe628de31142"
    },
    "success": true,
    "errors": [],
    "messages": []
}
케이스 월
결과 유형 값 / 설명 유형
출력 메시지*

작업이 실패하거나 플레이북 실행을 중지하지 않습니다.

하나의 항목에 200 상태 코드가 있는 경우 (is_success=true): 'Cloudflare의 {name} 규칙 목록에 다음 항목을 추가했습니다. {entity.identifier}.'

항목 하나에 대해 성공하지 못한 경우 (is_success=true): '작업이 Cloudflare의 {name} 규칙 목록에 다음 항목을 추가할 수 없습니다. {entity.identifier}.'

모든 항목에 성공하지 못한 경우 (is_success=false): '제공된 항목이 {name} 규칙 목록에 추가되지 않았습니다.'

작업이 실패하고 플레이북 실행을 중지합니다.

잘못된 사용자 인증 정보, 서버 연결 없음과 같은 치명적인 오류가 보고되는 경우: ''규칙 목록에 URL 추가' 작업 실행 중에 오류가 발생했습니다. 이유: {0}'.format(error.Stacktrace)

목록을 찾을 수 없는 경우: "'규칙 목록에 URL 추가' 작업을 실행하는 동안 오류가 발생했습니다. 이유: Cloudflare에 규칙 목록 {name}이(가) 없습니다.''

목록이 유효한 종류가 아닌 경우: "'규칙 목록에 URL 추가' 작업을 실행하는 동안 오류가 발생했습니다. 이유: 규칙 목록 {name}이(가) '리디렉션' 유형이 아닙니다.'

 일반

방화벽 규칙 만들기

설명

Cloudflare에서 방화벽 규칙을 만듭니다.

매개변수

매개변수 표시 이름 유형 기본값 필수 항목 설명
영역 이름 문자열 해당 사항 없음 예 방화벽 규칙이 포함된 영역의 이름을 지정합니다.
이름 문자열 해당 사항 없음 아니요 방화벽 규칙의 이름을 지정합니다.
작업 DDL

차단

가능한 값은 다음과 같습니다.

  • 허용
  • 차단
  • 우회
  • 로그
  • 레거시 보안문자
  • 관리형 챌린지
  • JS 챌린지
 아니요

방화벽 규칙의 작업을 지정합니다.

'차단'을 선택한 경우 '제품' 매개변수에 값을 제공해야 합니다.
표현식 문자열 해당 사항 없음 예 방화벽 규칙의 표현식을 지정합니다.
제품 CSV 해당 사항 없음 아니요

방화벽 규칙에 사용할 제품의 쉼표로 구분된 목록을 지정합니다.

참고: 이 매개변수는 '작업' 매개변수에 '우회'가 선택된 경우에만 필수입니다.

가능한 값: zoneLockdown, uaBlock, bic, hot, securityLevel, rateLimit, waf
우선순위 정수 해당 사항 없음 아니요 방화벽 규칙의 우선순위를 지정합니다.
참조 태그 문자열 해당 사항 없음 아니요

방화벽 규칙의 참조 태그를 지정합니다.

참고: 최대 50자(영문 기준)까지 가능합니다.

실행

이 작업은 항목에서 실행되지 않습니다.

작업 결과

스크립트 결과
스크립트 결과 이름 값 옵션 예
is_success True/False is_success:False
JSON 결과
{
        {
            "id": "b520c154bdeb4fe2a1f647b2c6b35829",
            "paused": false,
            "description": "Blocks traffic identified during investigation for MIR-31",
            "action": "block",
            "priority": 50,
            "filter": {
                "id": "fc6dfad848c24a42ae5be0114db09fb9",
                "expression": "(ip.geoip.continent eq \"ASIA\")",
                "paused": false
            },
            "created_on": "2022-07-25T11:19:22Z",
            "modified_on": "2022-07-25T11:19:22Z",
            "index": 0
        }
}
케이스 월
결과 유형 값 / 설명 유형
출력 메시지*

작업이 실패하거나 플레이북 실행을 중지하지 않습니다.

200 상태 코드가 보고된 경우 (is_success=true): 'Cloudflare의 '{zone_name}' 영역에 새 방화벽 규칙을 만들었습니다.'

작업이 실패하고 플레이북 실행을 중지합니다.

잘못된 사용자 인증 정보, 서버 연결 없음과 같은 치명적인 오류가 보고되는 경우: ''방화벽 규칙 만들기' 작업 실행 중에 오류가 발생했습니다.' 이유: {0}'.format(error.Stacktrace)

오류 목록이 비어 있지 않은 경우: "Error executing action "Create Firewall Rule". 이유: {0}''.format(errors/message)

영역을 찾을 수 없는 경우: "'방화벽 규칙 만들기' 작업을 실행하는 동안 오류가 발생했습니다. 이유: Cloudflare에 {zone_name} 영역이 없습니다.''

 일반

규칙 목록 만들기

설명

Cloudflare에서 규칙 목록을 만듭니다.

매개변수

매개변수 표시 이름 유형 기본값 필수 항목 설명
이름 문자열 해당 사항 없음 예 규칙 목록의 이름을 지정합니다.
유형 DDL

IP 주소

가능한 값은 다음과 같습니다.

  • IP 주소
  • 리디렉션
 아니요 규칙 목록의 유형을 지정합니다.
설명 문자열 해당 사항 없음 아니요 규칙 목록의 설명을 지정합니다.

실행

이 작업은 항목에서 실행되지 않습니다.

작업 결과

스크립트 결과
스크립트 결과 이름 값 옵션 예
is_success True/False is_success:False
JSON 결과
{
    "id": "d19589d629f140c0b961c467feadf99d",
    "name": "123",
    "kind": "ip",
    "num_items": 0,
"description": "description",
    "num_referencing_filters": 0,
    "created_on": "2022-07-25T12:13:46Z",
    "modified_on": "2022-07-25T12:13:46Z"
}
케이스 월
결과 유형 값 / 설명 유형
출력 메시지*

작업이 실패하거나 플레이북 실행을 중지하지 않습니다.

200 상태 코드가 보고된 경우 (is_success = true): 'Cloudflare에서 규칙 목록을 만들었습니다.'

작업이 실패하고 플레이북 실행을 중지합니다.

잘못된 사용자 인증 정보, 서버 연결 없음과 같은 치명적인 오류가 보고되는 경우: ''규칙 목록 만들기' 작업 실행 중에 오류가 발생했습니다.' 이유: {0}'.format(error.Stacktrace)

오류 목록이 비어 있지 않은 경우: "Error executing action "Create Rule List". 이유: {0}''.format(errors/message)

 일반

항목 보강

설명

Cloudflare의 정보를 사용하여 항목을 보강합니다. 지원되는 항목: URL, IP, 호스트 이름

매개변수

해당 사항 없음

실행

이 작업은 다음 항목에서 실행됩니다.

  • IP 주소
  • URL
  • 호스트 이름

작업 결과

스크립트 결과
스크립트 결과 이름 값 옵션 예
is_success True/False is_success:False
JSON 결과
IP 주소의 JSON 결과
{
    "ip": "192.0.2.0",
    "belongs_to_ref": {
      "id": "autonomous-system--2fa28d71-3549-5a38-af05-770b79ad6ea8",
      "value": 13335,
      "type": "hosting_provider",
      "country": "US",
      "description": "CLOUDFLARENET"
    },
    "risk_types": [
      {
        "id": 131,
        "super_category_id": 21,
        "name": "Phishing"
      }
    ]
}
URL의 JSON 결과
{
    "url": "https://www.cloudflare.com",
    "phishing": false,
    "verified": false,
    "score": 0.99,
    "classifier": "MACHINE_LEARNING_v2"
}
호스트 이름의 JSON 결과
{
    "domain": "cloudflare.com",
    "created_date": "2009-02-17",
    "updated_date": "2017-05-24",
    "registrant": "DATA REDACTED",
    "registrant_org": "DATA REDACTED",
    "registrant_country": "United States",
    "registrant_email": "https://domaincontact.cloudflareregistrar.com/cloudflare.com",
    "registrar": "Cloudflare, Inc.",
    "nameservers": [
      "ns3.cloudflare.com",
      "ns4.cloudflare.com",
      "ns5.cloudflare.com",
      "ns6.cloudflare.com",
      "ns7.cloudflare.com"
    ]
}
케이스 월
결과 유형 값 / 설명 유형
출력 메시지*

작업이 실패하거나 플레이북 실행을 중지하지 않습니다.

항목 하나에 200 상태 코드가 보고된 경우 (is_success=true): 'Cloudflare: {entity.identifier}에서 다음 항목을 성공적으로 보강했습니다.'

항목 하나에 성공하지 못한 경우 (is_success=true): '작업이 Cloudflare: {entity.identifier}에서 다음 항목을 보강할 수 없습니다.'

모든 항목에 대해 성공하지 못한 경우 (is_success=false): '제공된 항목이 보강되지 않았습니다.'

IP에 대해 403 상태 코드가 보고된 경우 (하나 이상의 항목이 보강된 경우 is_success=true, 그렇지 않은 경우 is_success=false): 'IP를 보강하려면 Cloudflare 계정에서 'IP 개요' 기능이 사용 설정되어 있어야 합니다.'

호스트 이름에 403 상태 코드가 보고된 경우

(하나 이상의 항목이 보강된 경우 is_success=true, 그렇지 않은 경우 is_success=false): '도메인을 보강하려면 Cloudflare 계정에서 'WHOIS' 기능을 사용 설정해야 합니다.'

URL에 대해 403 상태 코드가 보고된 경우 (하나 이상의 항목이 보강된 경우 is_success=true, 그렇지 않은 경우 is_success=false): 'URL을 보강하려면 Cloudflare 계정에서 '피싱 URL 스캐너' 기능을 사용 설정해야 합니다.'

작업이 실패하고 플레이북 실행을 중지합니다.

잘못된 사용자 인증 정보, 서버 연결 없음과 같은 치명적인 오류가 보고되는 경우: ''항목 보강' 작업 실행 중에 오류가 발생했습니다. 이유: {0}'.format(error.Stacktrace)

모든 항목에 대해 403 상태 코드가 보고된 경우 (is_success=false): 'Cloudflare 계정에서 '피싱 URL 스캐너', 'WHOIS', 'IP 개요' 기능을 사용 설정해야 합니다.'

 일반

방화벽 규칙 나열

설명

Cloudflare에서 사용 가능한 방화벽 규칙을 나열합니다.

매개변수

매개변수 표시 이름 유형 기본값 필수 항목 설명
영역 이름 문자열 해당 사항 없음 예 방화벽 규칙이 포함될 영역의 이름을 지정합니다.
필터 키 DDL

다음 중 하나를 선택하세요.

가능한 값은 다음과 같습니다.

  • 다음 중 하나를 선택하세요.
  • 이름
  • ID
  • 작업
 아니요 {항목 유형}을 필터링하는 데 사용할 키를 지정하세요.
필터 로직 DDL

다음 중 하나를 선택하세요.

가능한 값은 다음과 같습니다.

  • 다음 중 하나를 선택하세요.
  • 같음
  • 포함
 아니요

적용할 필터 로직을 지정합니다.

필터링 로직은 '필터 키' 매개변수에 제공된 값을 기반으로 합니다.
필터 값 문자열 해당 사항 없음 아니요

필터에 사용해야 하는 값을 지정합니다.

'같음'을 선택하면 작업에서 결과 중 정확한 일치 항목을 찾으려고 시도합니다.

'포함'을 선택하면 작업에서 해당 하위 문자열을 포함하는 결과를 찾으려고 시도합니다.

이 매개변수에 아무것도 제공되지 않으면 필터가 적용되지 않습니다.

필터링 로직은 '필터 키' 매개변수에 제공된 값을 기반으로 합니다.
반환할 최대 레코드 수 정수 50 아니요

반환할 레코드 수를 지정합니다.

아무것도 제공되지 않으면 작업에서 50개의 레코드를 반환합니다.

실행

이 작업은 항목에서 실행되지 않습니다.

작업 결과

스크립트 결과
스크립트 결과 이름 값 옵션 예
is_success True/False is_success:False
JSON 결과
{
    "id": "55ec8db30f9e4640b5d0d13cff6b5429",
    "paused": false,
    "description": "rulle2",
    "action": "allow",
    "filter": {
        "id": "2bb05df8c4f547bd9792d8dc38a86b81",
        "expression": "(ip.geoip.country eq \"BG\")",
        "paused": false
    },
    "created_on": "2022-07-05T13:53:39Z",
    "modified_on": "2022-07-05T13:53:39Z"
}
케이스 월
결과 유형 값 / 설명 유형
출력 메시지*

작업이 실패하거나 플레이북 실행을 중지하지 않습니다.

데이터를 사용할 수 있는 경우 (is_success=true): '{product name}에서 제공된 기준에 맞는 {item name}을 찾았습니다.'

데이터를 사용할 수 없는 경우 (is_success=false): '{product name}에서 제공된 기준에 맞는 {item name}을 찾을 수 없습니다.'

'필터 값' 매개변수가 비어 있는 경우 (is_success=true):

'매개변수 '필터 값'이 비어 있어 필터가 적용되지 않았습니다.'

작업이 실패하고 플레이북 실행을 중지합니다.

'필터 키' 매개변수가 '하나 선택'으로 설정되고 '필터 논리' 매개변수가 '같음' 또는 '포함'으로 설정된 경우:

'{작업 이름} 작업을 실행하는 동안 오류가 발생했습니다. 이유: '필터 키' 매개변수에서 필드를 선택해야 합니다.'

'반환할 최대 레코드 수' 매개변수에 잘못된 값이 제공된 경우: '{작업 이름}' 작업을 실행하는 중에 오류가 발생했습니다. 이유: '반환할 최대 레코드'에 잘못된 값이 제공되었습니다. 양수를 입력해야 합니다.'

잘못된 사용자 인증 정보, 서버 연결 없음과 같은 치명적인 오류가 보고되는 경우: ''{작업 이름}' 작업 실행 중에 오류가 발생했습니다. 이유: {0}'.format(error.Stacktrace)

 일반
케이스 월 테이블

표 이름: 사용 가능한 {상품 그룹}

표 열: {fields}

 일반

핑

설명

Google Security Operations Marketplace 탭의 통합 구성 페이지에서 제공된 매개변수를 사용하여 Cloudflare에 대한 연결을 테스트합니다.

매개변수

해당 사항 없음

실행

작업은 Google SecOps 범위 항목을 사용하지 않으며 필수 입력 매개변수가 없습니다.

작업 결과

스크립트 결과
스크립트 결과 이름 값 옵션 예
is_success True/False is_success:False
JSON 결과
N/A
케이스 월
결과 유형 값 / 설명 유형
출력 메시지*

작업이 실패하거나 플레이북 실행을 중지하지 않습니다.

성공한 경우: '제공된 연결 매개변수를 사용하여 SpyCloud 서버에 성공적으로 연결되었습니다.'

작업이 실패하고 플레이북 실행을 중지합니다.

실패한 경우: 'SpyCloud 서버에 연결할 수 없습니다. 오류: {0}".format(exception.stacktrace)

계정을 찾을 수 없는 경우: 'Cloudflare 서버에 연결할 수 없습니다. 잘못된 계정 이름이 제공되었습니다. 철자를 확인하세요."

 일반

방화벽 규칙 업데이트

설명

Cloudflare에서 방화벽 규칙을 업데이트합니다.

실행

이 작업은 항목에서 실행되지 않습니다.

매개변수

매개변수 표시 이름 유형 기본값 필수 항목 설명
규칙 이름 문자열 해당 사항 없음 예 업데이트해야 하는 규칙의 이름을 지정합니다.
영역 이름 문자열 해당 사항 없음 예 방화벽 규칙이 포함된 영역의 이름을 지정합니다.
작업 DDL

차단

가능한 값은 다음과 같습니다.

  • 허용
  • 차단
  • 우회
  • 로그
  • 레거시 보안문자
  • 관리형 챌린지
  • JS 챌린지
 아니요

방화벽 규칙의 작업을 지정합니다.

'차단'을 선택한 경우 '제품' 매개변수에 값을 제공해야 합니다.
표현식 문자열 해당 사항 없음 예 방화벽 규칙의 표현식을 지정합니다.
제품 CSV 해당 사항 없음 아니요

방화벽 규칙에 사용할 제품의 쉼표로 구분된 목록을 지정합니다.

참고: 이 매개변수는 '작업' 매개변수에 '우회'가 선택된 경우에만 필수입니다.

가능한 값: zoneLockdown, uaBlock, bic, hot, securityLevel, rateLimit, waf
우선순위 정수 해당 사항 없음 아니요 방화벽 규칙의 우선순위를 지정합니다.
참조 태그 문자열 해당 사항 없음 아니요

방화벽 규칙의 참조 태그를 지정합니다.

참고: 최대 50자(영문 기준)까지 가능합니다.

실행

작업 결과

스크립트 결과
스크립트 결과 이름 값 옵션 예
is_success True/False is_success:False
JSON 결과
{
        {
            "id": "b520c154bdeb4fe2a1f647b2c6b35829",
            "paused": false,
            "description": "Blocks traffic identified during investigation for MIR-31",
            "action": "block",
            "priority": 50,
            "filter": {
                "id": "fc6dfad848c24a42ae5be0114db09fb9",
                "expression": "(ip.geoip.continent eq \"ASIA\")",
                "paused": false
            },
            "created_on": "2022-07-25T11:19:22Z",
            "modified_on": "2022-07-25T11:19:22Z",
            "index": 0
        }
}
케이스 월
결과 유형 값 / 설명 유형
출력 메시지*

작업이 실패하거나 플레이북 실행을 중지하지 않습니다.

200 상태 코드가 보고된 경우 (is_success=true): 'Cloudflare의 '{zone_name}' 영역에서 방화벽 규칙을 업데이트했습니다.'

작업이 실패하고 플레이북 실행을 중지합니다.

잘못된 사용자 인증 정보, 서버 연결 없음과 같은 치명적인 오류가 보고되는 경우: ''방화벽 규칙 업데이트' 작업 실행 중에 오류가 발생했습니다.' 이유: {0}'.format(error.Stacktrace)

오류 목록이 비어 있지 않은 경우: "'방화벽 규칙 업데이트' 작업을 실행하는 동안 오류가 발생했습니다. 이유: {0}''.format(errors/message)

영역을 찾을 수 없는 경우: "'방화벽 규칙 업데이트' 작업을 실행하는 동안 오류가 발생했습니다. 이유: Cloudflare에 {zone_name} 영역이 없습니다.''

 일반

도움이 더 필요하신가요? 커뮤니티 회원 및 Google SecOps 전문가로부터 답변을 받으세요.