ビュー:

Trend Vision Oneの使用™File Security Python SDKを使用して、ファイルの不正プログラムを検索します。

Trend Vision One™ File SecurityのPython SDKを使用すると、 File Securityとシームレスに統合するアプリケーションを作成できます。このSDKを使用すると、アプリケーション内のデータとアーティファクトを徹底的にスキャンして、潜在的な悪意のある要素を特定できます。
次の手順に従って、開発環境とプロジェクトを設定し、ファイルセキュリティを効果的に使用するための基礎を築きます。

前提条件の確認 親トピック

SDKをインストールする前に、次のものが揃っていることを確認してください。

APIキーの作成 親トピック

File Security SDKでは、SDKクライアントオブジェクトへのパラメータとして有効なAPIキーを指定する必要があります。 Trend Vision One APIキーは、さまざまな地域に関連付けられています。参照下のリージョンフラグAPIキーに関連付けられている有効なリージョンについて理解を深めるため。

手順

  1. に移動[Administrations] → [API Keys] 。
  2. [Add API Key]をクリックします。
  3. [Run file scan via SDK] 権限を持つロールを使用するようにAPIキーを設定します。
  4. APIキーが使用するリージョンに関連付けられていることを確認します。
  5. APIキーの有効期限を設定し、後で参照できるように記録します。

SDKのインストール 親トピック

手順

  • pipを使用してFile Security SDKパッケージをインストールします。
    python -m pip install visionone-filesecurity

SDKの実行 親トピック

手順

  1. に移動します。 GitHubのサンプルフォルダ。
  2. フォルダ内のPythonの例を確認します。
    • はclient_aio.py例では、通常のファイル入出力 (i/o) を使用します。
    • はclient.py例では、非同期I/Oを使用しています。
    Pythonの例では、次の表のコマンドライン引数がサポートされています。

    Pythonの例

    コマンドライン引数 値 オプションかどうか
    --region or -r APIキーのリージョン。値は次のVision Oneリージョンのいずれかである必要があります。
    • ap-northeast-1
    • ap-south-1
    • ap-southeast-1
    • ap-southeast-2
    • eu-central-1
    • us-east-1
    		 はい-rまたは-a
    --addr or -a ファイルセキュリティサーバ (例: antimalware.REGION.cloudone.trendmicro.com:443) はい-rまたは-a
    --api_key Trend Vision One APIキー いいえ
    --filename or -f 検索するファイル いいえ
    --pml 機械学習型検索 ○
    --tagsまたは-f タグのリスト ○
  3. いずれかの例を実行します。次のこともできます。これらの例を使用して独自のプログラムを記述します。 。

サンプルのカスタマイズ 親トピック

次のいずれかをカスタマイズできます。サンプルプログラムで設定します。 APIキー。カスタムプログラムの場合は、regionパラメータを渡してAPIキーのリージョンを指定し、適切な認証があることを確認します。

手順

  1. の値を割り当てます。 API_KEYを変数に追加します。
  2. 設定ファイル名をクリックします。
    python3 client.py -f FILENAME -r us-1 --api_key API_KEY
    File Securityサーバのアドレスを使用できます。 -a地域の代わりに-r 。
    python3 client.py -f FILENAME -a antimalware._REGION_.cloudone.trendmicro.com:443 --api_key API_KEY
    非同期IOのサンプルプログラムを使用することもできます。
    python3 client_aio.py -f FILENAME -a antimalware._REGION_.cloudone.trendmicro.com:443 --api_key API_KEY