このページは Cloud Translation API によって翻訳されました。

Cloudflare

統合バージョン: 2.0

プロダクトのユースケース

エンティティの拡充を実行する

Google Security Operations で Cloudflare インテグレーションを構成する

Google SecOps で統合を構成する方法について詳しくは、統合を構成するをご覧ください。

統合のパラメータ

次のパラメータを使用して統合を構成します。

パラメータの表示名	種類	デフォルト値	必須	説明
API ルート	文字列	`https://api.cloudflare.com`	はい	Cloudflare インスタンスの API ルート。
API トークン	パスワード	なし	はい	Cloudflare インスタンスの API トークン。
Account Name	文字列	なし	はい	統合で使用する必要があるアカウントの名前。
SSL を確認する	チェックボックス	オン	いいえ	有効にすると、Cloudflare サーバーへの接続用の SSL 証明書が有効であることを確認します。

トークンを構成する方法

[Profile Settings] に移動し、[API Tokens] をクリックします。
[Create Token > Create Custom Token] に移動し、次の権限を選択します。

アカウント	アカウント WAF	読み取り
アカウント	ルールポリシー	読み取り
アカウント	アカウントフィルタリスト	編集
アカウント	アカウントのファイアウォールアクセス	編集
アカウント	DNS ファイアウォール	読み取り
アカウント	アカウント設定	読み取り
ゾーン	ゾーン WAF	編集
ゾーン	ゾーンの設定	読み取り
ゾーン	ゾーン	読み取り
ゾーン	ログ	読み取り
ゾーン	ファイアウォールサービス	編集
ゾーン	ファイアウォールサービス	読み取り
ゾーン	アナリティクス	読み取り

必要な権限のリスト

操作

ルールリストに IP を追加する

説明

Cloudflare のルールリストに IP アドレスを追加します。サポートされているエンティティ: IP アドレス。

パラメータ

パラメータの表示名	種類	デフォルト値	必須	説明
ルール名	文字列	なし	はい	ルールリストアイテムを追加するルールリストの名前を指定します。
説明	文字列	なし	いいえ	新しく追加されたルールリストアイテムの説明を指定します。

実行

このアクションは IP アドレスエンティティに対して実行されます。

アクションの結果

スクリプトの結果

スクリプトの結果名	値のオプション	例
is_success	True/False	is_success:False

JSON の結果

{
    "result": {
        "operation_id": "f16b978552ca49f88b36fe628de31142"
    },
    "success": true,
    "errors": [],
    "messages": []
}

Case Wall

結果のタイプ	値 / 説明	種類
出力メッセージ *	アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。 1 つのエンティティについて 200 ステータスコードが報告された場合（is_success=true）: 「次のエンティティが Cloudflare の {name} ルールリストに正常に追加されました: {entity.identifier}。」 1 つのエンティティで成功しなかった場合（is_success=true）: 「Cloudflare の {name} ルールリストに次のエンティティを追加できませんでした: {entity.identifier}。」すべてで成功しなかった場合（is_success=false）: 「指定されたエンティティは {name} ルールリストに追加されませんでした。」アクションが失敗し、ハンドブックの実行が停止します。認証情報の誤り、サーバーへの接続がないなどの致命的なエラーが報告された場合: 「アクション「ルールリストに IP を追加」の実行中にエラーが発生しました」。理由: {0}」.format(error.Stacktrace) リストが見つからない場合: 「"ルールリストに IP を追加"という操作の実行中にエラーが発生しました。理由: ルールリスト {name} が Cloudflare で見つかりませんでした。リストが有効な種類でない場合: 「アクション「ルールリストに IP を追加」の実行エラー。理由: ルールリスト {name} のタイプが「IP」ではありません。」	全般

結果のタイプ

値 / 説明

種類

出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

1 つのエンティティについて 200 ステータスコードが報告された場合（is_success=true）: 「次のエンティティが Cloudflare の {name} ルールリストに正常に追加されました: {entity.identifier}。」

1 つのエンティティで成功しなかった場合（is_success=true）: 「Cloudflare の {name} ルールリストに次のエンティティを追加できませんでした: {entity.identifier}。」

