配置網頁信譽評等模組以定義其政策行為。在設計模組行為並使用 API 實施時,請使用 使用網頁信譽評等封鎖對惡意 URL 的訪問 中提供的背景資訊和指導。
政策物件包含兩個用於配置網頁信譽評等模組的物件:
WebReputationPolicyExtension
:控制模組狀態(開或關)。PolicySettings
:政策設定包括許多與網頁信譽評等相關的設定,這些設定控制模組的執行行為,例如允許和封鎖的 URL 和網域、監控的埠、安全層級以及主動雲端截毒技術伺服器的使用。
以下 JSON 代表
WebReputationPolicyExtension
物件的資料結構:{ "state": "off", "moduleStatus": {...} }
moduleStatus
屬性是唯讀的。它提供網頁信譽評等模組的運行狀態。(請參閱 電腦防護狀態報告。)一般步驟
一般來說,請使用以下步驟來配置網頁信譽評等模組:
步驟
- 建立一個
WebReputationPolicyExtension
物件並設置屬性。 - 創建一個
PolicySettings
物件來配置模組的運行時設置。 - 建立一個
Policy
物件並新增WebReputationPolicyExtension
和PolicySettings
物件。 - 使用
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)
modifyPolicy
的 policy_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保護 進行身份驗證。