Getting started

Getting a login/sign-up form on your site

SSONext is an open source single sign-on solution. The goal we want to achieve is making it possible to have a user management system ready in seconds.

The result will be a form similar to this one:

The base SSONext login form

  1. Get you code
  2. Integrate on the frontend
  3. (optional) Integrate on the backend

SSONext must be integrated on the frontend and on the backend.

On the frontend: how to integrate the login form on your pages

To integrate the login form on your website/webapp you just need to

  1. embed the following script on the head of your page
<script src=""></script>
  1. use the web component <sn-login> where you want the form to appear:

When the user logins successfully, a JWT token gets saved in localStorage.SSONEXT_TOKEN.

If you want to make an authorized request, then attach the JWT token in the Authorization header as a bearer token.

For example, using fetch, you will:

fetch("/api/some-endpoint", {method: 'GET', headers: {Authorization: "Bearer " + localStorage.SSONEXT_TOKEN}})

On the server side you can check if the user is authorized by using the SSONext APIs or using any JWT libray. See below.

Next steps:

On the backend: how to check if the user is authorized

You can verify a JWT token on the backend using SSONext with the following endpoint by making a GET request:

The response of this request can be an error, or a JSON like this:

valid: true,
payload: {email:string, ...},
expires: "2021-11-21T11:22:22.222Z"

Next steps: