Ansichten:
Konfigurieren Sie das Web Reputation-Modul, um sein Verhalten für eine Richtlinie festzulegen. Verwenden Sie bei der Gestaltung des Modulverhaltens und der Implementierung über die API die Hintergrundinformationen und Anleitungen, die in Zugriff auf bösartige URLs mit Web Reputation sperren bereitgestellt werden.
Richtlinienobjekte enthalten zwei Objekte, die Sie zur Konfiguration des Web Reputation-Moduls verwenden:
  • WebReputationPolicyExtension: Steuert den Modulstatus (ein oder aus).
  • PolicySettings: Richtlinieneinstellungen umfassen viele Web Reputation-bezogene Einstellungen, die das Laufzeitverhalten des Moduls steuern, wie die erlaubten und gesperrten Links und Domains, die zu überwachenden Ports, die Sicherheitsstufe und die Nutzung des Smart Protection Server.
Das folgende JSON stellt die Datenstruktur eines WebReputationPolicyExtension-Objekts dar:
{
    "state": "off",
    "moduleStatus": {...}
}
Die moduleStatus-Eigenschaft ist schreibgeschützt. Sie liefert den Laufzeitstatus des Web Reputation-Moduls. (Siehe Bericht über den Computerstatus.)

Allgemeine Schritte Übergeordnetes Thema

Verwenden Sie im Allgemeinen die folgenden Schritte, um das Web Reputation-Modul zu konfigurieren:

Prozedur

  1. Erstellen Sie ein WebReputationPolicyExtension-Objekt und legen Sie die Eigenschaften fest.
  2. Erstellen Sie ein PolicySettings-Objekt, um die Laufzeiteinstellungen des Moduls zu konfigurieren.
  3. Erstellen Sie ein Policy-Objekt und fügen Sie die WebReputationPolicyExtension- und PolicySettings-Objekte hinzu.
  4. Verwenden Sie ein PoliciesApi-Objekt, um die Richtlinie auf Server- und Workload Protection hinzuzufügen oder zu aktualisieren.

Nächste Schritte

Tipp
Tipp
Wenn Sie nur eine einzelne Web Reputation-bezogene Richtlinieneinstellung festlegen müssen, siehe Konfigurieren einer einzelnen Richtlinie oder Standardrichtlinieneinstellung.
Um das Modul zu aktivieren, erstellen Sie ein WebReputationPolicyExtension-Objekt und setzen Sie den Status:
policy_config_web_reputation = api.WebReputationPolicyExtension()
policy_config_web_reputation.state = "on"
Erstellen Sie ein PolicySettings-Objekt, um Einstellungen im Zusammenhang mit der Web Reputation zu konfigurieren. (Für detaillierte Informationen zu Richtlinieneinstellungen siehe Konfigurieren einer einzelnen Richtlinie oder Standardrichtlinie.) Zum Beispiel können Sie die Sicherheitsstufe festlegen:
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
An diesem Punkt sind die Web Reputation-Richtlinie-Erweiterung und die Richtlinieneinstellungen konfiguriert. Als Nächstes werden sie zu einem Policy-Objekt hinzugefügt. Verwenden Sie dann ein PoliciesApi-Objekt, um eine Richtlinie auf Server- und Workload Protection zu ändern.
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)
Der policy_id (oder policyID) Parameter von modifyPolicy identifiziert die tatsächliche Richtlinie auf Server- und Workload Protection, die geändert werden soll. Diese Richtlinie wird gemäß dem Richtlinienobjekt geändert, das als policy Parameter verwendet wird. Alle Eigenschaften des policy Parameters, die nicht festgelegt sind, bleiben in der tatsächlichen Richtlinie unverändert.

Beispiel Übergeordnetes Thema

Im folgenden Beispiel wird ein WebReputationPolicyExtension-Objekt erstellt, dann der Web Reputation-Status und die Sicherheitsstufe festgelegt und der Smart Protection Server aktiviert. Das Objekt wird dann zu einem Policy-Objekt hinzugefügt, das verwendet wird, um eine Richtlinie auf Server- und Workload Protection zu ändern.
Quelle anzeigen
# 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- und Workload Protection
policies_api = api.PoliciesApi(api.ApiClient(configuration))
modified_policy = policies_api.modify_policy(policy_id, policy, api_version)
return modified_policy.id
Siehe auch die Richtlinie ändern-Operation in der API-Referenz. Informationen zur Authentifizierung von API-Aufrufen finden Sie unter Authentifizierung mit Server- und Workload Protection.