Skip to main content
Version: 4.1

SupportHistoryAttempt

started_atstring<date-time>required
last_observed_atstring<date-time>required
completion objectrequired
oneOf

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.

code_issued_at(string | null)<date-time>nullablerequired
code_redeemable_until(string | null)<date-time>nullablerequired

Latest instant the issued code could be redeemed (event contract version lifetime); null without issuance or for an unknown version.

redemption_observed_at(string | null)<date-time>nullablerequired
scopestringrequired
Constant value: oidc_authorization_code
statestringrequired

tokens_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]

authenticationstringrequired

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
  • Array [
  • event_idstring | nullnullablerequired
    uncertaintystring[]required
    codestringrequired
    categorystringrequired

    Possible values: [success, credential, second_factor, pre_credential, policy, technical, flow_state, client_request, unknown]

    certaintystringrequired

    Possible values: [observed, uncertain]

  • ]
  • events object[]required
  • Array [
  • occurred_atstring<date-time>required
    event_idstring | nullnullablerequired
    factor_rolestring | nullnullablerequired
    methodstring | nullnullablerequired
    decision objectrequired
    oneOf
    brute_force_bucketstring | nullnullablerequired
    brute_force_toleratedboolean | nullnullablerequired
    answered_status_codeinteger | nullnullablerequired

    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.

    answered_status_messagestring | nullnullablerequired

    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.

    decision_sourcesstring[]required
    operationstringrequired
    outcomestringrequired
    outcome_stagestringrequired
    outcome_markerstringrequired
    response_markerstringrequired
    policy_rulestringrequired
    tempfail_reasonstringrequired
    tempfail_checkpointstringrequired
    policy_statusstringrequired
    fsm_statestringrequired
    factor objectrequired
    oneOf
    resultstringrequired
    reasonstringrequired
    flow_effectstringrequired
    fail_latchedbooleanrequired
    reputation objectrequired
    oneOf
    assessments object[]required
  • Array [
  • risk_scorenumber | nullnullablerequired
    trust_scorenumber | nullnullablerequired
    confidencenumber | nullnullablerequired
    samplesnumber | nullnullablerequired
    source_diversityinteger | nullnullablerequired
    age_secondsinteger | nullnullablerequired
    factstringrequired
    rolestringrequired
    kindstringrequired
    statestringrequired
    profilestringrequired
    bandstringrequired
    overridestringrequired
  • ]
  • statestringrequired

    Possible values: [recorded, none_recorded, legacy_not_projected]

    truncatedbooleanrequired
    identity objectrequired
    supplied_loginstring | nullnullablerequired
    canonical_accountstring | nullnullablerequired
    account_found_at_captureboolean | nullnullablerequired
    matched_bystring | nullnullablerequired
    subject_matchbooleanrequired
    redactedbooleanrequired
    context objectrequired
    client_ipstring | nullnullablerequired
    protocolstring | nullnullablerequired
    servicestring | nullnullablerequired
    oidc_client_idstring | nullnullablerequired
    saml_entity_idstring | nullnullablerequired
    grant_typestring | nullnullablerequired
    transportstring | nullnullablerequired
    transport_statusinteger | nullnullablerequired
    sourcestringrequired

    Possible values: [logins, auth_events]

    request_idstringrequired
    instancestringrequired
    stagestringrequired

    Possible values: [primary_authentication, second_factor, pre_credential, legacy, authorization, token_exchange, unclassified]

    resultstringrequired
    codestringrequired
    categorystringrequired
    sequenceintegerrequired
    record_versionintegerrequired
  • ]
  • recording objectrequired
    known_gapsstring[]required
    replayed_rows_mergedintegerrequired
    legacy_rowsintegerrequired
    events_truncatedbooleanrequired
    events_withheldbooleanrequired
    steps objectrequired
    primarystringrequired

    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]

    second_factorstringrequired

    Possible values: [recorded, not_recorded, withheld, not_applicable]

    code_issuancestringrequired

    Possible values: [recorded, not_recorded, not_applicable]

    code_redemptionstringrequired

    Possible values: [recorded, not_recorded, not_applicable]

    attempt_idstringrequired
    kindstringrequired

    Possible values: [flow, request]

    projectionstringrequired

    Possible values: [support, detail]

    outcomestringrequired

    Possible values: [succeeded, rejected, technical_error, not_observed, unknown]

    outcome_basisstringrequired

    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]

    progressstringrequired

    Possible values: [none, technical_error, pre_credential_rejected, primary_rejected, primary_succeeded, second_factor_completed, primary_failure_latched, authorization_code_issued, tokens_issued]

    final_outcome_observedbooleanrequired
    SupportHistoryAttempt
    {
    "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
    }