Skip to content

Documentation

Webhook presets

This guide lists the ready-made starting points under Settings → Webhooks → New webhook, what each one sends, and what you must fill in. How webhooks work in general is in Webhooks.

Before you start

  • A preset is only a starting point: every request stays editable, and a new webhook starts in Dry run.
  • Presets follow the vendors' public API documentation. Products and versions differ, so every preset says Tested against a simulator only — verify with your product version. Test it with Test → Dry run, then Send once against a test system, before you switch it to Live.
  • Every secret below is typed on the Connection tab under Secrets and never shown again.

Network access control

Network access control (NAC) presets tell the NAC whether each MAC address of a host belongs to a compliant, managed host.

PresetWhat it doesYou fill in
Cisco ISE ERS – endpoint attributesFor every MAC address of the host: finds the endpoint, creates or updates the custom attribute LEA_Compliant (true/false), then reads it back until ISE reports the new value. A removed MAC address is set to false.Base URL (port 9060), ERS admin user name and password. In ISE: turn on ERS and create the custom endpoint attribute LEA_Compliant (String)
Cisco ISE ERS – ANC quarantineApplies the Adaptive Network Control policy in Variables (anc_policy, default LEA_Quarantine) to every MAC address of a non-compliant managed host, and clears it when the host is compliant, deactivated, deleted or loses the MAC address.Base URL, ERS admin user name and password, the ANC policy in ISE
Aruba ClearPass – endpoint attributesSets the endpoint attributes LEA Compliant and LEA Host of every MAC address, creating the endpoint when it is missing.Base URL, API client ID and secret (an API client with the client credentials grant)
Cisco API ProxyThe integration of webhooks from before this version: for every MAC address a lookup (GET <URL>/<mac>), then a create (POST) or an update (PATCH) of u_mac_address, k_bool_linux_managed, c_bool_linux_managed_compliant and k_epoch_linux_managed_lifetime when the managed or compliant state changed. A removed MAC address is set to not compliant.Cisco API Proxy URL, optional API key and secret (basic authentication)

Use the attribute or the ANC policy in your authorization policy, for example: LEA_Compliant EQUALS false → limited access.

Firewalls

Firewall presets put the IP address of a non-compliant managed host into a group that a security policy uses, and take it out when the host is fixed.

PresetWhat it doesYou fill in
Palo Alto Networks – dynamic address group tagRegisters the host IP with the tag in Variables (tag, default lea-noncompliant) through the User-ID XML API, and unregisters it when the host is compliant or deactivated. The answer is checked for status="success".Base URL, PAN-OS API key (secret token). In PAN-OS: a dynamic address group matching the tag
FortiGate – address group membershipCreates the address object LEA_<host name> (host IP /32) and adds it to the address group in Variables (group, default LEA_NonCompliant, VDOM vdom), and removes it from the group when the host is fixed.Base URL, REST API administrator token (secret token), the address group

Hosts without an IP address are skipped.

Ticketing

Ticketing presets open a ticket when a rule starts failing on a host and close it when the rule passes again.

PresetWhat it doesYou fill in
ServiceNow – incidents and CMDBOpens an incident on Rule fails on host and resolves it on Rule passes on host (the incident is remembered per host and rule). Keeps the field u_lea_compliant of the matching cmdb_ci_computer up to date.Instance URL, integration user and password. Create u_lea_compliant or turn off the host events
Jira / Jira Service Management – issuesCreates an issue labeled lea-<host id>-<rule id> (searched first, so there are no duplicates) and runs your "done" transition when the rule passes.Site URL, e-mail and API token, project key (project), transition id (done_transition_id)
GitHub – issues / GitLab – issuesOpens one issue per rule when the first host in scope fails it, and closes it when the last one is fixed.Token, owner and repository (GitHub) or base URL and project id (GitLab)

Security monitoring

SIEM presets send every event with its full context, so you can search and correlate it next to your other logs.

PresetWhat it doesYou fill in
Splunk – HTTP Event CollectorOne HEC event per LEA Platform event (sourcetype and index in Variables); the answer is checked for code 0.Base URL (port 8088), HEC token (secret token)
Elastic – index documentsOne document per event in the index in Variables (index).Base URL, encoded API key (secret token)
Microsoft Sentinel – Logs Ingestion APIOne row per event in a custom table through a data collection endpoint and rule.Logs ingestion URL, tenant id, app client id and secret, DCR immutable id, stream name
Datadog – eventsOne event per compliance change of a host or of a rule on a host, tagged with host, rule and severity.Datadog API key (secret api_key); the base URL for other Datadog sites

Paging and remediation

These presets wake someone up or start an automatic fix when a rule fails on a host.

PresetWhat it doesYou fill in
PagerDuty – Events API v2Triggers an alert on Rule fails on host and resolves it when the rule passes or no longer applies (dedup key lea-<host id>-<rule id>).Integration (routing) key, secret routing_key
Opsgenie – alertsCreates an alert and closes it by its alias.API integration key (secret token); api.eu.opsgenie.com for the EU
Ansible AWX / Automation Controller – launch a jobLaunches the job template (job_template_id) limited to the failing host, with lea_host, lea_host_ip, lea_rule, lea_rule_uid and lea_severity as extra variables.Base URL, token, job template id. The template must prompt for variables and limit on launch

Generic

PresetWhat it doesYou fill in
Generic JSON webhookOne POST per event to the base URL with event, host, rule and result as JSON.Base URL

Note: There is no preset yet for FortiNAC. Build it with Blank webhook, or ask your LEA Platform contact for a preset.

If something goes wrong

SymptomFix
A preset fails with HTTP 404 on every requestThe path differs in your product version. Compare the step URL with your API documentation and edit it
ISE answers 401The account needs the ERS Admin role and ERS must be turned on (Administration → System → Settings → API Settings)
ISE fails with "still reports LEA_Compliant=…"The attribute is missing in ISE or a policy overwrites it; check the endpoint in ISE
PAN-OS: "PAN-OS answered … status="error""The API key lacks the User-ID permission, or the tag name is invalid
Splunk: "HEC answered …"The token is disabled or not allowed to write to the index