すべてで成功しなかった場合（is_success=false）: 「指定されたエンティティは {name} ルールリストに追加されませんでした。」

アクションが失敗し、ハンドブックの実行が停止します。

認証情報の誤り、サーバーへの接続がないなどの致命的なエラーが報告された場合: 「アクション「ルールリストに IP を追加」の実行中にエラーが発生しました」。理由: {0}」.format(error.Stacktrace)

リストが見つからない場合: 「"ルールリストに IP を追加"という操作の実行中にエラーが発生しました。理由: ルールリスト {name} が Cloudflare で見つかりませんでした。

リストが有効な種類でない場合: 「アクション「ルールリストに 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": []
}

Case Wall

結果のタイプ	値 / 説明	種類
出力メッセージ *	アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。 1 つのエンティティについて 200 ステータスコードが報告された場合（is_success=true）: 「次のエンティティが Cloudflare の {name} ルールリストに正常に追加されました: {entity.identifier}。」 1 つのエンティティで成功しなかった場合（is_success=true）: 「Cloudflare の {name} ルールリストに次のエンティティを追加できませんでした: {entity.identifier}。」すべてのエンティティで成功しなかった場合（is_success=false）: 「指定されたエンティティは {name} ルールリストに追加されませんでした。」アクションが失敗し、ハンドブックの実行が停止します。認証情報の誤り、サーバーへの接続がないなどの致命的なエラーが報告された場合: 「アクション「ルールリストに URL を追加」の実行エラー。理由: {0}」.format(error.Stacktrace) リストが見つからない場合: 「"ルールリストに URL を追加" という操作の実行中にエラーが発生しました。理由: ルールリスト {name} が Cloudflare で見つかりませんでした。リストが有効な種類でない場合: 「アクション「ルールリストに URL を追加」の実行エラー。理由: ルールリスト {name} のタイプが「Redirect」ではありません。	全般

結果のタイプ

値 / 説明

種類

出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

すべてのエンティティで成功しなかった場合（is_success=false）: 「指定されたエンティティは {name} ルールリストに追加されませんでした。」

アクションが失敗し、ハンドブックの実行が停止します。

認証情報の誤り、サーバーへの接続がないなどの致命的なエラーが報告された場合: 「アクション「ルールリストに URL を追加」の実行エラー。理由: {0}」.format(error.Stacktrace)

リストが見つからない場合: 「"ルールリストに URL を追加" という操作の実行中にエラーが発生しました。理由: ルールリスト {name} が Cloudflare で見つかりませんでした。

リストが有効な種類でない場合: 「アクション「ルールリストに URL を追加」の実行エラー。理由: ルールリスト {name} のタイプが「Redirect」ではありません。

全般

ファイアウォールルールの作成

説明

Cloudflare でファイアウォールルールを作成します。

パラメータ

パラメータの表示名	種類	デフォルト値	必須	説明
ゾーン名	文字列	なし	はい	ファイアウォールルールを含むゾーンの名前を指定します。
名前	文字列	なし	いいえ	ファイアウォールルールの名前を指定します。
アクション	DDL	ブロック有効な値: 許可ブロックバイパスするログ以前の CAPTCHA Managed Challenge JS チャレンジ	いいえ	ファイアウォールルールのアクションを指定します。 [ブロック] を選択した場合は、[プロダクト] パラメータに値を指定する必要があります。
式	文字列	なし	はい	ファイアウォールルールの式を指定します。
プロダクト	CSV	なし	いいえ	ファイアウォールルールのプロダクトのカンマ区切りリストを指定します。注: このパラメータは、[アクション] パラメータに [バイパス] が選択されている場合にのみ必須です。有効な値: zoneLockdown、uaBlock、bic、hot、securityLevel、rateLimit、waf
優先度	Integer	なし	いいえ	ファイアウォールルールの優先度を指定します。
参照タグ	文字列	なし	いいえ	ファイアウォールルールの参照タグを指定します。注: 最大 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
        }
}

Case Wall

