Skip to content
NEMAR NEMAR NEMAR

Authentication

NEMAR uses API key authentication with an admin approval workflow.

Workflow Overview

Section titled “Workflow Overview”
  1. Sign up - Create an account with your details
  2. Verify email - Click the link in the verification email
  3. Wait for approval - Admin reviews your request
  4. Retrieve API key - Use nemar auth retrieve-key with your email and password
  5. Log in - Use your API key to authenticate

Creating an Account

Section titled “Creating an Account”
Terminal window
nemar auth signup

You’ll be prompted for:

FieldDescription
Username3-30 characters, alphanumeric with - and _
EmailValid email for verification
PasswordMinimum 12 characters
GitHub UsernameRequired for PR collaboration
ORCID iDOptional, used for DOI creator metadata
DescriptionWhy you need NEMAR access (min 20 chars)

Logging In

Section titled “Logging In”

Interactive

Section titled “Interactive”
Terminal window
nemar auth login

With API Key

Section titled “With API Key”
Terminal window
nemar auth login -k nemar_your_api_key_here

Environment Variable

Section titled “Environment Variable”
Terminal window
export NEMAR_API_KEY=nemar_your_api_key_here
nemar auth login

Check Status

Section titled “Check Status”
Terminal window
# View cached credentials
nemar auth status


# Refresh from server
nemar auth status --refresh

Log Out

Section titled “Log Out”
Terminal window
# Remove the active account
nemar auth logout


# Remove all stored accounts
nemar auth logout --all

Switch Accounts

Section titled “Switch Accounts”

If you have multiple NEMAR accounts:

Terminal window
# Interactive account picker
nemar auth switch


# Switch to a specific account
nemar auth switch <username>

Resend Verification Email

Section titled “Resend Verification Email”

If you didn’t receive the verification email:

Terminal window
nemar auth resend-verification

Security Notes

Section titled “Security Notes”

Your API key is linked to:

  • Your GitHub Personal Access Token (for repository operations)
  • Your S3 credentials (for data upload/download)

If you suspect your key is compromised, regenerate it immediately:

Terminal window
nemar auth regenerate-key

This sends a verification email and revokes the old key upon confirmation.