buildbro / authgear-example-nextjs

Add authentication for Next.js app using Authgear

Add authentication for Next.js app using Authgear and OpenID Connect

This repo demonstrates how to integrate Authgear with Next.js App, and NextAuth.js client library is used for sending authentication requests as an OpenID Connect middleware from the app to Authgear.

What is Authgear?

Authgear acts as an IAM provider that is a gatekeeper to the resources you provide to customers as web and mobile applications, APIs, etc. The gatekeeper initiates authorization as outlined in OAuth 2.0. The addition of the OpenID Connect layer adds authentication to secure your users’ digital identities and your product.

How to run the project

Prerequisites

Before you begin, you'll need the following:

• A free Authgear account. Sign up if you don't have one already.
• Node.js.
• Experience with Next.js framework and application development.

On the Authgear portal, you shall create an OIDC client by:

1. Click Applications, Add Application, choose OIDC Client Application to create the Application.
2. Put http://localhost:3000/api/auth/callback/authgear in Authorized Redirect URIs.

Start by cloning the project into your local machine:

git clone https://github.com/authgear/authgear-example-nextjs.git

Make the project directory your current working directory:

cd authgear-example-nextjs

In the root directory of your project, add the file .env.local with the following environment variables:

AUTHGEAR_ISSUER={your-authgear-app-endpoint, e.g. https://yourname.authgear.cloud}
AUTHGEAR_CLIENT_ID={your-client-id}
AUTHGEAR_CLIENT_SECRET={your-client-secret}

Replace values with your Authgear OIDC Client application settings such as Issuer, ClientId, ClientSecret.

To install project dependencies run:

npm install

Start the HTTP server by running the following command.

npm run dev

Browse to localhost:3000. If the installation went successful, you should see the Login page.