Network Securityインスタンスを管理する

注意 ホストインフラストラクチャで展開されるNetwork Security仮想Appliancesの証明書はトレンドマイクロによって管理され、手動での更新は必要ありません。

注意 CLIにアクセスするには有効なSSHキーのペアが必要です。SSHキーにアクセスできなくなった場合は、新しいインスタンスをデプロイすることをお勧めします。

• [A valid SSH key pair]: Virtual Applianceにアクセスするために使用されるSSHキーペア (.pemファイル)。SSHキーにアクセスできなくなった場合は、新しいインスタンスをデプロイすることをお勧めします。
• [A bastion host]: バスチオンホスト、VPN、その他の方法を使用してVirtual Applianceに接続できることを確認してください。バスチオンホストの作成について詳しくはこちら。

• アプリケーション監視。
• お使いのNetwork Security展開のシステム全体の可視性。
• インスタンスを追加または削除するための自動スケーリングなどのリソース最適化。
• 運用の健康。

• バージョン2020.10.0以降のNetwork Security Virtual Applianceを少なくとも1つデプロイしてください。 [詳細はこちら](Network Security for AWS.md)。
• Trend Micro Cloud One APIキーを作成してAPI呼び出しを認証します。詳細はこちら。
• curlをダウンロードしてインストール。
• Bash用のjqをインストール。Bashスクリプトはjqを使用してJSONデータを解析します。インストールを確認するには、ターミナルからjq --versionコマンドを実行してください。

SECRET= "<YOUR_API_KEY>"
region="<YOUR_CLOUDONE_REGION>" # For example: "us-1"
url="https://network.${region}.cloudone.trendmicro.com/api/appliances"

curl --location --request GET "${url}" \
--header "Authorization: ApiKey ${SECRET}" \
--header "api-version: v1"

{
    "next": null,
    "totalCount": 1,
    "appliances": [{
        "ID": 1,
        "instanceId": "i-xxxxxxxxxxxee0d24",
        "provider": "AWS",
        "hostName": "i-xxxxxxxxxxx0d24",
        "tosVersion": "5.5.0.10625",
        "dvVersion": "4.0.0.9442",
        "auxDv": {
            "Malware": {
                "Version": null
            }
        },
        "providerMetadata": [{
            "key": "accountId",
            "value": "XXXXXXXXXXXX"
        }, {
            "key": "availabilityZone",
            "value": "sa-east-1a"
        }, {
            "key": "instanceType",
            "value": "c5n.2xlarge"
        }, {
            "key": "region",
            "value": "sa-east-1"
        }, {
            "key": "vpc",
            "value": "vpc-xxxxxxxxxxxx06a00"
        }]
    }]
}

• システムログ
• 監査ログ
• ホストログ
• ipsAlertログ
• ipsBlock ログ
• 評判ブロックログ
• 評判アラートログ
• 隔離ログ
• SSL (TLS) ログ

• CloudWatchログGroup変数とストリーム変数の名前を指定するか、デフォルト値を受け入れることができます。この例では、ログGroup名にnetwork-security-block-eventsを指定し、デフォルトのストリーム名を受け入れます。
• <YOUR_CLOUDONE_REGION> をお客様のアカウントの Trend Micro Cloud One リージョンに置き換えてください。
• <YOUR_API_KEY>をTrend Micro Cloud One APIキーに置き換えてください。
• <Appliance ID>をアプライアンスのIDに置き換えてください。

SECRET= "<YOUR_API_KEY>"
region="<YOUR_CLOUDONE_REGION>" # For example: "us-1"
applianceID="<Appliance ID>"

curl --location --request POST "https://network.${region}.cloudone.trendmicro.com/api/appliances/${applianceID}/cloudwatchlogconfig" \
--header "Authorization: ApiKey ${SECRET}" \
--header "api-version: v1" \
--header "Content-Type: application/json" \
--data-raw '{
  "logTypes": [
    {
      "logGroupName": "network-security-block-events",
      "logName": "ipsBlock",
      "enable": true
    }
  ]
}'

• <YOUR_CLOUDONE_REGION> をお客様のアカウントの Trend Micro Cloud One リージョンに置き換えてください。
• <YOUR_API_KEY>をTrend Micro Cloud One APIキーに置き換えてください。
• <Appliance ID>をアプライアンスのIDに置き換えてください。

SECRET= "<YOUR_API_KEY>"
region="<YOUR_CLOUDONE_REGION>" # For example: "us-1"
applianceID="<Appliance ID>"

curl --location --request GET "https://network.${region}.cloudone.trendmicro.com/api/appliances/${applianceID}/cloudwatchlogconfig" \
--header "Authorization: ApiKey ${SECRET}" \
--header "api-version: v1"

{
    "next": null,
    "totalCount": null,
    "logTypes": [
        {
            "logGroupName": "ips",
            "logStreamName": "system_{instance_id}",
            "logName": "system",
            "enable": false
        },
        {
            "logGroupName": "ips",
            "logStreamName": "audit_{instance_id}",
            "logName": "audit",
            "enable": false
        },
        {
            "logGroupName": "ips",
            "logStreamName": "host_{instance_id}",
            "logName": "host",
            "enable": false
        },
        {
            "logGroupName": "network-security-block-events",
            "logStreamName": "ipsBlock_{instance_id}",
            "logName": "ipsBlock",
            "enable": true
        },
        {
            "logGroupName": "ips",
            "logStreamName": "ipsAlert_{instance_id}",
            "logName": "ipsAlert",
            "enable": false
        },
        {
            "logGroupName": "ips",
            "logStreamName": "reputationBlock_{instance_id}",
            "logName": "reputationBlock",
            "enable": false
        },
        {
            "logGroupName": "ips",
            "logStreamName": "reputationAlert_{instance_id}",
            "logName": "reputationAlert",
            "enable": false
        },
        {
            "logGroupName": "ips",
            "logStreamName": "quarantine_{instance_id}",
            "logName": "quarantine",
            "enable": false
        }
        {
            "logGroupName": "network-security-block-events",
            "logStreamName": "sslInspection_{instance_id}",
            "logName": "sslInspection",
            "enable": false
        }
    ]
}

• 2xxコードはSuccessを示します
• 4xxコードはクライアントエラーを示します
• 5xxコードはサーバエラーを示します

• [400 client code errors] – APIのPOSTメソッドに対して無効なペイロードを示します。エラーの詳細な説明については、APIのレスポンスコードの追加の詳細フィールドを確認してください。GETおよびSETペイロードAPIについて詳しく学んでください。
• [401 client code errors] – 無効なAPIキーを示し、"Authorization Required"メッセージを表示します。APIキーが正しいことを確認し、再度APIを呼び出してください。
• [503 server code errors] – 予定または予定外の停止により、サーバがリクエストを処理できなかったことを示します。停止が終了し、サーバが復旧するまでしばらく待ってから、再度APIを呼び出してください。