結果のタイプ	値 / 説明	種類
出力メッセージ *	アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。 200 ステータスコードが報告された場合（is_success=true）: 「Cloudflare のゾーン「{zone_name}」に新しいファイアウォールルールが正常に作成されました。」アクションが失敗し、ハンドブックの実行が停止します。間違った認証情報、サーバーへの接続なし、その他など、致命的なエラーが報告された場合:「アクション「ファイアウォールルールの作成」の実行エラー。理由: {0}」.format(error.Stacktrace) エラーリストが空でない場合: 「アクション「ファイアウォールルールの作成」の実行中にエラーが発生しました。理由: {0}」.format(errors/message) ゾーンが見つからない場合: 「"ファイアウォールルールの作成"という操作の実行中にエラーが発生しました。理由: ゾーン {zone_name} が Cloudflare で見つかりませんでした。	全般

結果のタイプ

値 / 説明

種類

出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

200 ステータスコードが報告された場合（is_success=true）: 「Cloudflare のゾーン「{zone_name}」に新しいファイアウォールルールが正常に作成されました。」

アクションが失敗し、ハンドブックの実行が停止します。

間違った認証情報、サーバーへの接続なし、その他など、致命的なエラーが報告された場合:「アクション「ファイアウォールルールの作成」の実行エラー。理由: {0}」.format(error.Stacktrace)

エラーリストが空でない場合: 「アクション「ファイアウォールルールの作成」の実行中にエラーが発生しました。理由: {0}」.format(errors/message)

ゾーンが見つからない場合: 「"ファイアウォールルールの作成"という操作の実行中にエラーが発生しました。理由: ゾーン {zone_name} が Cloudflare で見つかりませんでした。

全般

ルールリストを作成する

説明

Cloudflare でルールリストを作成します。

パラメータ

パラメータの表示名	種類	デフォルト値	必須	説明
名前	文字列	なし	はい	ルールリストの名前を指定します。
タイプ	DDL	IP アドレス有効な値: IP アドレスリダイレクト	いいえ	ルールリストのタイプを指定します。
説明	文字列	なし	いいえ	ルールリストの説明を指定します。

パラメータの表示名

種類

デフォルト値

必須

説明

名前

文字列

なし

はい

ルールリストの名前を指定します。

タイプ

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

Case Wall

結果のタイプ	値 / 説明	種類
出力メッセージ *	アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。 200 ステータスコードが報告された場合（is_success = true）: 「Cloudflare でルールリストが正常に作成されました。」アクションが失敗し、ハンドブックの実行が停止します。認証情報の誤り、サーバーへの接続がないなどの致命的なエラーが報告された場合: 「操作「ルールリストの作成」の実行中にエラーが発生しました」。理由: {0}」.format(error.Stacktrace) エラーリストが空でない場合: 「アクション「ルールリストの作成」の実行中にエラーが発生しました。理由: {0}」.format(errors/message)	全般

結果のタイプ

値 / 説明

種類

出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

200 ステータスコードが報告された場合（is_success = true）: 「Cloudflare でルールリストが正常に作成されました。」

アクションが失敗し、ハンドブックの実行が停止します。

認証情報の誤り、サーバーへの接続がないなどの致命的なエラーが報告された場合: 「操作「ルールリストの作成」の実行中にエラーが発生しました」。理由: {0}」.format(error.Stacktrace)

エラーリストが空でない場合: 「アクション「ルールリストの作成」の実行中にエラーが発生しました。理由: {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"
    ]
}

ケースウォール

結果のタイプ	値 / 説明	種類
出力メッセージ *	アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。 1 つのエンティティについて 200 ステータスコードが報告された場合（is_success=true）: 「Cloudflare で次のエンティティが正常に拡充されました: {entity.identifier}。」 1 つのエンティティで成功しなかった場合（is_success=true）: 「Cloudflare で次のエンティティを拡充できませんでした: {entity.identifier}。」すべてのエンティティで成功しなかった場合（is_success=false）: 「指定されたエンティティが拡充されませんでした。」 IP について 403 ステータスコードが報告された場合（少なくとも 1 つのエンティティが拡充された場合は is_success=true、それ以外の場合は is_success=false）: 「IP を拡充するには、Cloudflare アカウントで「IP の概要」機能を有効にする必要があります。」 Hostname で 403 ステータスコードが報告された場合（少なくとも 1 つのエンティティが拡充された場合は is_success=true、それ以外の場合は is_success=false）: 「ドメインを拡充するには、Cloudflare アカウントで「WHOIS」機能を有効にする必要があります。」 URL について 403 ステータスコードが報告された場合（少なくとも 1 つのエンティティが拡充された場合は is_success=true、それ以外の場合は is_success=false）: 「URL を拡充するには、Cloudflare アカウントで「フィッシング URL スキャナ」機能を有効にする必要があります。」アクションが失敗し、ハンドブックの実行が停止します。認証情報の誤り、サーバーへの接続がないなどの致命的なエラーが報告された場合: 「アクション「エンティティの拡充」の実行中にエラーが発生しました」。理由: {0}」.format(error.Stacktrace) すべてのエンティティで 403 ステータスコードが報告された場合（is_success=false）: 「Cloudflare アカウントで「フィッシング URL スキャナ」、「WHOIS」、「IP 概要」の機能を有効にする必要があります。」	全般

