Cisco AMP

このドキュメントでは、Cisco Secure Endpoint を Google Security Operations と統合する方法について説明します。

Google Security Operations と連携するように Cisco Secure Endpoint を構成する

クライアント ID と API キーの生成:

  1. 北米向け Cisco Secure Endpoint コンソール、またはヨーロッパ向け Cisco Secure Endpoint コンソールにログインします。

  2. [アカウント> ビジネス] に移動し、[編集] をクリックします。

  3. [機能] で [再生成] をクリックしてクライアント ID と安全な API キーを生成します。

API クライアント ID と API キーを取得したら、次のように API 呼び出しを行うことができます。https://<your_client_id>:<your_api_key>@<api_endpoint>

また、Basic HTTP Authentication を使用することもできます。文字列「:」を Base64 でエンコードし、文字列「Basic」を接頭辞として付加して、認証ヘッダーとして送信します。たとえば、client_id が 1234 で、api_key が「atest」の場合、base64 でエンコードされて MTIzNDphdGVzdA== になり、ヘッダーは次のようになります。

承認: Basic MTIzNDphdGVzdA==

Base64 エンコード

クライアント ID と API キーは、Base64 デコードとエンコードでエンコードできます。

クライアント ID と API キーを Client_ID:API キーの形式で入力し、エンコードして Basic HTTP Authentication を生成します。

ネットワーク

関数 デフォルト ポート 方向 プロトコル
API 複数の値 送信 apikey

Google SecOps で Cisco AMP 統合を構成する

Google SecOps で統合を構成する手順の詳細については、統合を構成するをご覧ください。

統合のパラメータ

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

パラメータの表示名 種類 デフォルト値 必須 説明
インスタンス名 文字列 なし いいえ 統合を構成するインスタンスの名前。
説明 文字列 なし いいえ インスタンスの説明。
API ルート 文字列 https://api.amp.cisco.com ○ Cisco Secure Endpoint API ルート URL を指定します。
クライアント ID 文字列 なし ○ クライアント ID を指定します。
API キー パスワード なし ○ Cisco Secure Endpoint API キーを指定します。
Use SSL チェックボックス オフ いいえ 有効にすると、Cisco Secure Endpoint サーバーへの接続用の SSL 証明書が有効であることを確認します。
リモートで実行 チェックボックス オフ いいえ 構成した統合をリモートで実行するには、フィールドのチェックボックスをオンにします。オンにすると、リモート ユーザー(エージェント)を選択するオプションが表示されます。

アクション

ファイルをファイルリストに追加する

説明

特定のファイルリストの SHA-256 を追加します。

パラメータ

パラメータの表示名 タイプ デフォルト値 必須 Description
ファイル名リスト 文字列 なし ○ ファイル ブラックリスト。
説明 文字列 なし ○ ファイルの説明。

実行

このアクションはファイル エンティティに対して実行されます。

アクションの結果

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

グループを作成

説明

新しいグループを作成します。

パラメータ

パラメータの表示名 タイプ デフォルト値 必須 Description
グループ名 文字列 なし ○ 新しいグループの名前。
グループの説明 文字列 なし ○ 新しいグループの説明。

実行

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

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション 例
group_name True/False group_name:False
JSON の結果
{
   "source": "CreatedviaAPI",
   "guid": "c5e2099d-3aeb-4dc2-add4-42fb01d05c51",
   "name": "test", "policies":
       [{
          "product": "windows",
          "description": "ThispolicyputstheAMPforEndpointsConnectorinamodethatwillonlydetectmaliciousfilesbutnotquarantinethem.Maliciousnetworktrafficisalsodetectedbutnotblocked.",
          links":
                 {
                   "policy": "https: //api.amp.cisco.com/v1/policies/a8ba7d10-de10-42a6-a6e4-8d679f5b1ec2", "policy_xml": "https: //api.amp.cisco.com/v1/policies/a8ba7d10-de10-42a6-a6e4-8d679f5b1ec2.xml"
                },
            "default": true,
            "File_lists":
                  [{
                    "guid": "cef9b12e-4a25-4f1a-93f4-3836ebd97ed5",
                    "type": "simple_custom_detections",
                    "name": "FileBlacklist"
                   },
                  {
                    "guid": "38c1a9eb-0389-4f12-8084-96f5ee62d72e",
                    "type": "application_blocking",
                    "name": "ExecutionBlacklist"
                   },
                   {
                    "guid": "3133128e-5455-4e74-82c5-1ff3c816c414",
                    "type": "application_whitelist",
                    "name": "FileWhitelist"
                   }],
            "ip_lists": [],
            "Used_in_groups":
                  [{
                    "guid": "d3f8be3c-e53b-4b31-a8b7-a78a69b74ea1",
                    "name": "Audit",
                    "description": "AuditGroupforPartner-Siemplify"
                  }],
           "inherited": false,
           "serial_number": 28,
           "guid": "a8ba7d10-de10-42a6-a6e4-8d679f5b1ec2",
           "Exclusion_sets":
                 [{
                    "guid": "43fc08b5-c603-4c24-9b4d-501d342f443c",
                    "name": "WorkstationExclusions"
                  }],
           "name": "Audit"
        }],
   "description": "added by siemplify!"
}

