Feature 027: SSO Authentication System
Overview
The SSO Authentication System gives you secure, password-free access to Fiftyknots using one-time codes sent to your email. Skip the hassle of remembering passwords - just check your inbox and you’re in. This system protects your venture data while letting you move fast across every tool in the platform.Step-by-Step Guide
-
Navigate to the login page at
/login. You’ll see a clean interface asking for your email address. - Enter your email address in the provided field and click the button to request your one-time code. The system sends a unique code to your inbox immediately.
- Check your email for a message from Fiftyknots containing your one-time password (OTP). This code expires quickly for security.
- Return to the login page and enter the OTP code in the verification field. Click to verify and authenticate.
-
Access your dashboard. The system redirects you to
/authcallbackbriefly, then lands you on your primary workspace - whether that’s your journey dashboard, quick start page, or last visited location. - Switch between tools seamlessly. Once authenticated, move freely between AIStudio, your data rooms, CVP dashboards, and all other platform features without logging in again.
- Manage your active sessions from your profile. View all devices where you’re logged in and terminate any session remotely if needed.
Common Questions
How long does my authentication session last?Your session remains active as long as you’re using the platform. If you close your browser or remain inactive for an extended period, you’ll need to request a new OTP code. You can check your active sessions and their status through the session management endpoint. Can I use SSO if I’m a Sherpa working with multiple founders?
Yes. Sherpas have a dedicated authentication flow through
/sherpa/verify-otp that handles their unique access needs. Your single login grants access to all founder projects you’re assigned to.
What happens if I don’t receive my OTP code?Check your spam folder first. If the code still doesn’t arrive, request a new one - the system generates fresh codes on demand. Each code is valid for a limited time, so use it promptly once received. Can I log in from multiple devices simultaneously?
Absolutely. Your SSO session works across devices. View all your active sessions through the API and manage them individually. This lets you work from your laptop, then switch to mobile without interruption. How does SSO integrate with expert and developer accounts?
Experts and developers use the same SSO system but with role-specific permissions. Once authenticated, the platform grants access to relevant tools - experts see their dashboard and allocations, developers access the IDE and analytics.
Troubleshooting
OTP code not arrivingVerify you entered your email correctly. Check spam and promotional folders. If the issue persists, wait 60 seconds before requesting a new code - rate limiting may delay delivery if you request too many codes rapidly. “Invalid or expired code” error
OTP codes expire quickly for security. Request a fresh code and enter it immediately. Don’t navigate away from the verification page while waiting for your email. Stuck on auth callback page
This usually indicates a temporary network issue or session initialization problem. Clear your browser cache, close all Fiftyknots tabs, and restart the login flow. If the problem continues, try a different browser. Lost access to email account
Contact Fiftyknots support immediately through the support ticket system. Provide proof of identity and project ownership. The support team can verify your identity through alternative methods and update your account email.