Mailchimp Authorization Provider
Add Mailchimp authorization provider to Aura Auth to authentication and authorize
Mailchimp
Set up Mailchimp authorization provider to the authentication instance to Aura Auth.
What you'll learn
Through this quick start guide you are going to learn and understand the basics and how to set up Mailchimp provider to Aura Auth.
Mailchimp OAuth App
Creating an OAuth app
The first step is create and register a Mailchimp App to grant to have access to the user's accessible resources like Metadata (Used by Aura Auth), Campaigns, Facebook Ads, etc. For more detailed information read Access Data on Behalf of Other Users with OAuth 2 and Marketing API.
Registering an Mailchimp OAuth app includes:
-
App name: The application name showed when the user tries to grant to the app. -
App description: An optional description of what the consumer does -
Company/organization: name of the responsible of the application. -
App website: link to the creator's website for detailed data related to the creator. -
Homepage URL: The home url of the website -
Redirect URI: The URL which the Mailchimp will redirect, it should end in/auth/callback/Mailchimpfor local and production environment.- Local environment:
http://192.168.241.106:3000/auth/callback/mailchimp - Production environment: production set the URL of the application.
- Local environment:
Mailchimp Aura Auth
Installation
install the package using a package manager like npm, pnpm or yarn
npm install @aura-stack/authEnvironment setup
Now, it's time to create and consume the Mailchimp 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.
# Mailchimp Credentials
AURA_AUTH_MAILCHIMP_CLIENT_ID="mailchimp_client_id"
AURA_AUTH_MAILCHIMP_CLIENT_SECRET="Mmilchimp_client_secret"
# Aura Secret
AURA_AUTH_SECRET="32-bytes-secret"The AURA_AUTH_SECRET will recommended to be random and high antropy key to avoid attackers decifer the secret used by the Aura
Auth application.
Configure the provider
Set the oauth option of the createAuth instance and writing "mailchimp" name.
import { createAuth } from "@aura-stack/auth"
export const auth = createAuth({
oauth: ["mailchimp"],
})
export const { handlers } = authGet 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 } = handlersThe returned handlers include pre-built routes used in OAuth flows (/signIn/:oauth, /callback/:oauth, /session, /signOut
and /csrfToken). You can mount them in Express, Hono, Next.js, or any runtime that supports native Request and Response APIs.