Home / Integrations / ServiceNow

ServiceNow integration: every browser attack becomes a ticket.

Most security teams track their work in ServiceNow. A short script that runs every few minutes asks ByteMantle for the open incidents and creates one ServiceNow incident for each new one, through ServiceNow's own Table API. Nothing has to be installed in ServiceNow.

What it does

  • One ticket per incident. Each ByteMantle incident becomes one ServiceNow incident, marked with correlation_id = bytemantle-<incident number>. The script checks first whether it already exists, so running it again never creates duplicates.
  • Severity mapped. Critical becomes urgency and impact 1 / 1, high 2 / 2, medium 3 / 2; low and informational incidents are left out.
  • What the ticket says. The incident's title and severity, the site, the browser, when it started, how many events it has, and a link back to the incident in the console, where the whole chain is: where the user came from, which script loaded which, the command and how it ended.

What you need

  • In ServiceNow (your administrator, once): a user for the integration with the itil role, and your instance address.
  • In ByteMantle: a Read API key (Admin → API Keys), available in the Enterprise plan.
  • A machine or scheduled job that runs the script every few minutes.

The script, ready to copy, with every setting explained: ServiceNow: an incident for every ByteMantle incident. It is tested against a stand-in that answers exactly like the ServiceNow Table API; try it on your development instance first.

Without a script

If your ServiceNow administrator prefers to receive events instead, they can create a Scripted REST API in ServiceNow that accepts the JSON batch format of the SIEM forwarding (Pro, Business and Enterprise plans), and add it as a destination under Admin → SIEM. Then every threat event arrives in ServiceNow within a minute.

Related

Stop these attacks before anything runs.

Free browser protection for everyone, in Chrome and Edge. One console for your whole company when you need it.

Get the extension — free