Fast OAuth Microservice

A lightweight, secure OAuth authentication microservice built with Fastify that supports multiple authentication providers and magic links.

Features

• 🔐 Multiple OAuth Providers:
  • Google OAuth 2.0
  • GitHub OAuth
  • Discord OAuth
• ✨ Magic Link Authentication
• ⚡ Built with Fastify for optimal performance
• 🔒 Secure session management
• 🚀 Easy to deploy

Quick Start

Setting up Node Mailer with Gmail for Magic Link

• Navigate to https://myaccount.google.com/
• Sign in to the Google Account associated with the Gmail address you want to use for sending emails programmatically.
• Search for "App Passwords" in Security.
• Enter the App name to generate your password NODEMAILER_PASS.

Google OAuth

• Create your application and follow the instructions https://developers.google.com/identity/protocols/oauth2

Github OAuth

• Read: https://docs.github.com/en/apps/oauth-apps/building-oauth-apps/creating-an-oauth-app

Discord OAuth

• Read: https://discord.com/developers/docs/topics/oauth2

Clone the repository

Navigate into the folder

Development

Environment Variables

API Endpoints

Swagger Support

Try the APIs yourself using swagger http://localhost:3000/docs

OAuth Routes

GET /auth/google           # Google OAuth login
GET /auth/github           # GitHub OAuth login
GET /auth/discord          # Discord OAuth login
GET /auth/google/callback  # Google OAuth login callback
GET /auth/github/callback  # GitHub OAuth login callback
GET /auth/discord/callback # Discord OAuth login callback
POST /magic-link           # Request magic link
GET /magic-link/verify     # Verify magic link
GET /session               # Get current user info
DELETE /session/logout     # Logout user

Magic Link Authentication

1. Request a magic link:

2. Check your email and click the magic link or use the token:

Security Features

• CSRF protection
• Rate limiting
• Secure HTTP-only cookies
• JWT token validation
• XSS protection
• Helmet security headers https://github.com/fastify/fastify-helmet
• Cors https://github.com/fastify/fastify-cors

Docker Support

Deployment

• You can run ./deploy.sh to build and run the docker container.
• Modify this file to deploy to your own hosting provider. e.g., gcp, serverless etc.

License

MIT License - see the LICENSE file for details