Skip to main content

Auth

User authentication: signup, signin, signout, recovery, and OAuth

📄️ Get current user info

Bearer-authenticated callers and requests without a valid app selector retain the existing User response and canonical account authentication. A genuinely unauthenticated ios_app flow request may receive AppSessionInfo even when new guest starts are disabled. A web_guest request receives AppSessionInfo only while the web guest flag is on; with it off it gets the User response as without a selector. guestSearch.enabled reports new-start capability, not whether bootstrap or already accepted owned-search continuation is allowed. First contact uses the selector alone so the server can persist a canonical session and set its cookie before reporting capability; this does not authorize reading any Search. Session initialization/store failure is not success.

📄️ Prove the genuine iOS app for the current guest session

Verifies an Apple App Attest attestation (new key) or assertion (registered key) over the session's attestChallenge from GET /auth/info and marks the guest session attested; with App Attest on, only an attested ios_app guest session can start a search. Idempotent: an already attested session gets 204 without verification. A refused proof changes nothing. Applies only to an ios_app guest session while App Attest is on; any other caller with a recognised guest selector gets 403 app_attest_failed. A missing or unrecognised guest selector (including web_guest while the web guest flag is off) returns 401; a missing or non-guest session is a 403 app_attest_failed; a malformed or oversized body 400.