API reference · Account and billing
Abuse incidents
1 operation of the Ankra Cloud API: Abuse incidents raised from connection metadata of a server's outbound traffic (never a payload): port scans, SSH or RDP brute force, outbound floods, spam, contact with botnet command-and-control servers and mining pools. An account reads its own; Ankra's staff tell the account, quarantine the server's network (the server keeps running with its disks), release it or dismiss the incident.
The account's abuse incidents, newest first#
/v1/abuse-incidents- Operation
list_abuse_incidents- Credentials
- API token, Portal session
- Requires
- Permission
read
What Ankra saw coming from the account's servers, from connection metadata only (never a payload). An incident
in status quarantined is why a server has no network: the server keeps running with its disks until Ankra
releases it. active=true keeps the open, notified and quarantined ones.
Parameters
| Name | In | Type | Description |
|---|---|---|---|
active | query | boolean | Only incidents that still stand. |
cursor | query | string | The next_cursor of the previous page. |
limit | query | integer | Page size; the server applies its default and maximum. |
Responses
200A page of incidents (limit at most 100, default 20).application/json · AbuseIncidentList
| Field | Type | Description |
|---|---|---|
itemsrequired | array of AbuseIncident | |
idrequired | string | |
server_idrequired | string | |
server_hostnamerequired | string | |
zonerequired | string | |
rulerequired | string | One of port_scan, brute_force, outbound_flood, spam, command_and_control, mining_pool |
severityrequired | string | One of low, medium, high |
confidencerequired | string | One of low, medium, high |
statusrequired | string | open, notified and quarantined incidents still stand; released and dismissed are final.One of open, notified, quarantined, released, dismissed |
summaryrequired | string | What was seen in the last sample that fired the rule. |
evidencerequired | AbuseEvidence | The numbers the incident was last raised on, over one sample window. Never a payload. |
window_secondsrequired | integer (int64) | |
new_outbound_connectionsrequired | integer (int64) | |
outbound_connectionsrequired | integer (int64) | |
distinct_destination_addressesrequired | integer (int64) | |
distinct_destination_portsrequired | integer (int64) | |
unanswered_syn_connectionsrequired | integer (int64) | |
peak_transmitted_packets_per_secondrequired | integer (int64) | |
peak_transmitted_bytes_per_secondrequired | integer (int64) | |
baseline_packets_per_secondrequired | number | The server's own normal outbound rate. |
baseline_bytes_per_secondrequired | number | |
ssh_connectionsrequired | integer (int64) | |
ssh_destination_addressesrequired | integer (int64) | |
rdp_connectionsrequired | integer (int64) | |
rdp_destination_addressesrequired | integer (int64) | |
smtp_connectionsrequired | integer (int64) | |
smtp_destination_addressesrequired | integer (int64) | |
matched_addressrequired | string | The destination a threat intelligence list names; empty for other rules. |
matched_listrequired | string | The list that names it: feodo_tracker or mining_pools; empty for other rules. |
is_truncatedrequired | boolean | The server tracked more connections than one sample reads; the counts cover those read. |
observationsrequired | integer (int64) | How many samples fired the rule while the incident stood. |
first_seen_atrequired | string (date-time) | |
last_seen_atrequired | string (date-time) | |
notified_atrequired | string (date-time) | null | |
quarantined_atrequired | string (date-time) | null | |
released_atrequired | string (date-time) | null | |
dismissed_atrequired | string (date-time) | null | |
next_cursorrequired | string | null | Pass as ?cursor= for the next page; null on the last page. |
- 400The request is invalid;
detailsays why. - 401Not signed in, or the credential is invalid or expired.
- 403The role lacks the permission, the token is read-only (a read-only token also gets
reason: read_only_token_cannot_read_credentialson every credential read), the CSRF header is missing, a support session may not do this, or the route needs a verified email address and the caller's is not (reason: email_unverified). - 429Rate limited. On a customer operation the credential (the API token, or the signed-in user for a session) is over its requests per minute and the
X-RateLimit-*headers say when the window ends; on a sign-in route the client network is over its attempts or the email is locked out. - defaultAny other error, usually 500.
Example
curl 'https://cloud.ankra.app/v1/abuse-incidents' \
-H "Authorization: Bearer $ANKRA_CLOUD_TOKEN"