Custom Domains

Replace id.optare.one with your own domain like auth.yourcompany.com.

Benefits

• Brand consistency - Login URLs match your domain
• Trust - Users stay on your branded experience
• Enterprise - Required for some SSO integrations

Setup

1. Add Domain

1. Go to Settings → Custom Domains
2. Enter your domain (e.g., auth.yourcompany.com)
3. Click Add Domain

2. Configure DNS

Add a CNAME record to your DNS:

3. Verify Domain

Click Verify in the console. Verification typically takes 5-10 minutes.

4. Enable SSL

SSL certificates are automatically provisioned via Let's Encrypt.

Using Custom Domains

Update Your Apps

// Before
const client = new OptareClient({
  domain: 'https://id.optare.one',
});
 
// After
const client = new OptareClient({
  domain: 'https://auth.yourcompany.com',
});

Update OAuth Redirect URIs

Ensure redirect URIs use your custom domain:

https://auth.yourcompany.com/oauth/callback

Wildcard Domains

For multi-tenant scenarios, use wildcard domains:

*.auth.yourcompany.com

Each tenant gets:

acme.auth.yourcompany.com
partner.auth.yourcompany.com

DNS Providers

Cloudflare

1. Go to DNS settings
2. Add CNAME record
3. Set proxy status to DNS only (grey cloud)

AWS Route 53

{
  "Type": "CNAME",
  "Name": "auth.yourcompany.com",
  "Value": "custom.optare.one",
  "TTL": 300
}

GoDaddy / Namecheap

Use DNS management to add CNAME record.

Troubleshooting

Domain Not Verifying

• Check CNAME record is correct
• Wait for DNS propagation (up to 48 hours)
• Ensure no conflicting A records

SSL Certificate Issues

• Verify domain ownership
• Check for CAA records blocking Let's Encrypt
• Contact support if issues persist

Next Steps

• Branding - Customize login page
• Tenant Settings - Authentication settings