コンピュータ情報を取得する

説明

パソコンの詳細情報を取得します。

パラメータ

なし

実行

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

  • IP アドレス
  • ホスト名

アクションの結果

エンティティ拡充

エンティティは、しきい値を超えると、不審(True)としてマークされます。それ以外の場合は False です。

拡充フィールド名 ロジック - 適用するタイミング
Demo_AMP JSON の結果に存在する場合に返す
スクリプトの結果
スクリプトの結果名 値のオプション 例
success True/False success:False
JSON の結果
{
   "Demo_AMP":
         {
           "operating_system": "Windows 7, SP 1.0",
           "connector_guid": "f719857b-5474-467f-803c-00393616cdcf",
           "network_addresses":
              [{
                 "ip": "1.1.1.1",
                 "mac": "18:ac:08:1f:49:13"
               }],
           "faults": [],
           "external_ip": "1.1.1.1",
           "group_guid": "bcaafdfb-bf15-4f65-81e0-58b14624ff26",
           "hostname": "Demo_AMP",
           "install_date": "2018-05-09T14:51:04Z",
           "connector_version": "1.1.1.1",
           "internal_ips": ["92.168.133.146"],
           "Policy":
               {
                 "guid": "d04fbbc0-fc5d-45d9-94f6-9e53f5079c2f",
                 "name": "Triage"
               },
           "active": true,
           "last_seen": "2018-05-09T14:51:04Z"
           }
}

ファイル ハッシュでコンピュータを取得する

説明

指定された SHA-256 値を持つファイルを観測したパソコンのリストを取得します。

実行

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

アクションの結果

エンティティ拡充

エンティティは、しきい値を超えると、不審(True)としてマークされます。それ以外の場合は False です。

スクリプトの結果
スクリプトの結果名 値のオプション 例
success True/False success:False
JSON の結果
[{
   "EntityResult":
       {
        "0":
           {
            "connector_guid": "abfe956e-8b67-4d5c-9353-1b490cdad8b2",
            "links":
               {
                "trajectory": "https://api.amp.cisco.com/v1/computers/abfe956e-8b67-4d5c-9353-1b490cdad8b2/trajectory",
                "computer": "https://api.amp.cisco.com/v1/computers/abfe956e-8b67-4d5c-9353-1b490cdad8b2",
                "group": "https://api.amp.cisco.com/v1/groups/1d7e90f6-b6b6-49ba-90ab-a8fe13d8f3d4"
                },
            "group_guid": "1d7e90f6-b6b6-49ba-90ab-a8fe13d8f3d4",
            "active": "True",
            "operating_system": "Windows Server 2012 R2, SP 0.0",
            "network_addresses":
               [{
                  "ip": "10.0.0.4",
                  "mac": "00:0d:3a:4e:fc:6e"
                 },
                 {
                   "ip": "10.212.134.201",
                   "mac": "00:09:0f:aa:00:01"
                 }],
            "faults": [],
            "external_ip": "13.72.107.194",
            "hostname": "poc-JuanV",
            "install_date": "2019-04-29T19:37:06Z",
            "connector_version": "6.2.9.10881",
            "internal_ips": ["10.0.0.4", " 10.212.134.201"],
            "policy":
                {
                   "guid": "9d8be508-fbec-457a-a0eb-c0cb82be482c",
                   "name": "Server"
                },
            "last_seen": "2019-05-28T11:46:32Z"
            }
       },
  "Entity": "entityIdentifier"
 }]

ファイル名でパソコンを取得する

説明

指定されたファイル名を使用して、観測されたファイルが含まれるパソコンのリストを取得します。

