檢視次數:
配置網頁信譽評等模組以定義其政策行為。在設計模組行為並使用 API 實施時,請使用 使用網頁信譽評等封鎖對惡意 URL 的訪問 中提供的背景資訊和指導。
政策物件包含兩個用於配置網頁信譽評等模組的物件:
  • WebReputationPolicyExtension:控制模組狀態(開或關)。
  • PolicySettings:政策設定包括許多與網頁信譽評等相關的設定,這些設定控制模組的執行行為,例如允許和封鎖的 URL 和網域、監控的埠、安全層級以及主動雲端截毒技術伺服器的使用。
以下 JSON 代表 WebReputationPolicyExtension 物件的資料結構:
{
    "state": "off",
    "moduleStatus": {...}
}
moduleStatus 屬性是唯讀的。它提供網頁信譽評等模組的運行狀態。(請參閱 電腦防護狀態報告。)

一般步驟 上層主題

一般來說,請使用以下步驟來配置網頁信譽評等模組:

步驟

  1. 建立一個 WebReputationPolicyExtension 物件並設置屬性。
  2. 創建一個 PolicySettings 物件來配置模組的運行時設置。
  3. 建立一個 Policy 物件並新增 WebReputationPolicyExtensionPolicySettings 物件。
  4. 使用 PoliciesApi 物件在 Server & Workload Security保護 上新增或更新政策。

接下來需執行的動作

秘訣
秘訣
如果您只需要設定單一網頁信譽評等相關的策略設定,請參閱設定單一策略或預設策略設定
若要開啟模組,請建立 WebReputationPolicyExtension 物件並設定狀態:
policy_config_web_reputation = api.WebReputationPolicyExtension()
policy_config_web_reputation.state = "on"
建立一個 PolicySettings 物件來配置與網頁信譽評等相關的設定。(有關策略設定的詳細資訊,請參閱 配置單一策略或預設策略設定。)例如,您可以設定安全層級:
policy_settings = api.PolicySettings()
security_level_setting = api.SettingValue()
security_level_setting.value = security_level
policy_settings.web_reputation_setting_security_level = security_level_setting
此時,網頁信譽評等策略擴展和策略設定已配置完成。接下來,將它們添加到Policy對象中。然後,使用PoliciesApi對象來修改Server & Workload Security保護上的策略。
policy = api.Policy()
policy.web_reputation = policy_config_web_reputation
policy.policy_settings = policy_settings

policies_api = api.PoliciesApi(api.ApiClient(configuration))

return policies_api.modify_policy(policy_id, policy, api_version)
modifyPolicypolicy_id(或 policyID)參數標識要在 Server & Workload Security保護 上修改的實際政策。此政策根據用作 policy 參數的政策對象進行修改。未設置的 policy 參數的任何屬性在實際政策上保持不變。

範例 上層主題

以下範例會建立一個 WebReputationPolicyExtension 物件,然後設定網頁信譽評等狀態、安全層級,並啟用主動雲端截毒技術伺服器。接著將該物件新增到 Policy 物件中,該物件用於修改 Server & Workload Security保護 上的政策。
# Enable Web Reputation
policy_config_web_reputation = api.WebReputationPolicyExtension()
policy_config_web_reputation.state = "on"

# Add to a policy
policy = api.Policy()
policy.web_reputation = policy_config_web_reputation

# Set the security level
policy_settings = api.PolicySettings()
security_level_setting = api.SettingValue()
security_level_setting.value = security_level
policy_settings.web_reputation_setting_security_level = security_level_setting

# Enable Smart Protection
smart_protection_allow_global = api.SettingValue()
smart_protection_allow_global.value = True
policy_settings.web_reputation_setting_smart_protection_local_server_allow_off_domain_global = smart_protection_allow_global

# Add the settings
policy.policy_settings = policy_settings

# Modify the policy on Server & Workload Security保護
policies_api = api.PoliciesApi(api.ApiClient(configuration))
modified_policy = policies_api.modify_policy(policy_id, policy, api_version)
return modified_policy.id
另請參閱 API 參考中的 修改政策 操作。有關 API 調用身份驗證的信息,請參閱 使用 Server & Workload Security保護 進行身份驗證