Verification

​

Overview

1. Sends a verification email using your configured SMTP server.
2. Generates a unique verification_token for the user.
3. Grants access to the user after they click the verification link.

​

Prerequisites

• A configured SMTP server is required to send verification emails. You can set this up in the Nile Auth UI under Tenants & Users -> Configuration -> Email templates.
• A web server configured to handle Nile Auth requests and serve html.

​

Implementation

npm install @niledatabase/server @niledatabase/react
@niledatabase/client @niledatabase/nextjs

mkdir -p app/api/\[...nile\]

import { Nile } from '@niledatabase/server';
import { nextJs } from '@niledatabase/nextjs';

export const nile = Nile({ extensions: [nextJs] });

import { nile } from './nile';
export const { POST, GET, DELETE, PUT } = nile.handlers;

import { Nile } from "@niledatabase/server";

export const nile = Nile();

app.use("verification-page", async (req, res, next) => {
  const me = await nile.users.getSelf(req.headers);

  if (!me.emailVerified) {
    return res.redirect("/force-verification");
  }

  next();
});

"use client";
import { User } from "@niledatabase/server";
import { EmailSignInButton } from "@niledatabase/react";

export default function VerifyButton({ me }: { me: User }) {
  return <EmailSignInButton email={me.email} />;
}

"use client";
import { EmailSignIn } from "@niledatabase/react";

export default function EmailLogin() {
  return <EmailSignIn />;
}

​

Verification flow

1. The user inputs their email on the login/signup page.
2. Nile sends an email with a verification token using the configured SMTP settings.
3. The link exchanges the verification_token for an authenticated session.
4. Upon successful verification, the user can access the application.

​

Related Topics

• Email Templates - Customize email verification messages.
• Custom SMTP - Configure your own SMTP server for sending emails.
• User Management - Manage user accounts in Nile Auth.