Authentication

Interactive Authentication

Sign In

Authenticate with your Norrix account:

norrix sign-in

Alias:

norrix login

This opens a browser window for authentication via AWS Cognito. After successful login, your session tokens are stored locally.

Sign Out

Clear your local session:

norrix sign-out

Alias:

norrix logout

Check Current User

Verify who you’re logged in as:

norrix whoami

Environment Selection

Norrix supports multiple environments for development and production.

Production (Default)

norrix build ios release

Development

Use the --dev flag or --env dev:

norrix build ios release --dev
norrix build ios release --env dev

The environment affects:

• API endpoints
• Token storage
• Organization selection

API Keys for CI/CD

For non-interactive environments like CI/CD pipelines, use API keys instead of interactive login.

Creating API Keys

1. Go to Dashboard → Settings → API Keys 
2. Click Create API Key
3. Enter a name (e.g., “GitHub Actions”)
4. Select scopes: build, submit, update
5. Optionally set an expiration date
6. Copy the key immediately. It won’t be shown again

Using API Keys

Set as an environment variable:

export NORRIX_API_KEY=nrx_abc123...

Or pass directly (not recommended for security):

NORRIX_API_KEY=nrx_abc123 norrix build ios release

Key Format

API keys follow the format:

nrx_<base64_random_bytes>

Example: nrx_Ks7dF2xWq9...

Key Scopes

Revoking Keys

Keys can be revoked anytime from the dashboard. Revoked keys are immediately invalidated.

Organization Selection

List Organizations

norrix orgs list

Select Default Organization

norrix orgs select

This opens an interactive prompt to choose your default organization.

View Current Organization

norrix orgs current

Per-Command Override

Specify an organization for a single command:

norrix build ios release --org org_abc123

Token Storage

Session tokens are stored locally in:

• macOS/Linux: ~/.norrix/
• Windows: %USERPROFILE%\.norrix\

Tokens are stored separately for each environment (prod/dev).