Developer Documentation
Everything you need to integrate Veasy Open SSO into your application. From quick start guides to advanced customization.
Quick Start
Get up and running with Veasy Open SSO in minutes
1. Install the SDK
Choose your preferred language and install the Veasy SDK:
npm install @veasy/node-sdk
dotnet add package Veasy.AspNetCore
pip install veasy-python
2. Initialize the Client
Configure the Veasy client with your application credentials:
import { VeasyClient } from '@veasy/node-sdk';
const veasy = new VeasyClient({
domain: 'your-domain.veasy.com',
clientId: 'your-client-id',
clientSecret: 'your-client-secret'
});
Documentation
Comprehensive guides and references for all Veasy features
Getting Started
Learn the basics and get your first integration up and running.
Authentication
Implement secure authentication flows and user management.
API Reference
Complete API documentation with examples and responses.
SDKs & Libraries
Platform-specific SDKs and integration libraries.
Customization
Brand and customize the authentication experience.
Deployment
Deploy and manage Veasy in production environments.
Code Examples
Real-world examples to get you started quickly
User Login
// Redirect to login
app.get('/login', (req, res) => {
const authUrl = veasy.getAuthorizationUrl({
redirectUri: 'http://localhost:3000/callback',
scope: 'openid profile email'
});
res.redirect(authUrl);
});
// Handle callback
app.get('/callback', async (req, res) => {
const { code } = req.query;
try {
const tokens = await veasy.exchangeCodeForTokens(code);
const user = await veasy.getUserInfo(tokens.accessToken);
req.session.user = user;
res.redirect('/dashboard');
} catch (error) {
res.redirect('/login?error=auth_failed');
}
});
Protected Routes
// Middleware to protect routes
const requireAuth = async (req, res, next) => {
const token = req.headers.authorization?.split(' ')[1];
if (!token) {
return res.status(401).json({ error: 'No token provided' });
}
try {
const user = await veasy.verifyToken(token);
req.user = user;
next();
} catch (error) {
res.status(401).json({ error: 'Invalid token' });
}
};
// Protected API endpoint
app.get('/api/profile', requireAuth, (req, res) => {
res.json(req.user);
});
Interactive Tools
Test APIs and explore features directly in the browser
API Explorer
Test API endpoints with real data and see responses instantly.
Token Debugger
Decode and validate JWT tokens to understand their structure.
Flow Simulator
Simulate authentication flows to understand the user journey.
Need Help?
Our team is here to help you succeed with Veasy Open SSO