ai.newnal.illi.account.family.signIn

Sign a family member in to ILLI from the native family app without the PDN's OAuth sign-in and consent screen: the app presents the member's scoped familyApp app password (which it keeps) and its platform attestation; the Service Agent Node opens the session, joins the account to the service sphere on first use and returns the family session. Used at first connection and at every re-login. Web clients use the OAuth BFF (/oauth/login) instead.

Details · procedure
Kindprocedure
Authorityfamily.account.illi.newnal.ai
Indexed

Procedure

procedure · POST

Input

application/json

appPassword

requiredstring

attestation

requiredstring

App attestation: production = a Play Integrity token or an App Attest attestation object bound to the nonce from account.getAttestationNonce; PoC = mock:family:<secret>.

did

requiredstring · did

Output

application/json

did

requiredstring · did

expiresAt

string · datetime

handle

requiredstring · handle

token

string

The family session token for native clients; web clients receive it as the illi_session cookie.

Errors

InvalidAppPassword

No description in schema.

WrongScope

No description in schema.

InvalidAttestation

No description in schema.

RateLimitExceeded

No description in schema.

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • Sign a parent account in to ILLI from the device without the PDN's OAuth sign-in and consent screen: the device presents the parent's scoped deviceApp app password (which it keeps) and its attestation; the Service Agent Node opens the delegated session, joins the account to the service sphere on first use and returns the device-app session. Used at first connection and at every re-login.

  • Start a parent's OAuth sign-in on the device through the PDN's own page (BFF), for an existing Newnal ID whose credentials are typed on the PDN page. Device-created accounts, and existing ones whose credentials the device app takes itself, sign in with account.parent.signIn instead. client=native ends with a one-time code on the device app's App Link for account.exchangeCode instead of a cookie.