使用 SDK | Trend Micro Service Central

檢視次數:

如何使用 Go SDK 進行 Trend Vision One™ 檔案安全

初始化 Go SDK 以進行檔案安全性後，您可以開始使用它來與檔案安全性互動。以下是一些使用 SDK 的基本範例。

步驟

掃瞄檔案。

filePath := "path/to/your/file.txt"
tags := []string{"tag1", "tag2"}

response, err := client.ScanFile(filePath, tags)
if err != nil {
    // Handle scanning error
    panic(err)
}

// Use the 'response' as needed

掃瞄緩衝區。您可以使用最多八個標籤，每個標籤的最大長度為63個字元。

filePath := "path/to/your/file.txt"
tags := []string{"tag1", "tag2"}

response, err := client.ScanFile(filePath, tags)
if err != nil {
    // Handle scanning error
    panic(err)
}

// Use the 'response' as needed

使用進階功能

Go SDK 提供了額外的功能以供進階使用，例如啟用 PML、匯出配置和清理資源。

步驟

匯出設定。

您可以轉儲當前配置以進行調試。

configDump := client.DumpConfig()
fmt.Println("SDK Configuration:\n", configDump)

清理資源。
當您完成後，可以銷毀 SDK 客戶端以釋放任何分配的資源。
```
client.Destroy()
```
啟用 Machine Learning (PML)
```
client.SetPMLEnable()
```
啟用 SPN 反饋
```
client.SetFeedbackEnable()
```

查看範例

SDK 套件的 tools/ 目錄包含兩個重要的檔案，內有程式碼範例。

步驟

請參考這些範例，以更深入了解如何整合和使用 SDK 與檔案安全性。
- client.go：此檔案包含主要的客戶端初始化邏輯和掃描單個檔案的功能。
- scanfiles.go：此檔案提供如何使用 SDK 掃瞄多個檔案的範例。

使用用戶端工具

步驟

在根目錄中執行 make build 以構建用戶端工具。

建置過程會在tools/目錄中產生以下用戶端工具：

用戶端

此程式支援具有 Google™ 遠端程序呼叫 (gRPC) 的伺服器。

client [command-line flags]

此程式支援以下標誌：

客戶端支援的標誌

旗標	使用
`-tls`	指定啟用客戶端對 gRPC 的伺服器驗證。
`-region <string>`	指定要連接的 gRPC 區域。
`-addr <string>`	將地址設置為連接到 gRPC。預設為 `localhost:50051`。
`-filename <string>`	指出要掃瞄的檔案路徑。
`-apikey <string>`	如果已啟動驗證，請使用 API 金鑰進行服務驗證。
`-pml`	指定啟用 Machine Learning (PML) 偵測。
`-反饋`	指定啟用 SPN 反饋。
`標籤 <string>`	請指定要用於掃描的標籤，並用逗號分隔。您最多可以使用 8 個標籤，每個標籤的長度不能超過 63。

掃描檔案

這是另一個使用 gRPC 用戶端庫與檔案安全伺服器通信的程式。當指定 -good 標誌時，此程式會顯示測試是否成功以及檔案是否為非惡意。因此，例如，如果檔案安全伺服器指示檔案為惡意，程式輸出將顯示測試失敗。

此程式支援以下標誌：

Scanfiles 支援的標誌

旗標	使用
`-path <string>`	請指示要掃瞄的目錄或檔案。此標誌必須在所有情況下指定。
`-good`	指定是否掃描非惡意檔案。
`-parallel`	指定同時掃瞄多個檔案，而非依序掃瞄。
`-tls`	指定啟用客戶端對 gRPC 的伺服器驗證。
`-region <string>`	指定要連接的 gRPC 區域。
`-addr <string>`	將地址設置為連接到 gRPC。預設為 `localhost:50051`。
`-apikey <string>`	如果已啟動驗證，請使用 API 金鑰進行服務驗證。
`-pml`	指定啟用 Machine Learning (PML) 偵測。
`-反饋`	指定啟用 SPN 反饋。
`-標籤 <string>`	請指定要用於掃描的標籤，並用逗號分隔。您最多可以使用 8 個標籤，每個標籤的長度不能超過 63。