SupportHistoryAttemptSearchResponse
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_guaranteedsubject_resolution objectrequired
accounts object[]required
Possible values: [supplied_account, current_account_mapping, recorded_at_event]
Possible values: [resolved, unmapped, unavailable, not_attempted]
attempts object[]required
completion objectrequired
- SupportHistoryCompletion
- null
Recorded OIDC authorization-code completion of one flow. Nauthilus's part ends with the token response for the flow's code (state tokens_issued); a relying-party session after it is never observed. Only authorization-code flows carry this block; SAML, device-code, flows without grant evidence, and latched flows (decided by the latch) have none.
Latest instant the issued code could be redeemed (event contract version lifetime); null without issuance or for an unknown version.
oidc_authorization_codetokens_issued, redemption_rejected, and redemption_failed are observed and final. redemption_pending: the code may still be redeemed or its redemption still be exported. code_expired_redemption_not_observed: the code can no longer be redeemed and no redemption was observed; an event may have been dropped, so it never proves an abort. code_issuance_not_observed: recording was active, but neither issuance nor redemption was observed. not_recorded: the flow predates completion recording. unknown: evidence was unreadable, truncated, conflicting, or unclassified.
Possible values: [tokens_issued, redemption_rejected, redemption_failed, redemption_pending, code_expired_redemption_not_observed, code_issuance_not_observed, not_recorded, unknown]
How the flow got its authenticated identity, as recorded with the code issuance; unknown without an observed issuance.
Possible values: [authenticated_in_flow, existing_session, not_recorded, unknown]
findings object[]required
Possible values: [success, credential, second_factor, pre_credential, policy, technical, flow_state, client_request, unknown]
Possible values: [observed, uncertain]
events object[]required
decision objectrequired
- SupportHistoryDecision
- null
Stored host status code selected for the sealed terminal decision (logins.http_status: the configured OK/Fail/InternalError code; 200 for nginx-style answers, also for rejections). It is not the committed transport status (context.transport_status) and never a result: read outcome. Null when no terminal decision was sealed.
Stored status text the host answered the authentication caller with (logins.status_msg). IdP browser pages render their own localized text, so this is not necessarily what a user saw. Null when no terminal decision was sealed, and in the support projection on events whose identity is redacted.
factor objectrequired
- SupportHistoryFactor
- null
reputation objectrequired
- SupportHistoryReputation
- null
assessments object[]required
Possible values: [recorded, none_recorded, legacy_not_projected]
identity objectrequired
context objectrequired
Possible values: [logins, auth_events]
Possible values: [primary_authentication, second_factor, pre_credential, legacy, authorization, token_exchange, unclassified]
recording objectrequired
steps objectrequired
session_reused marks an OIDC flow that /authorize started for an already authenticated session; no primary step happened in it.
Possible values: [recorded, not_recorded, session_reused]
Possible values: [recorded, not_recorded, withheld, not_applicable]
Possible values: [recorded, not_recorded, not_applicable]
Possible values: [recorded, not_recorded, not_applicable]
Possible values: [flow, request]
Possible values: [support, detail]
Possible values: [succeeded, rejected, technical_error, not_observed, unknown]
The recorded evidence of the outcome. outcome never names a cause: oidc_code_redemption_rejected after a successful login is a rejected token request of the client, not a credential failure. Show outcome_basis and the findings together with outcome.
Possible values: [request_terminal_answer, primary_failure_latched, primary_failure_kept, none, legacy, oidc_tokens_issued, oidc_code_redemption_rejected, oidc_code_redemption_failed]
Possible values: [none, technical_error, pre_credential_rejected, primary_rejected, primary_succeeded, second_factor_completed, primary_failure_latched, authorization_code_issued, tokens_issued]
page objectrequired
The search covered (scanned_until, until) completely; attempts anchored exactly at scanned_until can follow on the next page.
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]
Present only when the request named response_mode; compact answers carry an empty attempts list.
Possible values: [detailed, compact]
attempt_summaries object[]
Present only in compact mode; one summary per found attempt, in the order of attempts.
Code of the last finding of an attempt that did not succeed, for example REJECTED_BY_BRUTE_FORCE_PROTECTION; null otherwise.
detail objectrequired
Arguments of authentication_attempt_detail for this attempt.
Client addresses of the subject's rows.
Request ids of the subject's login rows.
Possible values: [flow, request]
ban_contexts object[]
Present only with include_ban_context; one entry per brute-force rejected subject request of the page.
bans object[]required
detail objectrequired
The full ban explanation of bruteforce_history in detailed mode; null in compact mode.
- SupportHistoryBan
- null
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]
attribution objectrequired
Under which accounts the listed contributions of one ban were recorded; never who caused the ban. Codes are computed on unredacted rows, so hidden identities never make an answer look exclusive.
Distinct recorded accounts of the listed contributions; null unless the caller has history_detail.
subject_contributions object[]required
Possible values: <= 50
The increment was counted while a ban was active.
The attempt of this page the request belongs to, if any.
login_claim only means the same login name was typed; it cannot tell the customer from anybody else.
Possible values: [recorded_account, login_claim]
counts objectrequired
Claims that resolved to no account at capture time (often typos).
Claims whose account was not recorded; aliases of the subject can hide here.
SUBJECT_ACCOUNT: contributions recorded under the requested account (a recorded account, never only the same login name), exclusive only with other_contributors none_observed. MULTIPLE_ACCOUNTS: under the requested and another recorded account. OTHER_ACCOUNTS_ONLY: only other recorded accounts with complete evidence and no unresolved, account-less, or subject-name claim. Otherwise NOT_SUFFICIENTLY_ATTRIBUTABLE.
Possible values: [SUBJECT_ACCOUNT, MULTIPLE_ACCOUNTS, OTHER_ACCOUNTS_ONLY, NOT_SUFFICIENTLY_ATTRIBUTABLE]
Possible values: [observed, none_observed, unknown]
NOT_ESTABLISHEDevidence objectrequired
Coverage of the contributions only; never evidence of a responsible person, NAT, or VPN.
Possible values: [complete, aggregate_only, loss_detected, expired, not_applicable, not_read]
Stable codes: ban unknowns, caveats, and attribution limits.
end 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]
ban_history objectrequired
Arguments of bruteforce_history that explain this ban instance.
Possible values: [ip, network]
Possible values: [FAILURE_THRESHOLD_EXCEEDED, ACTIVATION_UNCONFIRMED]
How the request relates to the ban; the activating request is never a culprit.
Possible values: [ACTIVATING_REQUEST, ACTIVATION_UNCONFIRMED, HIT_EXISTING_BAN, ACTIVATION_RACE, INTERVAL_OVERLAP]
REJECTED_BY_BRUTE_FORCE_PROTECTIONmatched: linked by a recorded hit or activation; overlap_only: only by the ban interval; several bans are all listed, never one picked.
Possible values: [matched, overlap_only, no_recorded_ban, not_evaluated]
ban_history object
Present only with include_ban_context when brute-force evidence is configured; coverage of the brute-force sources.
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_guaranteed{
"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
},
"subject_resolution": {
"supplied_login": "string",
"supplied_account": "string",
"accounts": [
{
"account": "string",
"provenance": "supplied_account"
}
],
"current_mapping": "resolved"
},
"attempts": [
{
"started_at": "2024-07-29T15:51:28.071Z",
"last_observed_at": "2024-07-29T15:51:28.071Z",
"completion": {
"code_issued_at": "2024-07-29T15:51:28.071Z",
"code_redeemable_until": "2024-07-29T15:51:28.071Z",
"redemption_observed_at": "2024-07-29T15:51:28.071Z",
"scope": "oidc_authorization_code",
"state": "tokens_issued",
"authentication": "authenticated_in_flow"
},
"findings": [
{
"event_id": "string",
"uncertainty": [
"string"
],
"code": "string",
"category": "success",
"certainty": "observed"
}
],
"events": [
{
"occurred_at": "2024-07-29T15:51:28.071Z",
"event_id": "string",
"factor_role": "string",
"method": "string",
"decision": {
"brute_force_bucket": "string",
"brute_force_tolerated": true,
"answered_status_code": 0,
"answered_status_message": "string",
"decision_sources": [
"string"
],
"operation": "string",
"outcome": "string",
"outcome_stage": "string",
"outcome_marker": "string",
"response_marker": "string",
"policy_rule": "string",
"tempfail_reason": "string",
"tempfail_checkpoint": "string",
"policy_status": "string",
"fsm_state": "string"
},
"factor": {
"result": "string",
"reason": "string",
"flow_effect": "string",
"fail_latched": true
},
"reputation": {
"assessments": [
{
"risk_score": 0,
"trust_score": 0,
"confidence": 0,
"samples": 0,
"source_diversity": 0,
"age_seconds": 0,
"fact": "string",
"role": "string",
"kind": "string",
"state": "string",
"profile": "string",
"band": "string",
"override": "string"
}
],
"state": "recorded",
"truncated": true
},
"identity": {
"supplied_login": "string",
"canonical_account": "string",
"account_found_at_capture": true,
"matched_by": "string",
"subject_match": true,
"redacted": true
},
"context": {
"client_ip": "string",
"protocol": "string",
"service": "string",
"oidc_client_id": "string",
"saml_entity_id": "string",
"grant_type": "string",
"transport": "string",
"transport_status": 0
},
"source": "logins",
"request_id": "string",
"instance": "string",
"stage": "primary_authentication",
"result": "string",
"code": "string",
"category": "string",
"sequence": 0,
"record_version": 0
}
],
"recording": {
"known_gaps": [
"string"
],
"replayed_rows_merged": 0,
"legacy_rows": 0,
"events_truncated": true,
"events_withheld": true
},
"steps": {
"primary": "recorded",
"second_factor": "recorded",
"code_issuance": "recorded",
"code_redemption": "recorded"
},
"attempt_id": "string",
"kind": "flow",
"projection": "support",
"outcome": "succeeded",
"outcome_basis": "request_terminal_answer",
"progress": "none",
"final_outcome_observed": true
}
],
"page": {
"scanned_until": "2024-07-29T15:51:28.071Z",
"next_cursor": "string",
"limit": 0
},
"schema_version": "string",
"result_basis": "matches_found",
"response_mode": "detailed",
"attempt_summaries": [
{
"started_at": "2024-07-29T15:51:28.071Z",
"last_observed_at": "2024-07-29T15:51:28.071Z",
"reason": "string",
"detail": {
"attempt_id": "string",
"around": "2024-07-29T15:51:28.071Z"
},
"finding_codes": [
"string"
],
"client_ips": [
"string"
],
"protocols": [
"string"
],
"request_ids": [
"string"
],
"known_gaps": [
"string"
],
"attempt_id": "string",
"kind": "flow",
"outcome": "string",
"outcome_basis": "string",
"progress": "string",
"final_outcome_observed": true,
"events_truncated": true,
"events_withheld": true
}
],
"ban_contexts": [
{
"at": "2024-07-29T15:51:28.071Z",
"client_ip": "string",
"bans": [
{
"activated_at": "2024-07-29T15:51:28.071Z",
"planned_end": "2024-07-29T15:51:28.071Z",
"detail": {
"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"
},
"attribution": {
"contributing_accounts": "Unknown Type: array,null",
"subject_contributions": [
{
"at": "2024-07-29T15:51:28.071Z",
"window_index": 0,
"window_current": 0,
"ban_active": true,
"attempt_id": "string",
"event_id": "string",
"request_id": "string",
"count_source": "string",
"protocol": "string",
"matched_by": "recorded_account"
}
],
"counts": {
"listed": 0,
"subject_by_account": 0,
"subject_by_login_claim": 0,
"other_accounts": 0,
"distinct_other_accounts": 0,
"no_account": 0,
"unresolved": 0,
"counted_while_banned": 0
},
"code": "SUBJECT_ACCOUNT",
"other_contributors": "observed",
"person_attribution": "NOT_ESTABLISHED",
"identities_redacted": true,
"subject_contributions_truncated": true
},
"evidence": {
"completeness": "complete",
"limitations": [
"string"
]
},
"end": {
"at": "2024-07-29T15:51:28.071Z",
"release_source": "string",
"reason": "released"
},
"ban_history": {
"from": "2024-07-29T15:51:28.071Z",
"until": "2024-07-29T15:51:28.071Z",
"ban_ref": "string",
"network": "string"
},
"ban_ref": "string",
"network": "string",
"scope": "ip",
"rule": "string",
"activation_reason": "FAILURE_THRESHOLD_EXCEEDED",
"subject_relation": "ACTIVATING_REQUEST"
}
],
"limitations": [
"string"
],
"attempt_id": "string",
"request_id": "string",
"reason": "REJECTED_BY_BRUTE_FORCE_PROTECTION",
"status": "matched"
}
],
"ban_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
}
}