Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/descope/auth-hosting
A simple Descope's flows app to be hosted for an easy and simple authentication
https://github.com/descope/auth-hosting
authentication descope hosted oidc openid-connect vercel
Last synced: about 2 months ago
JSON representation
A simple Descope's flows app to be hosted for an easy and simple authentication
- Host: GitHub
- URL: https://github.com/descope/auth-hosting
- Owner: descope
- License: mit
- Created: 2023-06-04T12:07:44.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-10-29T12:22:18.000Z (about 2 months ago)
- Last Synced: 2024-10-29T14:50:01.742Z (about 2 months ago)
- Topics: authentication, descope, hosted, oidc, openid-connect, vercel
- Language: TypeScript
- Homepage: https://auth.descope.io
- Size: 7.33 MB
- Stars: 20
- Watchers: 12
- Forks: 4
- Open Issues: 39
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Descope Authentication Hosting App
This is a React web application that runs Descope's login flows according to the project created in your [Descope](https://app.descope.com) account.
### Deployment
[](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fdescope%2Fauth-hosting&env=DESCOPE_PROJECT_ID&demo-title=Descope%20Hosted%20Auth%20Page&demo-description=https%3A%2F%2Fgithub.com%2Fdescope%2Fauth-hosting%2F%23readme&demo-url=https%3A%2F%2Fauth.descope.io%2F)
By default, the app is deployed to the Descope hosting page in [https://auth.descope.io](https://auth.descope.io).
The main purpose is to allow easy integration for descopers implementing authentication with Descope (such as OIDC [use case](#open-id-connect-oidc-use-cases-in-descope)).
In case you want to have your own hosted page (customize styling, your own domain, etc.), you can use this repository as a template, do the relevant modification and host it (using Vercel, etc.)
---
#### Open ID Connect (OIDC) use cases in Descope
Descope allows you to integrate with your existing Identity Provider (IdP) via OpenID Connect (OIDC) or with any deployed OIDC client.
With this implementation, you can seamlessly add Descope authentication to your application utilizing any OIDC provider.
You can refer to either the [main documentation](https://docs.descope.com/customize/auth/oidc) on how to set it up, or you can review a few of the tutorials published that showcase how to use Descope with many major existing identity providers:
- [Auth0](https://docs.descope.com/knowledgebase/sso/auth0oidc)
- [Cognito](https://docs.descope.com/knowledgebase/sso/cognitooidc)
- [Firebase](https://www.descope.com/blog/post/passkeys-firebase-oidc)
- [Salesforce](https://www.descope.com/blog/post/sso-auth-salesforce)
---
### Running locally
- `yarn install`
- `yarn start`
- Go to `http://localhost:3000/`
**Using URL params**
- Descope's deployment: `https://auth.descope.io/`
- Locally: `http://localhost:3000/?flow=sign-in&debug=true`
These are the different query parameters you can use:
1. `` as part of the URL path is required to use the desired Descope's `PROJECT_ID`.
2. `flow` query parameter is optional. If none provided the default flow is `sign-up-or-in`.
3. `tenant` query parameter is optional. You can input a **Tenant ID** or **Tenant Domain** to use with this query parameter (e.g. `tenant=descope.com` or `tenant=T2UjlUN1tJsRnrV3jnAkJ3WziaEq`).
> If present, then you will be able to authenticate via SSO, without having to first specify an email with an input screen in your flow.
4. `debug` query parameter is optional. If debug mode is needed use `debug=true`.
5. `bg` query parameter is optional. If you wish to use a different background color, you can use this parameter. (ex. `bg=black` or `bg=gray`)
6. `wide` query parameter is optional. If wide mode is nedded use `wide=true`. This will widen the flow component that is rendered, which is used for large forms made with Flow screens.
7. `theme` query parameter is optional. The default value is `light`, but otherwise it will override the theme for your flows rendered with the SDK.
8. `style` query parameter is optional. The default style in your project will be used if not defined, but this allows you to override the `style` for the flows rendered with the SDK.
**Using .env**
In case you don't want to provide the project ID as part of the URL, you can specify it as an environment variable `DESCOPE_PROJECT_ID`.
You can use `.env` file for that.
From the project root directory run: `cp .env.example .env`, and set your Descope Project and flow IDs.