Schalk NeethlingMany SaaS founders building services for the business-to-business (B2B) industry will quickly encounter the need to offer single sign-on as part of their SaaS offerings or risk losing out on lucrative enterprise sales. While there are quite a few providers in this space, there are very few with the flexibility and ease of adoption of BoxyHQ's SAML Jackson.
Two of the core strengths of any open-source project are the quality of its documentation and a helpful and supportive community. You will be delighted to learn that BoxyHQ has got you covered on both of these fronts. From the clearly written README that gets SAML Jackson running locally in no time, to detailed guides demonstrating how to integrate SAML Jackson into your application, and a supportive community, you are in good hands.
Did you know? Most enterprises rely on SAML-based single sign-on (SSO). But what is SAML? Learn more in this post.
The Guides
In the JavaScript ecosystem, there are guides for enabling SAML-based enterprise single sign-on in AdonisJS, Express.js, Next.js, Remix, and React with an Express.js backend.
- SAML Jackson AdonisJS guide
- SAML Jackson Express.js guide
- SAML Jackson Next.js guide
- SAML Jackson React guide
- SAML Jackson Remix guide
Each guide follows a similar outline with some additional steps detailed where needed.
Configure SAML Single Sign-On
This section features two guides that help you understand everything you need to know about configuring SAML single sign-on. The first guide assists you in configuring SAML SSO and the second covers the SSO Connection API.
Authenticate with SAML Single Sign-On
The authentication portion of the guides follows a similar seven-step process, with some of the guides requiring additional steps.
- Install SAML Jackson
- Setup SAML Jackson
- Make an Authentication Request
- Receives SAML Response
- Request Access Token
- Fetch User Profile
- Authenticate User
Some guides require you to run SAML Jackson as a service. In these cases, you can either:
- Run it locally by following the setup guide in the project README
- Deploy an instance using Vercel
- Deploy an instance using Heroku
Question: What other deployment targets would you like to see? Let us know in the comments.
For some people, there is nothing like "view source". If this is you, you will be happy to know that for each of these frameworks there exists a sample implementation (jackson-examples repo):
- AdonisJS
- ExpressJS
- For Next.js there is this sample application, and you can also look at the BoxyHQ Enterprise SaaS starter kit for a complete implementation example.
- For React there is an example application and an example of the backend Express API referenced in the guide.
- The Remix guide is one of the guides that is quite different and has it's own repo containing an example implementation.
Question: Is your chosen framework missing from the list? Let us know in the comments which frameworks we should cover next.
Using Laravel or Ruby on Rails? We have not forgotten about you. As with the JavaScript frameworks above, we have you covered with guides and sample implementations.
Question: As with the JavaScript frameworks, let us know in the comments which frameworks we should cover next.
With these guides, sample applications, and the supportive community there is no need to put off adding single sign-on to your SaaS application today.
NOTE: Because everything mentioned here is open-source we welcome your contributions to make what we have today even better.
Stop by BoxyHQ's home on GitHub and share some love and appreciation by adding a star to the powerhouse behind this, SAML Jackson.
