Skip to content
Mindful Auth Docs (BETA)

Onboarding New Hostname

This guide walks you through the steps to onboard a new hostname in Mindful Auth, enabling authentication services for your custom domain.

  1. Log in to the Mindful Auth admin portal at https://app.mindfulauth.com using your admin credentials and in the dashboard page click on the “Connect New Portal” button.
  2. A form will appear prompting you to enter the following details:

Select Backend

Section titled “Select Backend”

Select the database backend for your portal

  • Tape: Mindful Auth’s no-code backend option. No coding required. Recommended for most use cases.
  • Cloudflare D1: Cloudflare’s native SQL database. Requires custom backend code

Basic Configuration

Section titled “Basic Configuration”
  • Hostname: Enter your portal’s hostname (e.g., portal.example.com). The hostname must be a subdomain. No www, http://, or paths.
  • Login Success Redirect URL: Enter the url path where users should be redirected after a successful login. The url will always have {memberid} at the beggining, for example, /{memberid}/dashboard.

Security Settings

Section titled “Security Settings”
  • Turnstile Site Key: Enter the site key obtained from Cloudflare Turnstile.
  • Turnstile Secret Key: Enter the secret key obtained from Cloudflare Turnstile.
  • Session Duration: Select the desired session duration tier based on your requirements. The available options are:
    • 15 minutes
    • 1 hour
    • 8 hours
    • 12 hours
    • 1 day
    • 2 days
    • 3 days
    • 4 days
    • 5 days
    • 7 days
    • 14 days
    • 21 days
    • 30 days
  • Number of Active Sessions: Select the desired active sessions based on your expected user load.
    • one
    • three
    • five
    • ten
  • Audit Logs Status: Toggle to enable or disable audit logging for the hostname. Audit logs capture important security events and user activities. (BUSINESS PLAN REQUIRED)

Email Webhook

Section titled “Email Webhook”
  • Email Webhook URL: Enter the URL of your email webhook. This single webhook handles all email events (verification, password reset, and magic login) using the event_type field to differentiate between them.

Backend Configuration

Section titled “Backend Configuration”

The backend configuration section will vary based on the backend type you selected.

Tape App

Section titled “Tape App”
  • Tape API Key: Your Tape workspace API key
  • Tape Members App ID: Tape app ID containing user/member records
  • Tape Email Field ID: Field ID for email address in Members app
  • Tape Audit Logs App ID: Tape app ID for audit log records (BUSINESS PLAN REQUIRED)

Cloudflare D1

Section titled “Cloudflare D1”
  • D1 API Token: Cloudflare API token with D1 permissions
  • D1 Account ID: Your Cloudflare account ID
  • D1 Database ID: Your D1 database ID
  • D1 Members Table: Table name for members/users table
  • D1 Email column: Column name for email address in members/users table
  • D1 Audit Logs Table: Table name for audit log records (BUSINESS PLAN REQUIRED)