Authentication

OnionAI uses secure, session-based authentication. This page covers sign-in, session handling, and how to keep your workspace secure.

Sign in with GitHub

We use GitHub OAuth for sign-in. When you visit the sign-in page, you’re redirected to GitHub to authorize the app. After approval, we create a session and associate it with your account. We do not store your GitHub password; we only receive and store the information GitHub provides (e.g. name, email, avatar) according to our privacy policy.

Sessions

Sessions are stored in HTTP-only cookies and are validated on each request. Session lifetime and refresh behavior are configured server-side. If you sign out or your session expires, you’ll need to sign in again to access protected routes (e.g. dashboard and chats).

Securing your workspace

  • Use a strong GitHub account: Enable 2FA on GitHub to protect the account used for sign-in.
  • Sign out on shared devices: Use the sign-out option when you’re done on a shared or public machine.
  • Integration credentials: Stored credentials (e.g. API keys for Elasticsearch) are encrypted and scoped to your user. See Security & Compliance for details.

Next steps