Get the IP penalties in force, soonest to expire first.
An IP penalty limits one IP address to a number of requests per minute, on every endpoint of
this instance, until it expires. A per_minute_limit of 0 refuses every request. A refused
request gets 429 OBP-10062. Penalties are always
enforced, are shared by every instance (they are kept in Redis), and disappear by themselves
when they expire. The endpoints under /management/ip-penalties are never refused because of a
penalty, so a mistake can always be undone.
The address is the client address OBP-API resolves for the request. Behind a proxy that does not
pass on the client's address, that is the proxy's address, and a penalty on it restricts
everyone behind the proxy.
User Authentication is Required. The User must be logged in. The Application must also be authenticated.
JSON response body fields (7)
created_at
created_at
created_by_user_id
expires_at
expires_at
ip_address
198.51.100.42
ip_penalties
ip_penalties
per_minute_limit
per_minute_limit
reason
reason
Example success response
{
"ip_penalties": [
{
"ip_address": "203.0.113.42",
"per_minute_limit": 10,
"reason": "Vulnerability scan: about 900 requests a minute to resource-docs with changing filters",
"created_by_user_id": "9ca9a7e4-6d02-40e3-a129-0b2bf89de9b1",
"created_at": "1100-01-01T01:01:01Z",
"expires_at": "1100-01-01T01:01:01Z"
}
]
}
Possible errors (3)
OBP-20001: User not logged in. Authentication is required!