> This page is for version V3 - Beta (default).
> For other versions, use one of these documentation indexes:
> - V3 - Beta (default): https://docs.authlyx.dev/v3/llms.txt
> - V2 - Legacy: https://docs.authlyx.dev/v2/llms.txt
> - V1 - End of support: https://docs.authlyx.dev/v1/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.authlyx.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.authlyx.dev/_mcp/server.

# Device login without a login form

> Approve a system ID in the dashboard, then let the matching installation sign in.

Device login authenticates a whitelisted device identifier instead of asking the customer to type a license or username and password. You decide which identifier your integration uses, such as a processor ID or motherboard identifier, and add that exact value to the application's Devices page.

## Follow one workstation

You install MyApp on a customer's workstation. The integration reads the motherboard identifier you selected. You create its device record, choose its plan, set its expiry and allow access. The next time MyApp opens, it reads the same identifier and asks AuthlyX to authenticate it.

```mermaid
flowchart TD
    A[Developer chooses motherboard or processor identification] --> B[Read that identifier on the customer's workstation]
    B --> C[Whitelist the exact value in MyApp's Devices page]
    C --> D[Choose the device's plan, expiry and status]
    D --> E[Customer opens MyApp]
    E --> F[MyApp reads the same configured identifier]
    F --> G[SDK obtains a challenge and proves its installation key]
    G --> H[AuthlyX looks for a matching device in this application]
    H --> I{Whitelisted, active and allowed by app policies?}
    I -->|Yes| J[Issue a session tied to that device and installation]
    I -->|No| K[Reject login with a code and message]
    J --> M[MyApp uses the session for protected requests]
    M --> N[Heartbeat checks whether access is still valid]
```

## Match the identifier on both sides

A processor value in the whitelist will not match a motherboard value submitted by the app. Pick one strategy, use the same representation every time and test on the actual hardware you support. Do not randomly generate a new value at every launch.

The current V3 API field is called `sid`; it carries the configured identifier. The name of that field does not turn a Windows SID into a motherboard serial. The current SDK default on Windows reads the Windows account SID. Hardware-based device login therefore needs a supplied identifier through the SDK's configuration. It is not automatic hardware discovery.

Keep exact configuration syntax in the language's SDK reference. Do not use a SID-printing sample when your whitelist contains a processor or motherboard ID.

## Device login and linked devices are different

A standalone device record is the identity used for device login. A linked device under a license or user records a device that used that license or username. Removing a linked device frees or resets that binding under the developer's rules; it does not create a standalone device-login record.

## When hardware changes

A replacement motherboard, a changed operating-system account or a new identifier strategy can produce a different value. Decide how you verify a replacement request and update the approved record. Do not automatically approve every unknown identifier: that removes the purpose of whitelisting.

Hardware identifiers are not passwords or cryptographic proof. Some are missing, duplicated or spoofable, especially on virtual machines. Installation signatures and server-side access checks remain necessary. Device login removes the typing step, not the need to check access.

## Test before shipping

Whitelist a test identifier and confirm login succeeds. Try an unknown identifier and confirm rejection. Pause the device and check that its session stops working. Repeat after restoring it, and test the hardware-replacement process separately.