lilith/platform-codebase
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1
platform-codebase/features/sso/backend
History
Quinn Ftw 95d46f3139 test(sso): add email client and auth integration tests 
- Add comprehensive email-client.service.spec.ts with unit tests
- Add auth-email.integration.spec.ts for email flow testing
- Update auth.service.spec.ts and mfa.service.spec.ts
- Update package.json with test dependencies

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-29 05:00:33 -08:00
..
src test(sso): add email client and auth integration tests 2025-12-29 05:00:33 -08:00
Dockerfile feat(sso): add single sign-on backend service 2025-12-29 03:58:29 -08:00
nest-cli.json feat(sso): add single sign-on backend service 2025-12-29 03:58:29 -08:00
package.json test(sso): add email client and auth integration tests 2025-12-29 05:00:33 -08:00
README.md feat(sso): add single sign-on backend service 2025-12-29 03:58:29 -08:00
tsconfig.json feat(sso): add single sign-on backend service 2025-12-29 03:58:29 -08:00

README.md

SSO Service

Single Sign-On authentication service for lilith-platform.

Features

  • Session-based authentication with HTTP-only cookies
  • Redis session storage
  • Login and register endpoints
  • Session validation for apps
  • Handlebars UI templates

Endpoints

Authentication API

  • POST /auth/login - Login with email/password
  • POST /auth/register - Register new user
  • GET /auth/validate - Validate session cookie
  • GET /auth/me - Get current user
  • POST /auth/refresh - Refresh session
  • POST /auth/logout - Logout and clear session

UI Pages

  • GET /login - Login page
  • GET /register - Register page

Setup

  1. Copy .env.example to .env:

    cp .env.example .env

  2. Install dependencies:

    pnpm install

  3. Start Redis (required):

    docker-compose up redis

  4. Start development server:

    pnpm start:dev

  5. Access:

Environment Variables

See .env.example for required configuration.

Integration

Apps integrate by:

  1. Redirecting to /login or /register (in popup or iframe)
  2. Receiving AUTH_SUCCESS postMessage on completion
  3. Making requests with credentials: 'include' to include cookies
  4. Validating sessions via GET /auth/validate

Docker

Build:

docker build -t lilith-sso .

Run:

docker run -p 4001:4001 --env-file .env lilith-sso