実行

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

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション 例
success True/False success:False
JSON の結果
[{
   "EntityResult":
     {
      "0":
        {
         "connector_guid": "abfe956e-8b67-4d5c-9353-1b490cdad8b2",
          "Links":
             {
              "trajectory": "https://api.amp.cisco.com/v1/computers/abfe956e-8b67-4d5c-9353-1b490cdad8b2/trajectory",
              "computer": "https://api.amp.cisco.com/v1/computers/abfe956e-8b67-4d5c-9353-1b490cdad8b2",
              "group": "https://api.amp.cisco.com/v1/groups/1d7e90f6-b6b6-49ba-90ab-a8fe13d8f3d4"
              },
          "group_guid": "1d7e90f6-b6b6-49ba-90ab-a8fe13d8f3d4",
          "active": "True",
          "operating_system": "Windows Server 2012 R2, SP 0.0",
           "network_addresses":
              [{
                 "ip": "10.0.0.4",
                 "mac": "00:0d:3a:4e:fc:6e"
               },
               {
                 "ip": "10.212.134.201",
                 "mac": "00:09:0f:aa:00:01"
               }],
           "faults": [],
           "external_ip": "13.72.107.194",
           "hostname": "poc-JuanV",
           "install_date": "2019-04-29T19:37:06Z",
           "connector_version": "6.2.9.10881",
           "internal_ips": ["10.0.0.4", " 10.212.134.201"],
           "policy":
               {
                  "guid": "9d8be508-fbec-457a-a0eb-c0cb82be482c",
                  "name": "Server"
               },
           "last_seen": "2019-05-28T11:46:32Z"
          }
     },
   "Entity": "entityIdentifier"
 }]

ネットワーク アクティビティ(IP)でコンピュータを取得する

説明

指定された IP アドレスに接続したパソコンのリストを取得します。

パラメータ

なし

実行

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

アクションの結果

エンティティ拡充

エンティティは、しきい値を超えると、不審(True)としてマークされます。それ以外の場合は False です。

スクリプトの結果
スクリプトの結果名 値のオプション 例
success True/False success:False
JSON の結果
[{
  "EntityResult":
    {
     "0":
       {
        "connector_guid": "abfe956e-8b67-4d5c-9353-1b490cdad8b2",
        "links":
           {
             "trajectory": "https://api.amp.cisco.com/v1/computers/abfe956e-8b67-4d5c-9353-1b490cdad8b2/trajectory",
             "computer": "https://api.amp.cisco.com/v1/computers/abfe956e-8b67-4d5c-9353-1b490cdad8b2",
             "group":
 "https://api.amp.cisco.com/v1/groups/1d7e90f6-b6b6-49ba-90ab-a8fe13d8f3d4"
            },
        "group_guid": "1d7e90f6-b6b6-49ba-90ab-a8fe13d8f3d4",
        "active": "True",
        "operating_system": "Windows Server 2012 R2, SP 0.0",
       "network_addresses":
            [{
               "ip": "10.0.0.4",
               "mac": "00:0d:3a:4e:fc:6e"
             },
             {
               "ip": "10.212.134.201",
               "mac": "00:09:0f:aa:00:01"
            }],
       "faults": [],
       "external_ip": "13.72.107.194",
       "hostname": "poc-JuanV",
       "install_date": "2019-04-29T19:37:06Z",
       "connector_version": "6.2.9.10881",
       "internal_ips": ["10.0.0.4", " 10.212.134.201"],
       "policy":
           {
              "guid": "9d8be508-fbec-457a-a0eb-c0cb82be482c",
              "name": "Server"
           },
       "last_seen": "2019-05-28T11:46:32Z"
      }
    },
 "Entity": "entityIdentifier"
}]

ネットワーク アクティビティ(URL)でコンピュータを取得する

説明

指定されたホスト名または URL に接続したパソコンのリストを取得します。

実行

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

  • ホスト名
  • URL

アクションの結果

エンティティ拡充

エンティティは、しきい値を超えると、不審(True)としてマークされます。それ以外の場合は False です。

スクリプトの結果
スクリプトの結果名 値のオプション 例
success True/False success:False
JSON の結果
[{
  "EntityResult":
     {
      "0":
         {
          "connector_guid": "abfe956e-8b67-4d5c-9353-1b490cdad8b2",
          "links":
             {
              "trajectory": "https://api.amp.cisco.com/v1/computers/abfe956e-8b67-4d5c-9353-1b490cdad8b2/trajectory",
              "computer": "https://api.amp.cisco.com/v1/computers/abfe956e-8b67-4d5c-9353-1b490cdad8b2",
              "group": "https://api.amp.cisco.com/v1/groups/1d7e90f6-b6b6-49ba-90ab-a8fe13d8f3d4"
             },
         "group_guid": "1d7e90f6-b6b6-49ba-90ab-a8fe13d8f3d4",
         "active": "True",
         "operating_system": "Windows Server 2012 R2, SP 0.0",
         "Network_addresses":
             [{
               "ip": "10.0.0.4",
               "mac": "00:0d:3a:4e:fc:6e"
              },
              {
               "ip": "10.212.134.201",
               "mac": "00:09:0f:aa:00:01"
             }],
        "faults": [],
        "external_ip": "13.72.107.194",
        "hostname": "poc-JuanV",
        "install_date": "2019-04-29T19:37:06Z",
        "connector_version": "6.2.9.10881",
        "internal_ips": ["10.0.0.4", " 10.212.134.201"],
        "policy":
            {
              "guid": "9d8be508-fbec-457a-a0eb-c0cb82be482c",
              "name": "Server"
            },
       "last_seen": "2019-05-28T11:46:32Z"
       }
    },
 "Entity": "entityIdentifier"
}]

