Authentication Issues

Troubleshooting authentication and access issues in BroxiAI

This guide helps you resolve authentication and access-related issues when working with BroxiAI.

API Token Issues

Invalid API Token Errors

Problem: "Unauthorized" or "Invalid API token" errors

Symptoms:

• 401 Unauthorized responses

• "Invalid token" error messages

• API calls being rejected

Solutions:

1. Verify Token Validity

   • Check that your API token is correct

   • Ensure no extra spaces or characters

   • Verify token hasn't expired

   • Copy token directly from the dashboard

2. Check Token Permissions

   • Confirm token has required permissions

   • Verify account access level

   • Check team/workspace access

   • Ensure token scope matches your needs

3. Test Token

   # Test token validity
   curl -H "Authorization: Bearer YOUR_TOKEN" \
        "https://api.broxi.ai/v1/flows"

4. Regenerate Token

   • Go to Account Settings → API Keys

   • Delete old token

   • Generate new token

   • Update all integrations with new token

Token Expiration Issues

Problem: Token suddenly stops working

Solutions:

1. Check Expiration Date

   • Review token settings in dashboard

   • Set up expiration alerts

   • Plan token rotation

2. Implement Token Refresh

   import os
   from datetime import datetime
   
   def check_token_validity():
       # Check if token is about to expire
       # Refresh token if needed
       pass

Login Issues

Cannot Access BroxiAI Platform

Problem: Cannot log into BroxiAI dashboard or platform

Solutions:

1. Password Issues

   • Use "Forgot Password" link

   • Check email for reset instructions

   • Ensure new password meets requirements:

     • Minimum 8 characters

     • Mix of uppercase, lowercase, numbers

     • Special characters recommended

2. Browser Issues

   • Clear browser cache and cookies

   • Disable browser extensions temporarily

   • Try incognito/private browsing mode

   • Use a different browser (Chrome, Firefox, Safari)

   • Ensure JavaScript is enabled

3. Account Status Issues

   • Check if account is suspended

   • Verify email confirmation (check spam folder)

   • Ensure account is not locked

   • Contact support if needed

4. Network Issues

   • Check internet connection

   • Try different network (mobile hotspot)

   • Check firewall/proxy settings

   • Verify broxi.ai is not blocked

Two-Factor Authentication (2FA) Issues

Problem: 2FA code not working or not received

Solutions:

1. Time Synchronization

   • Ensure device time is correct

   • Sync authenticator app time

   • Account for time zone differences

2. Backup Codes

   • Use backup codes if available

   • Generate new backup codes

   • Store codes securely

3. Reset 2FA

   • Contact support to reset 2FA

   • Verify identity through alternative means

   • Set up 2FA again after reset

Team and Workspace Access

Cannot Access Team Workspace

Problem: Cannot see or access team workspace

Solutions:

1. Check Team Membership

   • Verify you're invited to the team

   • Check email for team invitation

   • Accept pending invitations

2. Permission Levels

   • Confirm your role in the team

   • Check workspace permissions

   • Request elevated access if needed

3. Workspace Switching

   • Use workspace selector in dashboard

   • Ensure you're in the correct workspace

   • Refresh the page

Insufficient Permissions

Problem: "Access denied" or "Insufficient permissions" errors

Solutions:

1. Check Role Permissions

   {
     "roles": {
       "viewer": ["read"],
       "editor": ["read", "write"],
       "admin": ["read", "write", "manage"]
     }
   }

2. Request Access

   • Contact team administrator

   • Request specific permissions

   • Provide business justification

3. Verify Workspace

   • Ensure you're in correct workspace

   • Check if resource exists in your workspace

   • Verify resource ownership

Single Sign-On (SSO) Issues

SSO Login Failures

Problem: Cannot login using SSO provider

Solutions:

1. Provider Configuration

   • Verify SSO provider is configured

   • Check redirect URLs

   • Confirm SAML/OAuth settings

2. User Provisioning

   • Ensure user exists in SSO provider

   • Check group memberships

   • Verify attribute mappings

3. Session Issues

   • Clear SSO provider session

   • Try direct provider login first

   • Check for session conflicts

API Authentication

Bearer Token Issues

Problem: API authentication failing with valid token

Solutions:

1. Header Format

   # Correct format
   Authorization: Bearer your_token_here
   
   # Common mistakes to avoid
   Authorization: your_token_here        # Missing "Bearer"
   Authorization: Bearer: your_token     # Extra colon
   Authorization: Bearer  your_token     # Extra space

2. Request Debugging

   # Debug API request
   curl -v -H "Authorization: Bearer $TOKEN" \
        "https://api.broxi.ai/v1/user"

3. Content-Type Headers

   # Include proper content type
   curl -X POST \
        -H "Authorization: Bearer $TOKEN" \
        -H "Content-Type: application/json" \
        -d '{"key": "value"}' \
        "https://api.broxi.ai/v1/endpoint"

Cross-Origin Issues

Problem: Authentication failing in browser applications

Solutions:

1. CORS Configuration

   • Add your domain to allowed origins

   • Configure CORS headers properly

   • Use server-side proxy if needed

2. Browser Security

   • Avoid storing tokens in localStorage

   • Use secure HTTP-only cookies

   • Implement proper token handling

Error Codes Reference

Authentication-Related Error Codes

Code	Error	Description	Solution
401	Unauthorized	Invalid or missing token	Check token validity
403	Forbidden	Insufficient permissions	Verify account access
422	Invalid Token Format	Malformed token	Check token format
429	Too Many Login Attempts	Rate limited	Wait before retrying

Common Error Messages

"Invalid API key"

• Token is incorrect or malformed

• Token has been revoked

• Wrong token for environment

"Token expired"

• Token has passed expiration date

• Need to refresh or regenerate token

"Insufficient scope"

• Token doesn't have required permissions

• Need to regenerate with proper scope

Getting Help

If you continue to experience authentication issues:

1. Check Status Page: status.broxi.ai

2. Contact Support: [e-mail]

3. Include:

   • Account email

   • Error messages

   • Steps to reproduce

   • Browser/environment details

---

For security reasons, never share your actual API tokens when requesting support. Use example tokens or redacted versions.