結果のタイプ

値 / 説明

種類

出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

1 つのエンティティについて 200 ステータスコードが報告された場合（is_success=true）: 「Cloudflare で次のエンティティが正常に拡充されました: {entity.identifier}。」

1 つのエンティティで成功しなかった場合（is_success=true）: 「Cloudflare で次のエンティティを拡充できませんでした: {entity.identifier}。」

すべてのエンティティで成功しなかった場合（is_success=false）: 「指定されたエンティティが拡充されませんでした。」

IP について 403 ステータスコードが報告された場合（少なくとも 1 つのエンティティが拡充された場合は is_success=true、それ以外の場合は is_success=false）: 「IP を拡充するには、Cloudflare アカウントで「IP の概要」機能を有効にする必要があります。」

Hostname で 403 ステータスコードが報告された場合

（少なくとも 1 つのエンティティが拡充された場合は is_success=true、それ以外の場合は is_success=false）: 「ドメインを拡充するには、Cloudflare アカウントで「WHOIS」機能を有効にする必要があります。」

URL について 403 ステータスコードが報告された場合（少なくとも 1 つのエンティティが拡充された場合は is_success=true、それ以外の場合は is_success=false）: 「URL を拡充するには、Cloudflare アカウントで「フィッシング URL スキャナ」機能を有効にする必要があります。」

アクションが失敗し、ハンドブックの実行が停止します。

認証情報の誤り、サーバーへの接続がないなどの致命的なエラーが報告された場合: 「アクション「エンティティの拡充」の実行中にエラーが発生しました」。理由: {0}」.format(error.Stacktrace)

すべてのエンティティで 403 ステータスコードが報告された場合（is_success=false）: 「Cloudflare アカウントで「フィッシング URL スキャナ」、「WHOIS」、「IP 概要」の機能を有効にする必要があります。」

全般

ファイアウォールルールの一覧を取得する

説明

Cloudflare で使用可能なファイアウォールルールを一覧表示します。

パラメータ

パラメータの表示名	種類	デフォルト値	必須	説明
ゾーン名	文字列	なし	はい	ファイアウォールルールを含むゾーンの名前を指定します。
フィルタキー	DDL	1 つ選択有効な値: 1 つ選択名前 ID アクション	いいえ	{アイテムタイプ} のフィルタリングに使用する必要があるキーを指定します。
フィルタロジック	DDL	1 つ選択有効な値: 1 つ選択してください等しい Contains	いいえ	適用するフィルタロジックを指定します。フィルタリングロジックは、「フィルタキー」パラメータで指定される値に基づいています。
フィルタ値	文字列	なし	いいえ	フィルタで使用する値を指定します。「Equal」が選択されている場合、アクションは結果から完全一致を探します。「Contains」が選択されている場合、アクションは指定された部分文字列を含む結果を検索します。このパラメータに何も指定しない場合、フィルタは適用されません。フィルタリングロジックは、「フィルタキー」パラメータで指定される値に基づいています。
返されるレコードの最大数	整数	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"
}

Case Wall

