Notion Authorization Provider

Notion OAuth App

Creating an OAuth app

The first step is create and register a Notion Integration to grant to have access to the user's accessible resources like Retrieve the Bot User (Used by Aura Auth), Pages, Comments, Databases, etc. For more detailed information read Get Started Authorization, Notion Integrations and Get Self User.

Registering an Notion OAuth app includes:

• Integration name: The application name showed when the user tries to grant to the app.
• Associated workspace: The workspace that the app belongs to, it can be changed later.
• Company name: The company name showed when the user tries to grant to the app.
• Website: The URL of the website, it can be changed later.
• Tagline: The tagline of the app, it can be changed later.
• Privacy Policy URL: The URL of the privacy policy, it can be changed later.
• Terms of Use URL: The URL of the terms of use, it can be changed later.
• Email: The email of the developer, it can be changed later.
• Authorization URL: The URL which the Notion will redirect, it should end in /auth/callback/notion for local and production environment.
  • Local environment: http://localhost:3000/auth/callback/notion
  • Production environment: production set the URL of the application.

Notion Aura Auth

Installation

install the package using a package manager like npm, pnpm or yarn

npm install @aura-stack/auth

Environment setup

Now, it's time to create and consume the Notion credentials required and used by Aura Auth, it include the client Id and client Secret and write them into a .env file.

Additionally set the secret used by Aura Auth to sign and encrypt the user's session.

# Notion Credentials
AURA_AUTH_NOTION_CLIENT_ID="notion_client_id"
AURA_AUTH_NOTION_CLIENT_SECRET="notion_client_secret"

# Aura Secret
AURA_AUTH_SECRET="32-bytes-secret"

Configure the provider

Set the oauth option of the createAuth instance. You can use the provider name as a string to use default settings, or use the notion factory function to customize the configuration.

Default configuration

import { createAuth } from "@aura-stack/auth"

export const auth = createAuth({
  oauth: ["notion"],
})

export const { handlers } = auth

Custom configuration

import { createAuth } from "@aura-stack/auth"
import { notion } from "@aura-stack/auth/oauth/notion"

export const auth = createAuth({
  oauth: [
    notion({
      scope: "read:user user:email repo",
    }),
  ],
})

export const { handlers } = auth

Get HTTP Handlers

Use the HTTP handlers to consume the authentication logic and flow the Aura Auth library to be integrated into routers and frameworks.

import { handlers } from "@/auth"

export const { GET, POST } = handlers