Osso can be used with SuperTokens as a custom thirdparty provider for SuperToken's login feature. SuperTokens login is only currently only supported in their NodeJS middleware, but the Osso team will ensure compatibility with SuperToken's future modules.
SuperTokens is still pretty new and does not yet perfectly support all of Osso's capabilities. You will be restricted to using Osso's hosted login page if you're using SuperTokens React library for login unless you dive deep into SuperTokens internals and create your own login flow.
Osso provides a sample app with source code or a live example.
#Custom provider setup
To integrate Osso to SuperTokens you need to specify Osso as a custom
ThirdParty provider on at least your back end. If you use the complementary SuperTokens React package on your frontend, you also need to specify Osso in your client-side SuperTokens initialization.
Add Osso to your
supertokens.init function as a
init call here is only showing the
recipeList key for brevity. Review SuperTokens getting started docs if you don't already have this function call in place.
You'll need to set three ENV variables from your Osso instance.
OSSO_BASE_URL is the base url with protocol of your Osso instance, i.e.
https://demo.ossoapp.com, while the
OSSO_CLIENT_SECRET are specific to an OAuth client in your Osso instance. Make sure you add the expected redirect URI to your Osso OAuth Client allow list, i.e.
If you're using SuperTokens React frontend library to manage login and sessions, you need to specify Osso again as a thirdparty provider. This allows SuperTokens to render a button for signing in with SAML SSO, which in turn will send a user to Osso's hosted login page.