結果のタイプ	値 / 説明	種類
出力メッセージ *	アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。データが利用可能な場合（is_success=true）:「{product name} で指定された条件に該当する {item name} が正常に見つかりました。」データが利用できない場合（is_success=false）:「{product name} で指定された条件に該当する {item name} が見つかりませんでした。」「フィルタ値」パラメータが空の場合（is_success=true）: 「パラメータ「フィルタ値」の値が空であるため、フィルタは適用されませんでした。」アクションが失敗し、ハンドブックの実行が停止します。「フィルタキー」パラメータが「1 つ選択」に設定され、「フィルタロジック」パラメータが「Equal」または「Contains」に設定されている場合: 「アクション「{アクション名}」の実行エラー。理由: 「フィルタキー」パラメータからフィールドを選択する必要があります。」「返される最大レコード数」パラメータに無効な値が指定されている場合:「アクション「{action name}」の実行エラー。理由: 「返さえる最大レコード数」に無効な値が指定されました。正の数を指定してください。」間違った認証情報、サーバーへの接続なし、その他など、致命的なエラーが報告された場合:「アクション「{action name}」の実行エラー。理由: {0}」.format(error.Stacktrace)	一般
Case Wall テーブル	テーブル名: Available {商品グループ} テーブル列: {fields}	全般

結果のタイプ

値 / 説明

種類

出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

データが利用可能な場合（is_success=true）:「{product name} で指定された条件に該当する {item name} が正常に見つかりました。」

データが利用できない場合（is_success=false）:「{product name} で指定された条件に該当する {item name} が見つかりませんでした。」

「フィルタ値」パラメータが空の場合（is_success=true）:

「パラメータ「フィルタ値」の値が空であるため、フィルタは適用されませんでした。」

アクションが失敗し、ハンドブックの実行が停止します。

「フィルタキー」パラメータが「1 つ選択」に設定され、「フィルタロジック」パラメータが「Equal」または「Contains」に設定されている場合:

「アクション「{アクション名}」の実行エラー。理由: 「フィルタキー」パラメータからフィールドを選択する必要があります。」

「返される最大レコード数」パラメータに無効な値が指定されている場合:「アクション「{action name}」の実行エラー。理由: 「返さえる最大レコード数」に無効な値が指定されました。正の数を指定してください。」

間違った認証情報、サーバーへの接続なし、その他など、致命的なエラーが報告された場合:「アクション「{action name}」の実行エラー。理由: {0}」.format(error.Stacktrace)

一般

Case Wall テーブル

テーブル名: Available {商品グループ}

テーブル列: {fields}

全般

Ping

説明

[Google Security Operations Marketplace] タブの統合構成ページで提供されているパラメータを使用して、Cloudflare への接続をテストします。

パラメータ

なし

実行

このアクションは Google SecOps スコープエンティティを使用せず、必須入力パラメータもありません。

アクションの結果

スクリプトの結果

スクリプトの結果名	値のオプション	例
is_success	True/False	is_success:False

JSON の結果

N/A

Case Wall

結果のタイプ	値 / 説明	種類
出力メッセージ *	アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。成功した場合:「指定された接続パラメータを使用して SpyCloud サーバーに正常に接続されました。」アクションが失敗し、ハンドブックの実行が停止します。成功しなかった場合:「SpyCloud サーバーへの接続に失敗しました。エラーは {0}」.format(exception.stacktrace) アカウントが見つからない場合: 「Cloudflare サーバーへの接続に失敗しました。無効なアカウント名が指定されました。スペルを確認してください。」	全般

結果のタイプ

値 / 説明

種類

出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

成功した場合:「指定された接続パラメータを使用して SpyCloud サーバーに正常に接続されました。」

アクションが失敗し、ハンドブックの実行が停止します。

成功しなかった場合:「SpyCloud サーバーへの接続に失敗しました。エラーは {0}」.format(exception.stacktrace)

アカウントが見つからない場合: 「Cloudflare サーバーへの接続に失敗しました。無効なアカウント名が指定されました。スペルを確認してください。」

全般

ファイアウォールルールを更新する

説明

Cloudflare でファイアウォールルールを更新します。

実行

このアクションはエンティティに対しては実行されません。

パラメータ

