Authentication overview

Project Authentication is an application-user identity layer. Each project receives its own publishable key, users, identities, sessions, signing key, redirect policy, email delivery, and OAuth Apps.

#Project identity boundary

#Email quickstart

1. 1
   Configure URLs

   Set the site URL and every exact redirect URL the project may use.

2. 2
   Configure email

   Add a Resend sending key, verified From address, and the three required HTML templates.

3. 3
   Copy the publishable key

   The dashboard Authentication section displays the project key used by public endpoints.

4. 4
   Create a user session

   Create the SDK client once, then sign up or sign in throughhalo.auth. The SDK persists the browser session and rotates refresh tokens automatically.

import { createClient } from "agihalo-node-sdk/auth";

const halo = createClient(
  "https://api.agihalo.com",
  HALO_PROJECT_PUBLISHABLE_KEY
);

const { data, error } = await halo.auth.signInWithPassword({
  email: "user@example.com",
  password: "use-a-strong-password",
});

if (error) throw error;

// The SDK automatically sends apikey + Bearer <access_token>.
const { data: currentUser } = await halo.auth.getUser();

#Public API

#Choose the next guide