ファイルリスト アイテム

説明

指定されたファイルリストに記載されているアイテムを取得します。

パラメータ

パラメータの表示名 タイプ デフォルト値 必須 Description
ファイルリスト名 文字列 なし ○ 例: ファイルのブラックリスト

実行

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

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション 例
項目 True/False items:False
JSON の結果
{
  "Items":
    [{
      "source": "Created by uploading 1_Credit Card Magnetic Tracks - Notepad (2).TXT via Web from 1.1.1.1.",
      "sha256": "640e9583763fa553069a4984f8df5e81d6890897a6eb0f5de881218e3ed409c8", "description": ""
      },
     {
      "source": "Created by entering SHA-256 via Public api.",
      "sha256": "5fd924625f6ab16a19cc9807c7c506ae1813490e4ba675f843d5a10e0baacdb8",
      "description": "Added by Siemplify"
     },
     {
      "source": "Created by entering SHA-256 via Public api.",
      "sha256": "1248712441dbbf43bb37f91d626a020e7e0f4486f050142034b8a267b06a2f0c",
      "description": "Added by Siemplify"
   }],
 "guid": "cef9b12e-4a25-4f1a-93f4-3836ebd97ed5",
 "name": "File Blacklist"
}

ポリシーでファイルリストを取得する

説明

ポリシーに割り当てられているファイルリストを取得します。

パラメータ

パラメータの表示名 タイプ デフォルト値 必須 Description
ポリシー名 文字列 なし ○ ポリシーの名前(例: Triage)。

実行

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

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション 例
File_Lists なし なし
JSON の結果
{
  "1":
    {
     "guid": "38c1a9eb-0389-4f12-8084-96f5ee62d72e",
     "type": "application_blocking",
     "name": "Execution Blacklist"},
     "0":
       {
         "guid": "cef9b12e-4a25-4f1a-93f4-3836ebd97ed5",
         "type": "simple_custom_detections",
         "name": "File Blacklist"
       },
    "2":
      {
         "guid": "3133128e-5455-4e74-82c5-1ff3c816c414",
         "type": "application_whitelist",
         "name": "File Whitelist"
    }
}

Get Groups

説明

グループの詳細を取得します。

パラメータ

なし

実行

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

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション 例
グループ なし なし
JSON の結果
{
  "1":
    {
     "source": "CreatedviaAPI",
     "guid": "1111111111111111111111",
     "name": "TestGroup",
     "description": "GroupcreatedbySiemplify"
    },
  "0":
    {
     "source": null,
     "guid": "1111111111111111111111",
     "name": "Audit",
     "description": "AuditGroupforPartner-Siemplify"
    }
}

ポリシーを取得する

説明

ポリシーの詳細を取得します。

パラメータ

なし

実行

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

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション 例
ポリシー なし なし
JSON の結果
{
  "1":
    {
     "product": "ios",
     "name": "Audit",
     "default": true,
     "serial_number": 38,
     "guid": "1111111111111111",
     "description": "ThispolicyputsClarityinamodethatwilllogandalertonconvictionsbutnotblocktraffic."
    },
  "0":
    {
     "product": "android",
     "name": "Protect",
     "default": true,
     "serial_number": 11,
     "guid": "1111111111111111",
     "description": "ThisisthestandardpolicyfortheAMPforEndpointsConnectorthatwillquarantinemaliciousfilesandblockmaliciousnetworkconnections."
   }
}

Ping

説明

Cisco Secure Endpoint への接続性をテストします。

パラメータ

なし

実行

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

アクションの結果

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

マシンを分離する

説明

ホストを分離して、分離されたホストとのネットワーク トラフィックを停止します。

パラメータ

なし

ユースケース

ホストでランサムウェアが検出されました:

  1. ランサムウェア プロセスを停止します。
  2. 可能であればランサムウェアを削除します。
  3. ホストを分離します。

