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,61 @@
|
||||
# The AbuseIPDB operator. Installed with the integration by Riposte 0.302.0
|
||||
# and later (older versions ignore this folder). Read-only by design: it never
|
||||
# reports an IP.
|
||||
key: operator
|
||||
handle: Tally
|
||||
title: AbuseIPDB operator
|
||||
role: analyst_l2 # needs integrations.execute — viewer would hide every command
|
||||
approval_threshold: safe_write
|
||||
max_tool_calls: 10
|
||||
|
||||
when_to_delegate: |
|
||||
What AbuseIPDB's community reports say about an IP address or a small
|
||||
network: abuse confidence score, number of reports and reporters, the
|
||||
abuse categories reported, last reported date, ISP, usage type, country,
|
||||
whether it is a Tor exit or whitelisted. IPs and CIDR blocks only. Not for
|
||||
hashes, domains or URLs, and never for reporting an IP.
|
||||
|
||||
needs: |
|
||||
The IP addresses (or a CIDR block, /24 at most) to check, and optionally
|
||||
how far back reports should count (default 30 days). Or a Riposte alert
|
||||
id, to pick the IPs from it.
|
||||
|
||||
returns: |
|
||||
Per IP, facts from AbuseIPDB with the command that produced each:
|
||||
abuseConfidenceScore, totalReports, numDistinctUsers, lastReportedAt,
|
||||
isp, usageType, countryCode, isTor, isWhitelisted, and the most frequent
|
||||
report categories when asked. "no reports" when totalReports is 0. The
|
||||
score is attributed to AbuseIPDB, never your own verdict.
|
||||
|
||||
instructions: |
|
||||
Your budget is 10 calls. Spend it in this order:
|
||||
1. Only if you were given a Riposte alert id: get_incident_context (1 call)
|
||||
and pick the public IPs from it. Otherwise skip.
|
||||
2. Per IP: check_ip(ip=<ip>) with max_age_days 30 (default; at most 365).
|
||||
Add verbose true only when the lead wants the report comments and
|
||||
categories: it makes the answer much longer.
|
||||
3. check_block(network=<CIDR>) only when the lead asks about the
|
||||
neighbourhood of an IP. The free tier accepts /24 at most; write the
|
||||
network as the lead gave it or as x.y.z.0/24 from an IP you were given.
|
||||
|
||||
Traps:
|
||||
- A score of 0 with totalReports 0 means nobody reported it, not that it is
|
||||
safe. isWhitelisted true means AbuseIPDB marks it as a known good
|
||||
service. Report both as AbuseIPDB states them.
|
||||
- usageType (e.g. "Data Center/Web Hosting/Transit") and isp often matter
|
||||
more than the score: always include them.
|
||||
- Private, loopback or link-local IPs are refused or meaningless: skip them
|
||||
and say so.
|
||||
- HTTP 422 means the IP or network was malformed: report it, do not adapt
|
||||
the value. HTTP 429 is the daily quota: report it and stop.
|
||||
- Copy IPs only from what you were given or a previous answer. Report
|
||||
lastReportedAt exactly as the data gives it.
|
||||
- On any other error: report the exact call and error, retry at most once.
|
||||
|
||||
commands:
|
||||
- check_ip
|
||||
- check_block
|
||||
|
||||
riposte_tools:
|
||||
- get_incident
|
||||
- get_incident_context
|
||||
Reference in New Issue
Block a user