Introduction to SyAuth
SyAuth is a complete authentication and identity management platform designed for developers who want full control over their authentication infrastructure.
Why SyAuth?
| Feature | Description |
|---|---|
| Full Control | Own your authentication infrastructure. Your users, your data, your rules. |
| Developer-First | Built by developers, for developers. Clean APIs, comprehensive SDKs, detailed docs. |
| Standards-Based | OAuth 2.0 and OpenID Connect compliant. Industry-standard security protocols. |
| Flexible Integration | Works with your existing infrastructure. Connect custom databases or use built-in storage. |
Core Features
| Feature | Description |
|---|---|
| OAuth 2.0 / OIDC | Full OAuth 2.0 Authorization Code flow with PKCE |
| Universal Login | Customizable, branded login and registration pages |
| Social Login | Google, Facebook, GitHub, LinkedIn |
| Custom Databases | Connect your PostgreSQL, MySQL, or MongoDB database for user storage |
| User Management | Complete user lifecycle management |
| Groups | Organize users with group-based permissions |
| API Tokens | Secure API access for your applications |
| Workspaces | Multi-tenant organization with team collaboration |
How It Works
SyAuth supports two primary authentication flows depending on your application's needs:
1. Standard Flow (Universal Login)
The easiest way to integrate SyAuth. Your app redirects users to a hosted, branded login page.
2. Embedded Flow (Direct API)
For maximum control over the UI. You build your own login forms and call the SyAuth API directly.
Authentication Lifecycle
Case A: Using Universal Login (Recommended)
- Redirect: Your app redirects the user to SyAuth's Universal Login page.
- Handle Auth: SyAuth handles authentication (email/password, social, MFA).
- Callback: SyAuth redirects back to your app with an authorization code.
- Exchange: Your app (via SDK or API) exchanges the code for access/ID tokens.
Case B: Using Embedded Login
- Custom UI: You collect user credentials (email/password) in your own application.
- Direct API Call: Your backend (or frontend) calls the SyAuth
https://api.syauth.com/e/v1/login/endpoint. - Token Management: SyAuth returns tokens directly, which your app then manages.
Use Universal Login for the fastest setup and best security. Use Embedded Login only if you need a fully custom white-label experience where the user never leaves your domain.
Quick Start Path
New to SyAuth? Follow these steps in order:
| Step | What You'll Do | Time |
|---|---|---|
| 1. Setup Checklist | Create account, workspace, and get credentials | 5 min |
| 2. Choose a Quickstart | Follow the guide for your framework (below) | 5-10 min |
| 3. Test It | Log in and see it working! | 2 min |
Quickstart Guides
Choose based on your tech stack:
| Framework | Guide | Description |
|---|---|---|
| Next.js | Quickstart → | Full SDK with hooks, automatic token refresh |
| Django | Quickstart → | SDK with Django auth backend integration |
| Vanilla JS | Quickstart → | Plain JavaScript, no framework required |
| Any Language | Quickstart → | Raw HTTP - works with Python, PHP, Go, Java, etc. |
Already Have an Account?
Jump to what you need:
- Key Concepts — Understand Workspaces, OAuth Clients, Users
- API Reference — Complete endpoint documentation
- SDK Reference — Detailed SDK documentation
- Customization (in your Dashboard) — Brand the login experience
- Security — Best practices and compliance
Supported Platforms
Current SDKs
| Platform | Package | Status |
|---|---|---|
| Next.js | @syauth/nextjs | ✅ Full OAuth 2.0 + PKCE support |
| Django | django-syauth | ✅ Full OAuth 2.0 + Django integration |
Works With (via HTTP)
Any language that can make HTTP requests works with SyAuth: Python, JavaScript, Go, Java, Ruby, PHP, C#, Rust, and more.
Coming Soon
- React SPA SDK
- React Native SDK
- Node.js Server SDK
Need Help?
- Troubleshooting — Common issues and solutions
- Email: [email protected]