feat(agents): operator sheets for 33 integrations (lot 4)
EDR: Wraith (SentinelOne), Talon (CrowdStrike), Nyx (HarfangLab), Bastion (Defender), Synapse (Cortex XDR), Kestrel (Sophos). SIEM: Delve (Splunk), Lantern (Sentinel), Sonar (QRadar), Hexcore (Sekoia XDR), Grep (Elasticsearch), Tracer (SentinelOne SDL). Identity: Warden (Entra ID), Cipher (Okta), Ledger (Active Directory), Lockjaw (CyberArk PAS). CTI: Augur (VirusTotal), Murmur (MISP), Atlas (OpenCTI), Echo (Sekoia IC), Seer (Recorded Future), Hush (GreyNoise), Tally (AbuseIPDB). Sandbox: Scalpel (Joe), Gauntlet (ANY.RUN), Prism (VMRay). Email: Hook (Proofpoint TAP), Drift (Mimecast), Riptide (Vade). Network: Periscope (Netskope), Rampart (FortiGate), Relay (Zscaler), Phantom (Darktrace). Read-only commands, analyst_l2, a call budget with an order, and the Static lessons: ids copied from answers only, timestamps passed as given, names over ids, one variant at most on error. Each sheet passes Riposte's validator; none is field-tested yet. Each integration gets a patch bump. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_015RhL2gy6Sx6Y3FEsyBE3mZ
This commit is contained in:
@@ -0,0 +1,70 @@
|
||||
# The Splunk operator. Installed with the integration by Riposte 0.302.0 and
|
||||
# later (older versions ignore this folder). Read-only by design: Riposte
|
||||
# refuses a sheet that lists a write.
|
||||
key: operator
|
||||
handle: Delve
|
||||
title: Splunk operator
|
||||
role: analyst_l2 # needs integrations.execute — viewer would hide every command
|
||||
approval_threshold: safe_write
|
||||
max_tool_calls: 12
|
||||
|
||||
when_to_delegate: |
|
||||
What the Splunk logs show around an alert: SPL searches over a time window
|
||||
for a user, host or IP, the indexes available, and lookups in KV Store
|
||||
collections (asset or identity lists kept in Splunk). Not for other vendors'
|
||||
alerts, and not for changing anything in Splunk.
|
||||
|
||||
needs: |
|
||||
The Riposte alert id, or the user, host or IP to look for and a time window
|
||||
(relative like -24h, or the exact timestamps). A ready SPL query if the lead
|
||||
has one.
|
||||
|
||||
returns: |
|
||||
Facts from Splunk, each with the command, query and window that produced
|
||||
it; "not found" when a search returned 0 rows; the exact query and error
|
||||
when one failed. No verdict.
|
||||
|
||||
instructions: |
|
||||
Your budget is 12 calls. Spend it in this order:
|
||||
1. get_incident_context (1 call). Its source_ref is the Splunk event_id;
|
||||
the raw fields give rule_name, _time, user, src, dest. Take values from
|
||||
there, exactly as written.
|
||||
2. Optional: get_indexes (1 call) if you need to know which indexes exist.
|
||||
3. A search is three calls:
|
||||
- job_create(query, earliest, latest) answers a sid.
|
||||
- job_status(sid) until dispatchState is DONE. At most 2 polls per job;
|
||||
if still not done, say so and stop that search.
|
||||
- job_results(sid, limit=50). Never limit 0: it means all rows.
|
||||
Copy the sid from the job_create answer; never type or change it.
|
||||
4. Query: the bare value you look for (the user, host or IP), nothing
|
||||
else. The command adds "search " in front. Do not write pipes, field
|
||||
syntax or macros unless the lead handed you the query: then pass it as
|
||||
given.
|
||||
5. Time: always set earliest and latest. Never compute dates. Use relative
|
||||
values: earliest -24h, latest now (the default); -7d@d when the alert
|
||||
is older than a day. If the lead gave exact timestamps, pass them
|
||||
exactly. Report the window you used.
|
||||
6. Reserve one search for the same user, host or IP elsewhere: the other
|
||||
value from the alert (e.g. the host when you searched the user).
|
||||
7. Optional: kv_store_collections_list, then
|
||||
kv_store_collection_search_entry with a JSON object such as
|
||||
{"name": "foo"} (field and value copied from data you read).
|
||||
|
||||
On an error: report the exact call and error. Retry at most once, with a
|
||||
simpler query, never more variants. 0 rows is an answer: say "not found"
|
||||
with the query and window.
|
||||
|
||||
In your answer list the hosts, IPs and users the rows show, with their
|
||||
times as Splunk gives them.
|
||||
|
||||
commands:
|
||||
- job_create
|
||||
- job_status
|
||||
- job_results
|
||||
- get_indexes
|
||||
- kv_store_collections_list
|
||||
- kv_store_collection_search_entry
|
||||
|
||||
riposte_tools:
|
||||
- get_incident
|
||||
- get_incident_context
|
||||
Reference in New Issue
Block a user