自訂 Script

1. 選擇配置設定的「進階」區段下的「自訂 Script」。
2. 按一下 + 新增按鈕。
3. 視需要，編輯預先填入的「名稱」欄位。
4. 為 Script 選擇合適的「執行環境定義」：：
   1. 「要求前」適用於在傳送要求前執行的 Script。
   2. 「回應後」適用於在接收回應後執行的 Script。
   3. 「參數」適用於需要多步驟或填寫表單的作業。您可以搭配 setResultValue 方法使用此環境定義，讓 Script 傳回結果至 AppScan。
5. 在 JavaScript 欄位（程式碼編輯器）輸入 JavaScript，並在 AppScan 環境中使用 Ctrl+Space 以取得自動完成的建議。
6. 按一下新增以儲存 Script。Script 會新增至清單且預設為啟用。
7. 您可利用啟用勾選框，從自訂 Script 清單選擇啟用或停用 Script。
8. 使用「啟用」勾選框管理 Script，或在 Script 清單中編輯、刪除或重新排序。
9. 按一下開始完整掃描以執行掃描。
10. 結果：每項要求或回應都會執行啟用的 Script。您可以從資料 > 要求標籤 > 要求/回應，檢視 Script 的詳細資料。

    驗證 Script 的語法是否準確，以及是否與 AppScan 支援的 JavaScript 版本相容。如需詳細指南，請參閱 JavaScript 程式碼。

    註：

    • 自訂 Script 會儲存在掃描配置檔中，並可與範本一併匯出。它們不會包含在掃描結果中。
    • 自訂 Script 在匯出至範本時會預設加密。若要停用加密，請在掃描配置中將「一般」>「加密機密資料」設定為 False。

// Attach Authorization from stored global variable
var token = environment.globalVariables.get("Authorization");
if (token) request.headers.set("Authorization", token);

// Capture token from JSON response and store it for reuse
try {
		var result = JSON.parse(response.body);
		if (result && result.Authorization) {
			environment.globalVariables.addOrUpdate("Authorization", result.Authorization);
		}
} catch(e) { log(e); }

• 此內容沒有可用的資料物件（要求或回應）；若使用，將傳回空值。
• 使用 setResultValue(value) 傳回值。

// Example: Return a unique email for registration flows
function random(n) { return Math.random().toString(36).slice(2, 2+n); }
var email = "test_" + Date.now() + "_" + random(6) + "@example.test";
setResultValue(email);

// Examples:
// Handle headers
request.headers.set("Authorization", "Bearer");
request.headers.add("X-Trace", "abc");

// Manipulate body
request.body = JSON.stringify( { user:"admin" });
if(request.body.includes("admin") { ... }

// Read path
if (request.path.startsWith("/api/v1")) { ... }

// Edit query
request.query.addOrUpdate("lang","en")
request.query.remove("debug")
request.query.getQueryString()

// Read method
if (request.method == "GET") { ... }

1. 廣域變數：廣域變數資料具有金鑰-值資料結構，專為儲存使用者特有的資料配對而設計。金鑰為獨一無二（表示兩個元素不會有相同金鑰，但多重元素可共用相同值），這一點對於在執行 Script 之間共用資料而言非常實用。
2. 掃描狀態：包含現行掃描的相關資訊。

   // Check the status of the scan
   environment.status.isInExplore();
   environment.status.isInTest();

• 受限函式：eval, Function (constructor), setTimeout, setlnterval。若使用其中任一函式，Script 將執行失敗。
• 限制：執行時間上限：5 秒；記憶體限制：64 MB。超出此限制都會導致 Script 失敗。

  當發生錯誤時，掃描將暫停，詳細資訊會記錄在 UserScript.log 中。

• ES6：產生器、尾呼叫
• ES8：共享記憶體與 Atomic
• ES15：Atomics.waitAsync、正規表示式旗標 \v

1. Script 失敗：請檢查日誌資料夾（預設位置：[UserDataFolder]\AppData\Roaming\HCL\AppScan Standard\logs）以取得錯誤詳細資訊。若遇到未處理的例外，請使用 try...catch 區塊包覆程式碼，以妥善處理錯誤。
2. Script 未執行：請確認已在配置設定中啟用 Script。

   若問題與登入或授權相關，請考慮從配置 → 進階配置 → 安全性套件順序中移除 negotiate 值，防止 AppScan 自動處理這些鑑別。