SupportHistoryBanSearchResponse
history objectrequired
First recorded OIDC completion event (oidc.code_issuance or oidc.code_redemption) of the deployment within the event retention. Flows that started before it, or every flow when it is null, predate completion recording and keep FLOW_COMPLETION_NEVER_RECORDED. Null also means the probe failed; then conditions contain COMPLETION_CUTOVER_UNKNOWN.
sources object[]required
Possible values: [logins, auth_events, bruteforce_lifecycle, bruteforce_attempts, bruteforce_attempt_summary]
Possible values: [read, read_failed, not_installed, no_rows_for_deployment, not_queried]
Possible values: [within_retention, partially_expired, expired]
Possible values: [available, partial]
not_guaranteedtarget objectrequired
bans object[]required
activation objectrequired
Possible values: [ban_activated, ban_activation_unconfirmed]
NOT_A_CULPRITend objectrequired
How a ban instance ended as far as recorded. Only released is a recorded end; planned ends are relative to the window end, which is queried_at for ban contexts.
Possible values: [released, superseded_by_new_activation, planned_end_passed_unconfirmed, planned_end_after_window, unknown]
contributions objectrequired
crossing_candidate objectrequired
- object
- null
heuristic_crossed_flagwindows object[]required
Possible values: [activation_window, previous_window]
Possible values: [complete, loss_detected, aggregate_only, expired, not_applicable]
Possible values: [raw, summary, not_read, not_assessed]
items object[]required
Possible values: [complete, loss_detected, aggregate_only, expired, not_applicable]
hits objectrequired
by_source objectrequired
claimants object[]required
Possible values: [raw, summary, not_read, not_assessed]
orphan_hits objectrequired
by_source objectrequired
claimants object[]required
Possible values: [raw, summary, not_read, not_assessed]
threshold_tolerated objectrequired
Possible values: [raw, summary, not_read, not_assessed]
unconfirmed_activations object[]required
Released to the detail projection only.
Possible values: [ban_activation_unconfirmed, ban_released, counters_reset]
releases object[]required
Released to the detail projection only.
Possible values: [ban_activation_unconfirmed, ban_released, counters_reset]
counter_resets object[]required
Released to the detail projection only.
Possible values: [ban_activation_unconfirmed, ban_released, counters_reset]
page objectrequired
Possible values: [support, detail]
Possible values: Value must match regular expression ^1$
Match state of an answer. matches_found wins over every condition; an answer without matches names the state of its primary source (logins for attempts, bruteforce_lifecycle for bans: missing table, no rows, failed read, expired or partially expired window), then truncated evidence, then an unresolved identity, then no_matches. Secondary sources only appear in history.conditions. Never read as "nothing happened".
Possible values: [matches_found, no_matches, identity_unresolved, source_not_installed, source_without_rows, source_read_failed, window_expired, window_partially_expired, evidence_truncated]
{
"queried_at": "2024-07-29T15:51:28.071Z",
"history": {
"contract_rows_since": "2024-07-29T15:51:28.071Z",
"oidc_completion_events_since": "2024-07-29T15:51:28.071Z",
"sources": [
{
"source": "logins",
"state": "read",
"window_coverage": "within_retention",
"retention_days": 0
}
],
"conditions": [
"string"
],
"known_limits": [
"string"
],
"availability": "available",
"deployment": "string",
"delivery_completeness": "not_guaranteed",
"late_events_possible": true
},
"target": {
"ip": "string",
"candidate_networks": [
"string"
]
},
"bans": [
{
"activation": {
"at": "2024-07-29T15:51:28.071Z",
"bucket_id": "string",
"window_index": 0,
"window_current": 0,
"window_previous": 0,
"total": 0,
"effective_limit": 0,
"planned_end": "2024-07-29T15:51:28.071Z",
"kind": "ban_activated",
"rule": "string",
"stored_rule": "string",
"rule_fingerprint": "string",
"instance": "string",
"activating_request": "NOT_A_CULPRIT",
"period_seconds": 0,
"ban_time_seconds": 0,
"failed_requests": 0
},
"end": {
"at": "2024-07-29T15:51:28.071Z",
"release_source": "string",
"reason": "released"
},
"contributions": {
"crossing_candidate": {
"at": "2024-07-29T15:51:28.071Z",
"window_current": 0,
"event_id": "string",
"basis": "heuristic_crossed_flag"
},
"distinct_claimed_names": 0,
"windows": [
{
"expected": 0,
"present": 0,
"window": "activation_window",
"status": "complete",
"evidence": "raw",
"window_index": 0,
"counts_are_upper_bounds": true,
"summary_check_unreliable": true
}
],
"items": [
{
"at": "2024-07-29T15:51:28.071Z",
"window_index": 0,
"window_current": 0,
"crossed": true,
"account_known": true,
"claimed_username": "string",
"account": "string",
"client_ip": "string",
"subject_match": true,
"event_id": "string",
"request_id": "string",
"count_source": "string",
"protocol": "string",
"redacted": true
}
],
"caveats": [
"string"
],
"status": "complete",
"truncated": true
},
"hits": {
"by_source": {},
"distinct_claimed_names": 0,
"subject_hits": 0,
"claimants": [
{
"claimed_username": "string",
"account": "string",
"hits": 0
}
],
"evidence": "raw",
"count": 0,
"count_is_upper_bound": true,
"interval_approximate": true
},
"unknowns": [
"string"
],
"ban_ref": "string",
"network": "string"
}
],
"orphan_hits": {
"by_source": {},
"distinct_claimed_names": 0,
"subject_hits": 0,
"claimants": [
{
"claimed_username": "string",
"account": "string",
"hits": 0
}
],
"evidence": "raw",
"count": 0,
"count_is_upper_bound": true,
"interval_approximate": true
},
"threshold_tolerated": {
"evidence": "raw",
"count": 0,
"count_is_upper_bound": true
},
"unconfirmed_activations": [
{
"at": "2024-07-29T15:51:28.071Z",
"bucket_id": "string",
"release_source": "string",
"operator_client_id": "string",
"keys_removed": 0,
"event_id": "string",
"kind": "ban_activation_unconfirmed",
"network": "string",
"rule": "string"
}
],
"releases": [
{
"at": "2024-07-29T15:51:28.071Z",
"bucket_id": "string",
"release_source": "string",
"operator_client_id": "string",
"keys_removed": 0,
"event_id": "string",
"kind": "ban_activation_unconfirmed",
"network": "string",
"rule": "string"
}
],
"counter_resets": [
{
"at": "2024-07-29T15:51:28.071Z",
"bucket_id": "string",
"release_source": "string",
"operator_client_id": "string",
"keys_removed": 0,
"event_id": "string",
"kind": "ban_activation_unconfirmed",
"network": "string",
"rule": "string"
}
],
"page": {
"next_cursor": "string",
"limit": 0
},
"projection": "support",
"schema_version": "string",
"result_basis": "matches_found"
}