SECURITY SPECIFICATION
·
AUTH PROTOCOL
Connect the CLI to your account
Connect your terminal to your Microbix account, sync credits, and store the sign-in token in ~/.aether_auth.
METHOD 01 · 6-DIGIT PIN PAIRING
Step-by-Step PIN Verification
1. Log into your Aether OS account at aether.microbix.in.
2. Navigate to Settings ? Developer & CLI.
3. Click Generate 6-Digit PIN (generates a temporary code that expires after 15 minutes, e.g.
482 910).4. In your terminal, run
aether and select option [1] Enter 6-digit connect PIN.
Endpoint: POST https://auth.microbix.in/api/cli/verify { "code": "482910" }
METHOD 02 · BROWSER MAGIC LINK
Sign in through your browser
Run aether --login to open the device approval page in your browser.
Init Endpoint: POST https://auth.microbix.in/api/cli/auth-link/init
Poll Endpoint: GET https://auth.microbix.in/api/cli/auth-link/poll?session_id=... (3 min timeout)
Poll Endpoint: GET https://auth.microbix.in/api/cli/auth-link/poll?session_id=... (3 min timeout)
METHOD 03 · CREDENTIALS VAULT
Local ~/.aether_auth File Storage
Once paired, the session token is stored on disk in the user's home directory. The CLI enforces POSIX file permission 0600 (read/write only by owner) to prevent unauthorized reads by other local processes.
# ~/.aether_auth (Permissions: 0600)
{
"active_profile": "default",
"profiles": {
"default": {
"user_id": 1042,
"email": "nidhish@microbix.in",
"token": "mbx_tok_9f821a4e2b0c1f4a9d7b",
"tier": "ultra",
"created_at": "2026-09-30T15:28:00Z"
}
}
}