From 628c53f0e22c80313cbb17c16d14793aa7109753 Mon Sep 17 00:00:00 2001 From: muzakon Date: Tue, 17 Nov 2026 16:43:59 +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. --- .../fingerly/server/AttestSkippedReason.java | 35 +++++++++++++++---- 1 file changed, 28 insertions(+), 7 deletions(-) diff --git a/fingerly-server/src/main/java/io/fingerly/server/AttestSkippedReason.java b/fingerly-server/src/main/java/io/fingerly/server/AttestSkippedReason.java index 5dacedb..0a7607d 100644 --- a/fingerly-server/src/main/java/io/fingerly/server/AttestSkippedReason.java +++ b/fingerly-server/src/main/java/io/fingerly/server/AttestSkippedReason.java @@ -10,24 +10,45 @@ public final class AttestSkippedReason { private AttestSkippedReason() {} - /** Attestation was 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. + */ public static final String NOT_OFFERED = "not_offered"; - /** Attestation is not supported on the device. */ + /** + * 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). + */ public static final String UNSUPPORTED = "unsupported"; - /** No attestation challenge was available. */ + /** + * No usable challenge ticket: the challenge request failed, or on Android the ticket + * it returned was malformed. + */ public static final String CHALLENGE_UNAVAILABLE = "challenge_unavailable"; - /** The attestation key failed. */ + /** + * The platform key store failed to create, attest or sign with the key, or on Android + * the stored key record could not be read. + */ public static final String KEY_ERROR = "key_error"; - /** Attestation timed out. */ + /** + * Attestation did not finish in time: a key store call ran past its budget, or another + * identification held the attestation step too long. + */ public static final String TIMEOUT = "timeout"; - /** The SDK was backing off from attestation. */ + /** + * 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. + */ public static final String BACKOFF = "backoff"; - /** The install ID was unavailable. */ + /** + * The report has no usable install ID, or on iOS the stored key record could not be + * read or saved. + */ public static final String INSTALL_UNAVAILABLE = "install_unavailable"; }