檢視次數:

使用 Trend Vision One™ File Security Java SDK 掃瞄檔案以檢測惡意程式。

Trend Vision One™ 檔案安全性的 Java SDK 讓您能夠輕鬆打造無縫整合檔案安全性的應用程式。使用此 SDK，您可以對應用程式中的資料和工件進行全面掃瞄，以識別潛在的惡意元素。
請按照以下步驟設置您的開發環境並配置您的項目，為有效使用文件安全奠定基礎。
相關資訊

檢查先決條件 上層主題

在安裝 SDK 之前，請確保您具備以下條件：

建立 API 金鑰 上層主題

File Security SDK 需要提供作為 SDK 用戶端物件參數的有效 API 金鑰。Trend Vision One API 金鑰與不同區域相關聯。請參閱 下方的區域標誌 以更好地了解與 API 金鑰相關的有效區域。

步驟

  1. 前往Administrations → API Keys。
  2. 點選Add API Key。
  3. 配置 API 金鑰以使用具有Run file scan via SDK權限的角色。
  4. 驗證 API 金鑰是否與您計劃使用的區域相關聯。
  5. 為 API 金鑰設置過期時間並記錄以供將來參考。

安裝 SDK 上層主題

步驟

  • 從 Maven Central Repository 下載 jar。
  • 對於 Maven，將以下依賴項添加到 pom.xml。
    <dependency>
  <groupId>com.trend</groupId>
  <artifactId>file-security-java-sdk</artifactId>
  <version>1.0.0</version>
</dependency>

使用檔案安全 Java SDK 上層主題

步驟

  1. 透過指定您 Trend Vision One 的區域和有效的 API 金鑰來建立客戶端物件。
  2. 啟動檔案掃瞄或緩衝區掃瞄以掃瞄目標資料防護。
    以下是一個說明如何使用 SDK 的 Java 程式碼範例。
    import com.trend.fs.AMaasClient;

public static void main(String[] args) {
    try {
        // 1. Create an AMaaS Client object and configure it to carry out the scans in Vision One "us-east-1" region.
        AMaasClient client = new AMaasClient("us-east-1", "your-api-key");

        // 2. Call ScanFile() to scan the content of a file.
        String scanResult = client.scanFile(""path-of-file-to-scan"");

        if (scanResult != null) {
            // 3. Print out the JSON response from ScanFile()
            System.out.println("scan result " + scanResult);
        }
    } catch (AMaasException err) {
        info("Exception {0}", err.getMessage());
    }
}
  3. 解析掃瞄 API 返回的 JavaScript 物件標記 (JSON) 回應，以判斷掃瞄的資料是否包含惡意程式。當在掃瞄的物件中檢測到惡意內容時，scanResult 會顯示一個值，並且 foundMalwares 會包含檔案名稱和惡意程式的名稱。
    以下是一個範例 JSON 回應。
    {
  "version": "1.0",
  "scanId": "25072030425f4f4d68953177d0628d0b",
  "scanResult": 1,
  "scanTimestamp": "2022-11-02T00:55:31Z",
  "fileName": "EICAR_TEST_FILE-1.exe",
  "filePath": "AmspBvtTestSamples/BVT_RightClickScan_DS/unclean/EICAR_TEST_FILE-1.exe",
  "foundMalwares": [
    {     
      "fileName": "Eicar.exe",
      "malwareName": "Eicar_test_file"
    }
  ]
}

    JSON 回應

    回應代碼 偵測到惡意程式 未檢測到
    掃描結果
    非零
    		 null
    發現的惡意軟體 fileNamemalwareName null