Skip to main content

Adding a Domain

Adding a new authentication domain is the first step in setting up Authava for your application. This guide will walk you through the process of adding and configuring a domain.

Overview

The domain setup process consists of three main steps:

  1. Domain Setup: Choose and validate your authentication domain
  2. Domain Verification: Verify domain ownership by adding DNS records
  3. Email Configuration: Set up email delivery for authentication emails

Step 1: Domain Setup

  1. From your Authava dashboard, click the Add Domain button in the domains section.

    Add Domain Button

  2. Enter your authentication domain in the input field. We recommend using a subdomain specifically for authentication:

    • auth.yourdomain.com
    • login.yourdomain.com
    • id.yourdomain.com
    Best Practice

    Using a dedicated subdomain for authentication helps separate your auth service from your main application, making it easier to manage and secure.

  3. Click Continue to validate the domain.

Authava will check if the domain is available and valid. If successful, you'll proceed to the domain verification step.

Step 2: Domain Verification

After entering a valid domain, you'll need to verify ownership by adding a CNAME record to your DNS settings.

  1. Add the following CNAME record to your domain's DNS settings:

    TypeNameValue
    CNAMEyour-domain.comauth.authava.com
    note

    Replace your-domain.com with the domain you entered in the previous step.

  2. Click Verify Domain to check if the DNS record has been properly configured.

    caution

    DNS changes can take up to 48 hours to propagate globally, although they often take effect much sooner. If verification fails, wait a few minutes and try again.

Once your domain is verified, you'll proceed to the email configuration step.

Step 3: Email Configuration

Authava offers two options for sending authentication emails:

Option 1: Use Authava Email Provider

The simplest option is to use Authava's managed email service:

  1. Select Use Authava Email from the options.

  2. Authava will automatically configure the necessary DNS records for email delivery.

  3. Add the following DNS records to your domain:

    TypeNameValue
    TXTyour-domain.comv=spf1 include:_spf.authava.com ~all
    TXTdkim._domainkey.your-domain.comv=DKIM1; k=rsa; p=MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQC...
    MXyour-domain.com10 mail.authava.com
  4. Click Verify DNS Records to confirm the setup.

Option 2: Use Custom SMTP

If you prefer to use your own email provider:

  1. Select Use Custom SMTP from the options.

  2. Enter your SMTP server details:

    • Host: Your SMTP server hostname (e.g., smtp.gmail.com)
    • Port: The SMTP port (typically 587 for TLS or 465 for SSL)
    • Username: Your SMTP username
    • Password: Your SMTP password
    • Encryption: Choose between None, TLS, or SSL
  3. Click Verify SMTP Settings to test the connection.

  4. Once verified, click Continue to complete the setup.

Completion

After completing all three steps, your authentication domain is ready to use! You'll be redirected to your dashboard where you'll see your new domain card.

Domain Card

From here, you can:

  1. Click View Details to access user management and API keys
  2. Click Settings to configure branding, origins, email, and social login
  3. Monitor key metrics directly on the domain card

Managing Your Domain

Accessing Domain Details

To manage users and API keys for your domain:

  1. Find your domain card on the dashboard
  2. Click the View Details button
  3. Use the user management interface to add, edit, or remove users
  4. Manage API keys for programmatic access

Configuring Domain Settings

To customize your domain's appearance and behavior:

  1. Find your domain card on the dashboard
  2. Click the Settings button
  3. Use the tabs to navigate between different settings:
    • General: Branding and appearance
    • Origins: Allowed origins for CORS and redirects
    • Email: Email delivery configuration
    • Social: Social login provider setup

Next Steps

Now that your domain is set up, you can:

Troubleshooting

If you encounter issues during the domain setup process:

  • Domain validation fails: Ensure you've entered a valid domain name without protocols (http:// or https://).
  • Domain verification fails: Check that your DNS records are correctly configured and wait for DNS propagation.
  • Email verification fails: Verify your SMTP settings or DNS records for Authava Email.

For more help, contact support at [email protected].