ビュー:
Webレピュテーションモジュールを設定して、ポリシーの動作を定義します。モジュールの動作を設計し、APIを使用して実装する際には、Webレピュテーションを使用して悪意のあるURLへのアクセスをブロックするに記載されている背景情報とガイダンスを使用してください。
ポリシーオブジェクトには、Webレピュテーションモジュールの設定に使用する2つのオブジェクトが含まれています。
  • WebReputationPolicyExtension: モジュールの状態 (オンまたはオフ) を制御します。
  • PolicySettings注意: ポリシー設定には、許可またはブロックするURLとドメイン、監視するポート、セキュリティレベル、 Smart Protection Serverの使用など、モジュールの実行時の動作を制御するWebレピュテーション関連の設定が多数含まれています。
次のJSONは、WebReputationPolicyExtensionオブジェクト:
{
    "state": "off",
    "moduleStatus": {...}
}
moduleStatusプロパティは読み取り専用です。 Webレピュテーションモジュールの実行時のステータスを示します。 (「コンピュータのステータスに関するレポート.)

一般的な手順 親トピック

通常、Webレピュテーションモジュールを設定するには、次の手順を実行します。

手順

  1. 作成するWebReputationPolicyExtensionオブジェクトを作成し、プロパティを設定します。
  2. 作成するPolicySettingsオブジェクトを使用して、モジュールの実行時設定を行います。
  3. 作成するPolicyオブジェクトを追加し、WebReputationPolicyExtensionそしてPolicySettingsオブジェクト。
  4. 使用するPoliciesApiServer & Workload Protectionのポリシーを追加または更新するオブジェクト。

次に進む前に

ヒント
ヒント
単一のWebレピュテーション関連のポリシー設定のみを設定する必要がある場合は、単一のポリシーまたはデフォルトのポリシー設定を構成するを参照してください。
モジュールを有効にするには、WebReputationPolicyExtensionオブジェクトを作成し、状態を設定します。
policy_config_web_reputation = api.WebReputationPolicyExtension()
policy_config_web_reputation.state = "on"
PolicySettingsオブジェクトを作成して、Webレピュテーション関連の設定を行います。 (ポリシー設定の詳細については、単一のポリシーまたは初期設定のポリシー設定を構成するたとえば、次のようにセキュリティレベルを設定できます。
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
この時点で、Webレピュテーションのポリシー拡張機能とポリシー設定が完了しました。次に、Policyオブジェクト。次に、PoliciesApi Server & Workload Protectionのポリシーを変更するオブジェクト。
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)
policy_id (またはpolicyID ) のパラメータmodifyPolicy変更する Server & Workload Protection の実際のポリシーを示します。このポリシーは、policyパラメータ。のプロパティpolicy設定されていないパラメータは、実際のポリシーでは変更されません。

親トピック

次の例では、WebReputationPolicyExtensionオブジェクトを選択し、Webレピュテーションの状態とセキュリティレベルを設定し、 Smart Protection Serverを有効にします。次に、オブジェクトがPolicy Server & Workload Protectionのポリシーを変更するために使用されるオブジェクトです。
# 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 Protection
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 Protectionによる認証を参照してください。