From 0360f64bdfde4f9c75a3eb6e8f1f496d1ac6d3c5 Mon Sep 17 00:00:00 2001 From: muzakon Date: Tue, 17 Nov 2026 16:43:46 +0300 Subject: [PATCH] Describe the attest_skipped reasons Each `AttestSkippedReason` member now says when the iOS and Android SDKs send it, taken from the branches in the native SDKs that set each value. Doc comments only; no version change. --- src/fingerly/_enums.py | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/src/fingerly/_enums.py b/src/fingerly/_enums.py index 367708f..8d2f972 100644 --- a/src/fingerly/_enums.py +++ b/src/fingerly/_enums.py @@ -168,6 +168,24 @@ class AttestSkippedReason(_StrEnum): """The app's own reason for sending no attestation, ``Attestation.attest_skipped``. Diagnostic only; it never lowers the score. + + - ``NOT_OFFERED``: the challenge offered no attestation: on iOS the SDK + key has no Apple app ID for App Attest, on Android the app's transport + returned no challenge offer. + - ``UNSUPPORTED``: the device cannot make an attested key: App Attest is + not supported on the iOS device, or Android is older than 7.0 (API 24). + - ``CHALLENGE_UNAVAILABLE``: no usable challenge ticket: the challenge + request failed, or on Android the ticket it returned was malformed. + - ``KEY_ERROR``: the platform key store failed to create, attest or sign + with the key, or on Android the stored key record could not be read. + - ``TIMEOUT``: attestation did not finish in time: a key store call ran + past its budget, or another identification held the attestation step + too long. + - ``BACKOFF``: the server rejected a new key from this install (on iOS, + also when it asked for a replacement), and the SDK is waiting out a + backoff before it registers another. + - ``INSTALL_UNAVAILABLE``: the report has no usable install ID, or on iOS + the stored key record could not be read or saved. """ NOT_OFFERED = "not_offered"