Add Session Helper Function

Set up a session helper function to assist in retrieving user sessions.

Create a session helper function to easily read and validate user session data across your API routes.

Configure Session Options

First, you'll need to configure a SessionOptions object in your src/wristband.ts file. The SessionOptions object allows you to control how the session cookie is created and managed. As part of the configuration, you'll need to provide a secret at least 32 characters long. This secret will be used to encrypt the session data stored within the cookie. You can generate a secure secret key at https://securepassword.dev.

  1. Open your configuration: Locate your src/wristband.ts file.
  2. Add SessionOptions: Define the SessionOptions object to manage cookie behavior.
  3. Provide a secret: Include an encryption secret of at least 32 characters. You can safely generate a secure key at securepassword.dev.

Disabling Secure Session Cookies in Local Development

By default, session cookies are marked as secure, meaning they require an HTTPS connection. While most browsers make an exception for localhost over HTTP, Safari enforces stricter rules and blocks secure cookies on localhost without HTTPS.

To bypass this during local development, set secure: false in your session options. Always ensure secure: true is restored before deploying to production to keep session data protected.

// src/wristband.ts

import { createWristbandAuth, SessionOptions } from '@wristband/nextjs-auth';

export const wristbandAuth = createWristbandAuth({
  clientId: '<WRISTBAND_CLIENT_ID>',
  clientSecret: '<WRISTBAND_CLIENT_SECRET>',
  wristbandApplicationVanityDomain: '<WRISTBAND_APPLICATION_VANITY_DOMAIN>',
});

/* NEW: Configure session options for encrypted, cookie-based sessions. */
const sessionOptions: SessionOptions = {
  secrets: '<your-generated-secret>'
};
// src/wristband.ts

import { createWristbandAuth, SessionOptions } from '@wristband/nextjs-auth';

export const wristbandAuth = createWristbandAuth({
  clientId: '<WRISTBAND_CLIENT_ID>',
  clientSecret: '<WRISTBAND_CLIENT_SECRET>',
  wristbandApplicationVanityDomain: '<WRISTBAND_APPLICATION_VANITY_DOMAIN>',
});

/* NEW: Configure session options for encrypted, cookie-based sessions. */
const sessionOptions: SessionOptions = {
  secrets: '<your-generated-secret>',
  secure: false,
};

Create Get Session Helper Function

Next, create a getRequestSession() helper function in src/wristband.ts as shown below. This function can be used to access user session data in your App Router API route handlers.

Next, add the getRequestSession() helper function to your src/wristband.ts file to easily access user session data inside your Next.js App Router API route handlers.

// src/wristband.ts

import { NextRequest } from 'next/server';
import { createWristbandAuth, getSessionFromRequest, SessionOptions } from '@wristband/nextjs-auth';

export const wristbandAuth = createWristbandAuth({
  clientId: '<WRISTBAND_CLIENT_ID>',
  clientSecret: '<WRISTBAND_CLIENT_SECRET>',
  wristbandApplicationVanityDomain: '<WRISTBAND_APPLICATION_VANITY_DOMAIN>',
});

const sessionOptions: SessionOptions = {
  secrets: '<your-generated-secret>'
};

// NEW: Helper function that can be used to retrieve user session 
// data in API route handlers.
export function getRequestSession(request: NextRequest) {
  return getSessionFromRequest(request, sessionOptions);
}

What’s Next

Next, you'll use the Wristband SDK to create the necessary authentication endpoints in your Next.js server.

Did this page help you?