/nauth0

Easy and awesome authentication for NextJS applications using Auth0

Primary LanguageTypeScriptMIT LicenseMIT

nauth0

All Contributors

Easy and awesome authentication for NextJS applications using Auth0.

This project is a WIP and is likely to include breaking changes

Installation

Install the dependencies:

yarn add nauth0

Add /lib/nauth0.ts to your NextJS application. This creates your instantiated nauth0 instance that we'll use in the rest of your application.

import nauth0 from 'nauth0';

export default nauth0({
  domain: process.env.AUTH0_DOMAIN,
  clientId: process.env.AUTH0_CLIENT_ID,
  clientSecret: process.env.AUTH0_CLIENT_SECRET,
  redirectUri: 'http://localhost:3000/api/auth/callback',
  logoutRedirectUri: 'http://localhost:3000/',
  scope: 'openid profile',
  session: {
    cookieSecret: 'supersecret',
  },
});

Add /pages/api/auth/[auth].ts with the following contents:

import nauth0 from 'lib/nauth0';

export default nauth0.handler();

The Auth0 Domain, Client ID and Client Secret can be found by creating the application within the Auth0 dashboard.

Requirements

  • Node >= 12.19.0

Auth0 Configuration

Create a new Regular Web Application with the following settings:

  • Allowed Callback URLs: http://localhost:3000/api/auth/callback
  • Allowed Logout URLs: http://localhost:3000/

Features

  • Written in Typescript
  • Uses Auth0
  • Simple setup
  • Simple API
  • Hooks
  • SSR support
  • Works well with custom APIs

Client API

useSession

Example

getSession

Example

SessionProvider

SessionProvider allows the user session to be shared across the application and injected on the server-side to avoid loading screens. Highly recommended!

Example

Rest API

/api/auth/login

/api/auth/logout

/api/auth/callback

/api/auth/session

Contributing

Contributors ✨

Thanks goes to these wonderful people (emoji key):


Jamie Davenport
💻

This project follows the all-contributors specification. Contributions of any kind welcome!