/descope-sso-applications

An application portal that allows your users to login to custom SAML SSO Applications

Primary LanguageTypeScript

Screenshot 2024-03-30 at 7 35 13 PM

Descope SSO Applications 🌐

Descope SSO Applications is designed to simplify the authentication process for employees and other users utilizing Dynamic Federation and IdP-initiated SSO. By acting as a centralized SSO provider, it offers seamless, frictionless sign-in capabilities across multiple SAML SSO-based applications.

Features / Use Cases ✨

  1. Streamlined Access: Provide a unified interface for both internal organization and external users to access SAML applications without any friction, leveraging existing login sessions with other SSO providers. 🔑
  2. Dynamic Federation: Authentication requests can be re-routed to any of the SAML SSO providers you've previously configured, allowing you to add multiple IdPs to applications that may only support one IdP, with Descope in the middle guiding your users through to the right provider. 🔄
  3. Works with Other Auth Providers: With IdP-initiated SSO, you can add Descope as a layer on top of any current implementation you have (with Auth0, Cognito, Firebase, etc.) to provide you and your users with seamless SAML-based SSO to all of your apps, without changing any app-level SAML configurations. 🤝

Getting Started 🚀

Deployment to Vercel 🚀

This application will need to be deployed to Vercel or some other hosting service, in order to work with your application. Since this application requires a backend with your specific Descope Management Key, it's important that you properly deploy this app with secured environment secrets.

Deploy with Vercel

Local Setup Instructions 🛠️

  1. Clone the Repository
git clone https://github.com/descope-sample-apps/descope-sso-applications
cd descope-sso-applications
  1. Install Dependencies
yarn install
  1. Configure Environment Variables

Create a .env.local file at the root of your project and define the following variables:

NEXT_PUBLIC_DESCOPE_PROJECT_ID=YOUR_DESCOPE_PROJECT_ID
DESCOPE_MANAGEMENT_KEY=YOUR_DESCOPE_MANAGEMENT_KEY
NEXT_PUBLIC_DESCOPE_FLOW_ID="sign-up-or-in" // Optional, if you want to use a different flow
  1. Run the Application Locally
yarn dev

Visit http://localhost:3000 in your browser to view the app. 🌐

Contributing 🤝

Contributions are welcome! Please feel free to submit a pull request or open an issue if you have feedback, suggestions, or contributions. ❤️

License 📄

This project is licensed under the MIT License - see the LICENSE file for details. 🔏