convex-domains

独自のプロバイダーでカスタムドメインを設定する

ユーザー自身のドメイン登録業者で、ドメインが Convex アプリを指すように設定する手順を案内します。接続先（ホスティング先またはデプロイ URL）を特定し、DNS レコードを作成してカスタムドメインを紐付け、アプリで認証を使用している場合は認証オリジンも再設定します。

ワークフロー

1. 接続先を特定します。公開サイトのホスト（*.convex.app の静的ホスティングの場合）またはデプロイの HTTP アクション URL です。
2. ユーザーのプロバイダー用に、すでに認証済みの DNS CLI があるか確認し、レコードを自動作成することを提案します。Cloudflare → flarectl dns create（注：wrangler 自体は DNS レコードを管理しません）、またはトークン環境変数を使った CF API。Route53 → aws route53 change-resource-record-sets。Google Cloud DNS → gcloud dns record-sets create。DigitalOcean → doctl compute domain records create。Vercel DNS → vercel dns add。まず認証状態を読み取り専用で確認します（flarectl user info ／ aws sts get-caller-identity ／ doctl account get）。実行前に正確なコマンドを提示して、ユーザーの承諾を得ます。
3. 認証済み CLI がない場合（またはユーザーが断った場合）は、ユーザー自身のドメイン登録業者で作成するレコードを正確に伝えます。CNAME（または apex での A／ALIAS）と TXT 検証レコードの両方について、プレースホルダーではなく具体的なホスト名と値を示します。
4. ドメインを Convex のカスタムドメインとして紐付けます（ダッシュボードまたは CLI）。検証が完了するまで待ちます。DNS の伝播には数分から数時間かかる場合があることを伝えます。dig +short でレコードが反映されたことを確認します。
5. アプリで認証（パスキー／OAuth）を使用している場合は、認証オリジン（SITE_URL ／ RP_ID ／ ORIGIN 環境変数）を新しいドメインに再設定し、再デプロイ／再公開します。
6. ドメインでアプリが HTTPS 経由で配信されることを確認します。設定されている場合は apex から www へのリダイレクトも確認します。

ルール

• ドメイン登録業者の認証情報を求めたり、扱ったりしてはいけません。ユーザーのマシンで認証済みの CLI を使用することは問題ありません。認証情報はツール内に保持し、CLI をインストールしたり、この作業のためにログイン／認証フローを実行したりしてはいけません。また、トークンを出力してはいけません。
• 稼働中のドメインの DNS 変更はユーザーに影響します。実行前に正確なコマンドを提示して確認を取り、実行後に dig で検証します。
• CNAME だけでなく、必ず TXT 検証レコードも含めます。
• ドメインを再設定すると認証オリジンが変わります。再公開しないとサインインが機能しなくなります。