Lexicon Garden

ai.newnal.illi.device.requestOnboardingCode

Register the device (device id, model) under parent 1's device-app session and issue a one-time onboarding code shown on the device.

Repository @illi-service.newnal.id did:plc:uztm7bi2ce42dez3uu3qafro namespace authority
Details · procedure
Kindprocedure
Authoritydevice.illi.newnal.ai
Indexed
Compare Edit in builder → Fork →

Procedure

procedure · POST

Input

application/json

attestation

string

deviceId

requiredstring
  • maxLength: 64

firmwareVersion

string

Version of the ILLI unit's OS image (the firmware build), reported by the device itself; not verified. Trusted software state comes from the key attestation.

  • maxLength: 32

model

requiredstring
  • maxLength: 64

timezone

string

The device's IANA time zone (Asia/Seoul). device.link copies it to the home, and the home's daily works, upload counts and recommendations follow it. Absent or unknown to the server: Asia/Seoul.

  • maxLength: 64

Output

application/json

code

requiredstring

deviceId

requiredstring

expiresAt

requiredstring · datetime

Errors

DeviceAlreadyLinked

No description in schema.

InvalidAttestation

No description in schema.

DeviceRevoked

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.

  • ai.newnal.illi.service.device

    record

    One ILLI device. The rkey is the device id: the SHA-256 of the unit's UDS-derived public key (the first key of its DICE chain, registered with the Newnal RKP server at manufacture), 64 lowercase hex characters, so the same unit keeps the same id across factory resets; not a manufacturing serial number. The pending onboarding code lives only in the Service Agent Node database.

  • ai.newnal.illi.device.link

    procedure

    The caller enters the device's onboarding code and becomes the root admin: creates the home and the family sphere on the caller's PDN with parent 1 and the caller as first members.

  • ai.newnal.illi.account.getAttestationNonce

    procedure

    Issue a server nonce (5 minutes) that a client binds into its attestation before calling account.requestPDNCreationGrant, account.parent.signIn, account.family.signIn or device.requestOnboardingCode. The nonce is an attestation session: the attestation bound to it may be presented again for the same client kind and subject until it expires; a failed verification ends the session. Devices put it in the Android key-attestation challenge of a key provisioned through Newnal's RKP; family apps pass i