圖片公用程式
一組公用程式動作,可在調查期間協助分析、擷取及轉換圖片和檔案內容。主要功能包括用於擷取文字的光學字元辨識 (OCR)、光柵化 (將網路內容轉換為靜態圖片),以及檔案格式轉換。所有動作都需要遠端代理。
動作
如要進一步瞭解動作,請參閱「 在工作區回應待處理動作」和「在案件中執行手動動作」。
轉換檔案
使用「轉換檔案」動作,變更指定檔案的格式。
動作輸入內容
「Convert File」動作需要下列參數:
| 參數 | 說明 |
|---|---|
Input File Format |
這是必填欄位。 動作轉換的檔案原始格式。 可能的值如下:
預設值為 |
Input File Path |
這是必填欄位。 動作轉換的檔案路徑。 |
Output File Format |
這是必填欄位。 轉換後的檔案格式。 可能的值如下:
預設值為 |
動作輸出內容
「Convert File」(轉換檔案) 動作會提供下列輸出內容:
| 動作輸出類型 | 可用性 |
|---|---|
| 案件總覽附件 | 無法使用 |
| 案件總覽連結 | 無法使用 |
| 案件總覽表格 | 無法使用 |
| 補充資訊表格 | 無法使用 |
| JSON 結果 | 可用 |
| 輸出訊息 | 可用 |
| 指令碼執行結果 | 可用 |
JSON 結果
以下範例顯示使用「Convert File」(轉換檔案) 動作時,收到的 JSON 結果輸出內容:
[
{
"output_format": ""
"file_path": ""
}
]
輸出訊息
「轉換檔案」動作可能會傳回下列輸出訊息:
| 輸出訊息 | 訊息說明 |
|---|---|
|
動作成功。 |
Error executing action "Convert File". Reason:
ERROR_REASON |
動作失敗。 請檢查伺服器連線、輸入參數或憑證。 |
指令碼執行結果
下表列出使用「Convert File」(轉換檔案) 動作時,指令碼結果輸出的值:
| 指令碼結果名稱 | 值 |
|---|---|
is_success |
true或false |
OCR 圖片
使用 OCR Image 動作執行 OCR,並從圖片檔擷取文字。
動作輸入內容
OCR Image 動作需要下列參數:
| 參數 | 說明 |
|---|---|
Base64 Encoded Image |
選填。 圖片檔的 Base64 編碼字串。 |
File Path |
這是必填欄位。 圖片檔的路徑。 |
動作輸出內容
「OCR Image」動作會提供下列輸出內容:
| 動作輸出類型 | 可用性 |
|---|---|
| 案件總覽附件 | 無法使用 |
| 案件總覽連結 | 無法使用 |
| 案件總覽表格 | 無法使用 |
| 補充資訊表格 | 無法使用 |
| JSON 結果 | 可用 |
| 輸出訊息 | 可用 |
| 指令碼執行結果 | 可用 |
JSON 結果
以下範例顯示使用 OCR Image 動作時,收到的 JSON 結果輸出內容:
{
"extracted_text": "",
}
輸出訊息
OCR Image 動作可傳回下列輸出訊息:
| 輸出訊息 | 訊息說明 |
|---|---|
|
動作成功。 |
Error executing action "OCR Image". Reason:
ERROR_REASON |
動作失敗。 請檢查伺服器連線、輸入參數或憑證。 |
指令碼執行結果
下表列出使用「OCR Image」(OCR 圖片) 動作時,指令碼結果輸出的值:
| 指令碼結果名稱 | 值 |
|---|---|
is_success |
true或false |
點陣化內容
使用「Rasterize Content」動作,將向量或複雜內容轉換為固定的點陣圖圖片格式。
遠端代理程式必要條件 (Debian)
為確保「Rasterize Content」(將內容點陣化) 動作在 Debian 遠端代理程式上順利執行,您必須安裝下列套件和依附元件:
Playwright Python 程式庫
使用下列指令安裝 Playwright Python 程式庫:
python3.11 -m pip install playwright
瀏覽器依附元件
安裝必要的 Chromium 瀏覽器依附元件,讓 Playwright 正常運作:
playwright install --with-deps chromium
動作輸入內容
| 參數 | 說明 |
|---|---|
Input Type |
這是必填欄位。 動作主要輸入內容的類型。 可能的值如下:
預設值為 |
URLs or Body |
這是必填欄位。 要光柵化的輸入內容,依據所選 如果選取 如果選取 |
Output Type |
選填。 點陣化內容的輸出格式。 可能的值如下:
預設值為 |
Export Method |
選填。 輸出生成內容的方法。 可能的值如下:
預設值為 |
Width |
這是必填欄位。 生成光柵內容的寬度 (以像素為單位)。 預設值為 |
Height |
這是必填欄位。 生成光柵內容的高度 (以像素為單位)。 預設值為 |
Full Screen |
選填。 如果選取,內容會在光柵化前,在整個瀏覽器視窗中顯示。 預設為停用。 |
Timeout |
選填。 瀏覽器在開始光柵化之前,用於轉譯內容的時間上限 (以秒為單位)。 最大值為 預設值為 |
Wait For |
選填。 瀏覽器必須達到的特定狀態,才能繼續執行光柵化或內容擷取。
可能的值如下:
預設值為 |
Wait for Selector |
選填。 CSS 選取器,動作會等待該選取器顯示在網頁上,再擷取螢幕截圖。 |
動作輸出內容
「Rasterize Content」動作會提供下列輸出內容:
| 動作輸出類型 | 可用性 |
|---|---|
| 案件總覽附件 | 無法使用 |
| 案件總覽連結 | 無法使用 |
| 案件總覽表格 | 無法使用 |
| 補充資訊表格 | 無法使用 |
| JSON 結果 | 可用 |
| 輸出訊息 | 可用 |
| 指令碼執行結果 | 可用 |
JSON 結果
以下範例顯示使用「Rasterize Content」動作時,收到的 JSON 結果輸出內容:
[
{
"attachment_name": "",
"file_path": ""
}
]
輸出訊息
「Rasterize Content」動作可能會傳回下列輸出訊息:
| 輸出訊息 | 訊息說明 |
|---|---|
|
動作成功。 |
Error executing action "Rasterize Content". Reason:
ERROR_REASON |
動作失敗。 請檢查伺服器連線、輸入參數或憑證。 |
指令碼執行結果
下表列出使用「Rasterize Content」動作時,指令碼結果輸出的值:
| 指令碼結果名稱 | 值 |
|---|---|
is_success |
true或false |
還有其他問題嗎?向社群成員和 Google SecOps 專業人員尋求解答。