Skip to content

Authentication

Reliafy CLI requires authentication with the Reliafy API to run analyses, design optimizations, and simulations.

Authenticate User

Start the authentication flow to obtain an access token:

python -m reliafy user auth

This command initiates the Auth0 device flow:

  1. A device code and user code will be displayed
  2. You'll be prompted to visit a URL
  3. Enter the user code in your browser
  4. Authorize the application
  5. Return to the CLI - authentication will complete automatically

The access token is stored securely and used for subsequent API requests.

Check Authentication Status

Verify your current authentication status and user ID:

python -m reliafy user id

This displays: - Your authenticated user ID - Whether you're currently authenticated - If not authenticated, prompts you to run python -m reliafy user auth

Authentication Notes

  • Access tokens expire after a set period - you'll need to re-authenticate when they expire
  • The CLI uses Auth0 device flow, which doesn't require storing client secrets
  • Authentication credentials are stored locally and not transmitted except to the Reliafy API
  • No client secret is used in the CLI - only public Auth0 values (domain, client ID, audience)

Troubleshooting

If you encounter authentication issues:

  1. Ensure you have an active internet connection
  2. Check that you can access the Auth0 authorization URL in your browser
  3. Verify your user account has proper permissions
  4. Try re-authenticating: python -m reliafy user auth

For persistent issues, contact support or check the Reliafy API documentation.