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:
- Domain Setup: Choose and validate your authentication domain
- Domain Verification: Verify domain ownership by adding DNS records
- Email Configuration: Set up email delivery for authentication emails
Step 1: Domain Setup
-
From your Authava dashboard, click the Add Domain button in the domains section.
-
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 PracticeUsing a dedicated subdomain for authentication helps separate your auth service from your main application, making it easier to manage and secure.
-
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.
-
Add the following CNAME record to your domain's DNS settings:
Type Name Value CNAME your-domain.com
auth.authava.com
noteReplace
your-domain.com
with the domain you entered in the previous step. -
Click Verify Domain to check if the DNS record has been properly configured.
cautionDNS 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:
-
Select Use Authava Email from the options.
-
Authava will automatically configure the necessary DNS records for email delivery.
-
Add the following DNS records to your domain:
Type Name Value TXT your-domain.com
v=spf1 include:_spf.authava.com ~all
TXT dkim._domainkey.your-domain.com
v=DKIM1; k=rsa; p=MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQC...
MX your-domain.com
10 mail.authava.com
-
Click Verify DNS Records to confirm the setup.
Option 2: Use Custom SMTP
If you prefer to use your own email provider:
-
Select Use Custom SMTP from the options.
-
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
- Host: Your SMTP server hostname (e.g.,
-
Click Verify SMTP Settings to test the connection.
-
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.
From here, you can:
- Click View Details to access user management and API keys
- Click Settings to configure branding, origins, email, and social login
- Monitor key metrics directly on the domain card
Managing Your Domain
Accessing Domain Details
To manage users and API keys for your domain:
- Find your domain card on the dashboard
- Click the View Details button
- Use the user management interface to add, edit, or remove users
- Manage API keys for programmatic access
Configuring Domain Settings
To customize your domain's appearance and behavior:
- Find your domain card on the dashboard
- Click the Settings button
- 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:
- Configure social login providers
- Customize the login page
- Set up multi-factor authentication
- Integrate with your application
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].