パラメータの表示名	種類	デフォルト値	必須	説明
ルール名	文字列	なし	はい	更新するルールの名前を指定します。
ゾーン名	文字列	なし	はい	ファイアウォールルールを含むゾーンの名前を指定します。
アクション	DDL	ブロック有効な値: 許可ブロックバイパスするログ以前の CAPTCHA Managed Challenge JS チャレンジ	いいえ	ファイアウォールルールのアクションを指定します。 [ブロック] を選択した場合は、[プロダクト] パラメータに値を指定する必要があります。
式	文字列	なし	はい	ファイアウォールルールの式を指定します。
プロダクト	CSV	なし	いいえ	ファイアウォールルールのプロダクトのカンマ区切りリストを指定します。注: このパラメータは、[アクション] パラメータに [バイパス] が選択されている場合にのみ必須です。有効な値: zoneLockdown、uaBlock、bic、hot、securityLevel、rateLimit、waf
優先度	Integer	なし	いいえ	ファイアウォールルールの優先度を指定します。
参照タグ	文字列	なし	いいえ	ファイアウォールルールの参照タグを指定します。注: 最大 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
        }
}

Case Wall

結果のタイプ	値 / 説明	種類
出力メッセージ *	アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。 200 ステータスコードが報告された場合（is_success=true）: 「Cloudflare の「{zone_name}」ゾーンでファイアウォールルールが正常に更新されました。」アクションが失敗し、ハンドブックの実行が停止します。間違った認証情報、サーバーへの接続なし、その他など、致命的なエラーが報告された場合:「アクション「ファイアウォールルールの更新」の実行エラー。理由: {0}」.format(error.Stacktrace) エラーリストが空でない場合: 「アクション「ファイアウォールルールを更新」の実行エラー。理由: {0}」.format(errors/message) ゾーンが見つからない場合: 「"ファイアウォールルールの更新"という操作の実行中にエラーが発生しました。理由: ゾーン {zone_name} が Cloudflare で見つかりませんでした。	全般

結果のタイプ

値 / 説明

種類

出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

200 ステータスコードが報告された場合（is_success=true）: 「Cloudflare の「{zone_name}」ゾーンでファイアウォールルールが正常に更新されました。」

アクションが失敗し、ハンドブックの実行が停止します。

間違った認証情報、サーバーへの接続なし、その他など、致命的なエラーが報告された場合:「アクション「ファイアウォールルールの更新」の実行エラー。理由: {0}」.format(error.Stacktrace)

エラーリストが空でない場合: 「アクション「ファイアウォールルールを更新」の実行エラー。理由: {0}」.format(errors/message)

ゾーンが見つからない場合: 「"ファイアウォールルールの更新"という操作の実行中にエラーが発生しました。理由: ゾーン {zone_name} が Cloudflare で見つかりませんでした。

全般

さらにサポートが必要な場合 コミュニティメンバーや Google SecOps のプロフェッショナルから回答を得ることができます。

Cloudflare

プロダクトのユースケース

Google Security Operations で Cloudflare インテグレーションを構成する

統合のパラメータ

トークンを構成する方法

操作

ルールリストに IP を追加する

説明

パラメータ

実行

アクションの結果

スクリプトの結果

JSON の結果

Case Wall

ルールリストに URL を追加

説明

パラメータ

実行

アクションの結果

スクリプトの結果

JSON の結果

Case Wall

ファイアウォール ルールの作成

説明

パラメータ

実行

アクションの結果

スクリプトの結果

JSON の結果

Case Wall

ルールリストを作成する

説明

パラメータ

実行

アクションの結果

スクリプトの結果

JSON の結果

Case Wall

エンティティの拡充

説明

パラメータ

実行

アクションの結果

スクリプトの結果

JSON の結果

IP アドレスの JSON の結果

URL の JSON の結果

ホスト名の JSON の結果

ケースウォール

ファイアウォール ルールの一覧を取得する

説明

パラメータ

実行

アクションの結果

スクリプトの結果

JSON の結果

Case Wall

Ping

説明

パラメータ

実行

アクションの結果

スクリプトの結果

JSON の結果

Case Wall

ファイアウォール ルールを更新する

説明

実行

パラメータ

実行

アクションの結果

スクリプトの結果

JSON の結果

Case Wall

ファイアウォールルールの作成

ファイアウォールルールの一覧を取得する

ファイアウォールルールを更新する