Skip to main content

Introduction to Authava

Authava is a modern, multi-tenant authentication platform that helps you add secure authentication to your applications with minimal setup. This documentation will guide you through setting up and using Authava for your projects.

What is Authava?​

Authava provides a complete authentication solution that can be integrated with any application. Key features include:

  • Multi-tenant Authentication: Domain-based tenant isolation with separate user databases
  • Customizable Login Experience: Brand the authentication UI to match your application
  • Multiple Authentication Methods: Email/password, social login, and multi-factor authentication
  • Email Management: Custom email templates and delivery tracking
  • Developer-friendly APIs: RESTful APIs and client libraries for popular frameworks

Architecture Overview​

Authava uses a multi-tenant architecture where each domain gets its own isolated database:

  1. Database Naming

    • Each tenant's database name is derived from their domain
    • Example: auth.example.com → auth-example-com

  2. Tenant Isolation

    • Each tenant's data is completely isolated in its own database
    • Shared infrastructure but isolated data
    • Separate email settings and branding per tenant

  3. Component Overview

    • Frontend applications (site, dashboard, auth UI)
    • Core services (API, authentication service)
    • Background workers (email, usage tracking)
    • Data storage (PostgreSQL, queue system)

Getting Started​

To get started with Authava, follow these steps:

  1. Create an account on the Authava platform
  2. Add a domain for your authentication service
  3. Configure email delivery for authentication emails
  4. Integrate with your application using one of our client libraries

Client Libraries​

Authava provides client libraries for popular frameworks and platforms:

Authentication Flow​

The typical authentication flow in Authava works as follows:

  1. User visits your authentication domain (e.g., auth.yourdomain.com)
  2. Authava initializes a session for the user
  3. User enters credentials or authenticates via a social provider
  4. Authava validates the credentials and creates an authentication token
  5. User is redirected back to your application with the token
  6. Your application verifies the token and grants access

Next Steps​