Asaf Rosentswaig
12/15/2025, 9:00 AMRahul Rijhwani
12/15/2025, 9:14 AM<https://auth.descope.io/><YOUR_PROJECT_ID>. Doc
However, for post-authentication redirects back to your service, you need to configure Approved Callback URLs in your application settings Doc. These are the URLs Descope is allowed to redirect users to after authentication Doc.
The redirect URI must be pre-registered with Descope for security reasons - you cannot use arbitrary redirect URIs via query parameters alone. The URI you use must be on the list of approved URIs, and all components (scheme, subdomain, domain, path, port) must match exactly Doc.Asaf Rosentswaig
12/15/2025, 9:56 AMRahul Rijhwani
12/15/2025, 10:11 AMAsaf Rosentswaig
12/15/2025, 10:50 AM<https://auth.descope.io/><YOUR_PROJECT_ID>?flow=<some_flow>
4. user does all flow and authenticates, redirected back to app with SET_COOKIE header for the DS cookie.
5. user passes auth in my app.
does that sounds reasonable?
my issue is between step 3 and 4 where i fail to redirect the user back to my app.Asaf Rosentswaig
12/15/2025, 10:55 AMRahul Rijhwani
12/15/2025, 11:07 AMRahul Rijhwani
12/15/2025, 11:33 AMAsaf Rosentswaig
12/15/2025, 12:09 PMAsaf Rosentswaig
12/15/2025, 12:14 PMRahul Rijhwani
12/15/2025, 12:15 PMRahul Rijhwani
12/15/2025, 1:10 PM<https://auth.descope.io/><YOUR_PROJECT_ID>?flow=<flow_id> Doc
4. User completes the flow
5. Descope sets the DS cookie and redirects back to your app
Key Configuration:
If your project settings are configured to manage session tokens in cookies, Descope services will automatically set the session token in the DS cookie as a Secure and HttpOnly cookie Doc. This means the session token will be stored in the browser and will be accessible for authentication checks.
You'll need to configure your redirect URI in the Descope console. The redirect URI must be pre-registered and match exactly (including scheme, subdomain, domain, path, and port) Doc.
Available Query Parameters:
When redirecting to the Auth Hosting App, you can use:
⢠`flow`: Specifies which authentication flow to run (e.g., ?flow=login)
⢠`tenant`: For multi-tenancy scenarios (e.g., ?tenant=example_tenant)
⢠`bg`: Changes background color or image
⢠`debug`: Shows detailed flow errors in console
⢠`style`: Runs a specific style for your application
⢠`theme`: Enforces a specific theme
After authentication, Descope will redirect back to your configured callback URL with the DS cookie set, allowing your API to verify the JWT on subsequent requests.Asaf Rosentswaig
12/15/2025, 2:06 PMRahul Rijhwani
12/15/2025, 3:32 PM