実行

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

  • ホスト
  • 内部 IP
  • 外部 IP

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション 例
is_success True/False is_success:False
JSON の結果
"data": {
        "available": true,
        "status": "isolated",
        "unlock_code": "kzhduj",
        "comment": "Host pending investigation",
        "isolated_by": "Meny Har"
    }
ケースウォール
結果のタイプ 値 / 説明 種類
出力メッセージ *

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

成功した場合:「ターゲット ホストが正常に分離されました: {host}/{Internal IP}/{External IP}

失敗した場合:「ターゲット ホストは正常に分離されませんでした」

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

認証情報の誤りや接続の切断などの重大なエラーの場合:「エラーが発生しました。ログを確認してください。」

一般

マシンの分離を解除する

説明

ホストで分離を停止して、以前に分離されたホストとの間のネットワーク トラフィックを許可します。

実行

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

  • ホスト
  • 内部 IP
  • 外部 IP

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション 例
is_success True/False is_success:False
JSON の結果
"data": {
        "available": true,
        "status": "isolated",
        "unlock_code": "kzhduj",
        "comment": "Host confirmed:Infection free",
        "isolated_by": "Meny Har"
    }
ケースウォール
結果のタイプ 値 / 説明 種類
出力メッセージ *

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

成功した場合:

「対象のホストを正常に分離しました」と出力されます: {host}/{Internal IP}/{external IP}

失敗した場合:

「対象のホストが正常に分離できませんでした」と出力されます

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

認証情報の誤りや接続の切断などの重大なエラーの場合:

「エラーが発生しました。ログを確認してください。」

一般

コネクタ

Cisco AMP - Security Events Connector

説明

Cisco Secure Endpoint から Google SecOps にセキュリティ イベントを取得します。

Google SecOps で Cisco AMP - Security Events Connector を構成する

Google SecOps でコネクタを構成する方法の詳細については、コネクタの構成をご覧ください。

コネクタ パラメータ

次のパラメータを使用してコネクタを構成します。

パラメータの表示名 種類 デフォルト値 必須 説明
プロダクト フィールド名 文字列 プロダクト名 ○ ソース フィールド名を入力してプロダクト フィールド名を取得します。
イベント フィールド名 文字列 eventType ○ ソース フィールド名を入力してイベント フィールド名を取得します。
環境フィールド名 文字列 "" いいえ

環境名が保存されるフィールドの名前を記述します。

環境フィールドがない場合、その環境がデフォルトの環境です。

環境の正規表現パターン 文字列 .* いいえ

[環境フィールド名] フィールドで見つかった値に対して実行する正規表現パターン。

デフォルトは、すべてキャッチして値を変更せずに返す .* です。

ユーザーが正規表現ロジックで環境フィールドを操作できるようにするために使用されます。

正規表現パターンが null か空の場合、または環境値が null の場合、最終的な環境の結果はデフォルト環境になります。

スクリプトのタイムアウト(秒) 整数 180 はい 現在のスクリプトを実行している Python プロセスのタイムアウト上限。
API ルート 文字列 https:/{{ip address}} ○ Cisco Secure Endpoint インスタンスの API ルート。
クライアント ID 文字列 ○ Cisco Secure Endpoint のクライアント ID。
API キー パスワード ○ Cisco Secure Endpoint の API キー。
取得する最も低い重大度 文字列 いいえ

イベントの取得に使用される重大度。何も指定しないと、コネクタはすべての重大度のイベントを取り込みます。重大度データのないイベントは、「重大度なしのイベントを取得する」パラメータによって処理されます。値は次のいずれかです。

低、中、高、重大。

重大度なしのベントを取得する チェックボックス いいえ 有効にすると、コネクタは重大度のないイベントを取得します。これらのイベントは「情報」という重大度に割り振られます。
遡る最大時間数 整数 1 いいえ どの時点からイベントを取得するかの時間数。
取得する最大イベント数 整数 100 いいえ 1 回のコネクタの反復処理で対応するアラートの数。最大値は 1,000 です。デフォルト: 100。
許可リストを拒否リストとして使用 チェックボックス オフ ○ 有効にすると、許可リストが拒否リストとして使用されます。
SSL を確認 チェックボックス オン ○ 有効になっている場合は、Cisco Secure Endpoint サーバーへの接続用の SSL 証明書が有効であることを確認します。
プロキシ サーバーのアドレス 文字列 いいえ 使用するプロキシ サーバーのアドレス。
プロキシのユーザー名 文字列 いいえ 認証に使用するプロキシのユーザー名。
プロキシ パスワード パスワード いいえ 認証に使用するプロキシ パスワード。

コネクタ ルール

プロキシのサポート

コネクタはプロキシをサポートしています。

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