🛡️ Supabase Authメールゲートウェイ
Supabase Authのメールに 送信前ゲートウェイチェックを追加
アドレス形式と受信者ドメインのMXを確認します。tempmail.comを明示的に追加したオフラインMITライセンス静的使い捨てドメインリストとの完全一致・サブドメイン一致、制限対象ドメイン、既存の受信者ドメイン脅威シグネチャとの一致をブロックします。MX照会の失敗とスパムトラップ/評判ヒューリスティックのHIGH警告は通過し、ライブのトラップ照会は行いません。
メール認証 · 月100件の無料リクエスト(検証と送信で共有)· クレジットカード不要
認証メール / 制御された送信
01 / 問題の仕組み
形式が正しいアドレスでも、配信できるとは限りません。
Supabase Authがメール送信を開始します。SentriSendはアドレス形式を検証して受信者ドメインのMXを照会します。MXの不在・不正・一時的な取得失敗は警告のみで通過し、メールボックス確認にはなりません。tempmail.comを明示的に追加したオフラインMITライセンス静的使い捨てドメインリストとの完全一致・サブドメイン一致、制限対象ドメイン、既存の受信者ドメイン脅威シグネチャとの一致をブロックします。スパムトラップ/評判ヒューリスティックのHIGH警告は通過し、ライブのトラップ照会やSMTP受信者プローブは行いません。実際の配信状況はプロバイダーで確認してください。
- 形式を検証し、受信者ドメインのMXを照会します(メールボックス確認ではありません)。
- tempmail.comを明示的に追加したオフライン使い捨てドメインリストとの完全一致・サブドメイン一致、制限対象ドメイン、既存の受信者ドメイン脅威シグネチャとの一致をブロックします。
- スパムトラップ/評判ヒューリスティックのHIGH警告は通過し、ライブのトラップ照会やSMTP受信者プローブは行いません。
02 / 連携
署名を確認し、宛先を検証して、一度だけ送信。
このNext.js送信フックはstandardwebhooksでSupabaseの生データの署名を確認してから、POST /api/v1/validateを呼び出します。AbortSignalで検証の待機時間を制限しますが、応答時間の保証ではありません。検証APIは使い捨てドメイン、存在しないドメイン、MXと使用可能なAレコードがないドメインを区別します。AレコードへのフォールバックはDNS確認のみです。Null MXは拒否し、一時的なDNS障害はDNS_INCONCLUSIVE・MEDIUMで通過します。フックは明示的な検証応答のallowed === falseだけで拒否し、入力エラー、利用枠超過、サーバーエラー、不正なJSON、タイムアウト時はメール送信を継続します。プロバイダーがtoken_hashリンク、tokenコード、または両方を含むメールを送信します。SMTPサーバーやメールボックスの探査は行いません。
standardwebhooksをインストールし、このルートをSupabaseのSend Email Hookに設定してください。SEND_EMAIL_HOOK_SECRET、SENTRISEND_API_KEY、RESEND_API_KEYはサーバー側に設定し、リンク用にNEXT_PUBLIC_SUPABASE_URLとNEXT_PUBLIC_SITE_URLを設定します。送信元を確認済みドメインに変更し、秘密情報にNEXT_PUBLIC_接頭辞を付けないでください。Supabaseの標準レート制限とCloudflare Turnstileを有効にしてください。自動テストではフックのリクエストをシミュレーションしています。この例は、実際のSupabaseプロジェクトでエンドツーエンドの検証を行っていません。// pages/api/auth/supabase-hook.ts
import type { NextApiRequest, NextApiResponse } from "next";
import { Webhook } from "standardwebhooks";
// Preserve the raw body for signature verification.
// App Router equivalent: await req.text().
export const config = { api: { bodyParser: false } };
const EMAIL_REGEX = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
const SUBJECT_MAP: Record<string, string> = {
signup: "Verify your account",
recovery: "Reset your password",
magiclink: "Your magic login link",
reauthentication: "Confirm your identity",
};
const SUPPORTED_TYPES = new Set(Object.keys(SUBJECT_MAP));
export default async function handler(
req: NextApiRequest,
res: NextApiResponse,
) {
if (req.method !== "POST") return res.status(405).end();
// Authenticate Supabase before any validation or email delivery.
let payload: any;
try {
const rawBody = (await getRawBody(req)).toString("utf8");
const secret = (process.env.SEND_EMAIL_HOOK_SECRET || "")
.replace(/^v1,whsec_/, "");
payload = new Webhook(secret).verify(
rawBody, req.headers as Record<string, string>,
);
} catch {
return res.status(401).json({
error: { http_code: 401, message: "Invalid webhook signature" },
});
}
const { user, email_data } = payload;
const email = user?.email;
const token = email_data?.token;
const tokenHash = email_data?.token_hash;
const redirectTo = email_data?.redirect_to
|| process.env.NEXT_PUBLIC_SITE_URL || "";
const type = email_data?.email_action_type || "signup";
if (typeof email !== "string"
|| !EMAIL_REGEX.test(email) || email.length > 254) {
return res.status(400).json({
error: { http_code: 400, message: "Invalid recipient address" },
});
}
if (!SUPPORTED_TYPES.has(type)) {
return res.status(400).json({
error: { http_code: 400, message: "Unsupported auth action type" },
});
}
// Validation only: delivery stays with your upstream provider.
// Enable Supabase native rate limits and Cloudflare Turnstile.
try {
const check = await fetch(
"https://sentrisend.com/api/v1/validate",
{
method: "POST",
signal: AbortSignal.timeout(600),
headers: {
Authorization: `Bearer ${process.env.SENTRISEND_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({ email }),
},
);
// 429, 5xx, malformed JSON, and timeouts fail open.
// Only a validation response can intentionally reject the user.
if (check.ok || check.status === 400) {
const data = await check.json().catch(() => ({}));
if (data.allowed === false) {
return res.status(400).json({
error: {
http_code: 400,
message: "Unsupported or high-risk email address rejected.",
},
});
}
}
if (check.status === 401) {
console.error("[SentriSend] Invalid SENTRISEND_API_KEY");
}
} catch {
console.warn("[SentriSend] Validation unavailable; failing open");
}
try {
const result = await sendEmailViaProvider({
email, token, tokenHash, type, redirectTo,
subject: SUBJECT_MAP[type],
});
if (!result.ok) {
return res.status(502).json({
error: { http_code: 502, message: "Upstream delivery failed" },
});
}
// Supabase expects an empty JSON object on hook success.
return res.status(200).json({});
} catch {
return res.status(500).json({
error: { http_code: 500, message: "Internal delivery failure" },
});
}
}
function escapeHtml(value: string): string {
return value.replace(/[&<>"']/g, (char) => ({
"&": "&", "<": "<", ">": ">",
'"': """, "'": "'",
})[char]!);
}
async function sendEmailViaProvider({
email, token, tokenHash, type, redirectTo, subject,
}: any) {
const supabaseUrl = process.env.NEXT_PUBLIC_SUPABASE_URL || "";
let htmlContent = "";
if (typeof tokenHash === "string" && tokenHash) {
const params = new URLSearchParams({
token: tokenHash, type, redirect_to: redirectTo,
});
const verifyUrl = `${supabaseUrl}/auth/v1/verify?${params}`;
htmlContent += `<p><a href="${escapeHtml(verifyUrl)}">Click here to complete authentication</a></p>`;
}
if (typeof token === "string" && token) {
htmlContent += `<p>Or enter this verification code: <strong>${escapeHtml(token)}</strong></p>`;
}
if (!htmlContent) return { ok: false };
const response = await fetch("https://api.resend.com/emails", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.RESEND_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
from: "Your App <auth@yourdomain.com>",
to: email, subject, html: htmlContent,
}),
});
return { ok: response.ok };
}
async function getRawBody(req: NextApiRequest): Promise<Buffer> {
const chunks: Buffer[] = [];
for await (const chunk of req) {
chunks.push(typeof chunk === "string" ? Buffer.from(chunk) : chunk);
}
return Buffer.concat(chunks);
}03 / 保護を開始
実際に使えるキーです。営業への問い合わせは不要。
メールを認証して、ご自身の認証メールでゲートウェイをお試しください。
無料キー
無料のSentriSend APIキーを発行
メールアドレスごとに無料キーは1つです。+タグはすべてのドメインで同じ扱いになり、Gmail と Googlemail ではドットも同じアドレスとして扱われます。
メールアドレスを確認するとキーが発行されます。クレジットカードは不要です。
利用上限
- 月100件のリクエスト(検証と送信で共有)
- UTCの1日あたり10通まで送信できます
- 無料キーの送信先は、キー所有者本人の確認済みメールアドレスに限られます。