Device Approval
Authorize CLI and SDK device connections through the browser-based device approval flow.
Overview
When you authenticate via the ArmorIQ CLI or SDK, a device approval flow opens in your browser. This lets you verify and authorize the device connection securely.
Navigate to /auth/device or follow the link provided by the CLI after running armoriq login.
How It Works
- Start CLI Login — Run
armoriq loginin your terminal. The CLI generates a user code and opens your browser. - Verify Code — The Device Approval page displays the user code. Confirm it matches what the CLI shows.
- Select API Key — If you have multiple API keys, choose which one to authorize for this device session.
- Approve — Click Approve to complete the authorization.
- Auto-Close — After approval, the page shows a success message and automatically closes after 3 seconds.
States
| State | Description |
|---|---|
| Login Required | You must be signed in to approve a device. The page redirects you to sign in first. |
| Pending Approval | The user code is displayed. Select an API key and click Approve. |
| Success | Device authorized. The page auto-closes after a 3-second countdown. |
Product Branding
The device approval page adapts its branding based on the requesting product:
- ArmorIQ — Default branding
- ArmorClaude — Claude-specific branding
- ArmorClaw — ArmorClaw-specific branding
The device approval flow uses the same authentication session as the web console. If you're already signed in, you'll skip straight to the approval step.