SAML Jackson: A SAML SSO service designed as an OAuth 2.0 flow. Integrate SAML with just a few lines of code. Demo - https://saml-demo.boxyhq.com
Go to file
dependabot[bot] 016b456b75
Bump @retracedhq/retraced from 0.7.10 to 0.7.11 (#2731)
---
updated-dependencies:
- dependency-name: "@retracedhq/retraced"
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2024-05-22 22:35:08 +01:00
.github turn off sboms 2024-05-21 21:07:28 +01:00
.vscode rename (#2505) 2024-03-29 12:33:59 +00:00
_dev updated mongo (#2230) 2024-01-31 18:14:24 +05:30
components Terminus json model (#2612) 2024-05-13 23:49:44 +01:00
e2e E2E chores (#2692) 2024-05-13 09:40:00 +01:00
ee Rename saml fed and sso tracer (#2693) 2024-05-11 13:35:32 +01:00
internal-ui updated deps not picked up by dependabot (#2724) 2024-05-21 17:49:33 +01:00
kustomize updated deployment 2024-05-12 19:47:24 +01:00
lib Rename saml fed and sso tracer (#2693) 2024-05-11 13:35:32 +01:00
locales/en Rename saml fed and sso tracer (#2693) 2024-05-11 13:35:32 +01:00
npm updated deps not picked up by dependabot (#2724) 2024-05-21 17:49:33 +01:00
pages Terminus json model (#2612) 2024-05-13 23:49:44 +01:00
public Add a new UI for the login screen (#647) 2022-11-03 18:48:32 +00:00
styles Use itemlist component from UI SDK (#2513) 2024-04-04 00:03:34 +05:30
swagger Release 1.25.0 2024-05-21 19:01:13 +01:00
types Pagination fixes (#2347) 2024-03-06 20:14:14 +00:00
.dockerignore Enhancements (#584) 2022-10-11 20:32:18 +05:30
.env.example Cron jobs support (#2430) 2024-03-22 11:49:23 +00:00
.eslintignore Add `@boxyhq/internal-ui` (#2305) 2024-02-27 22:12:39 +00:00
.eslintrc.js Add missing translations (#2089) 2023-12-27 12:21:53 +00:00
.gitignore Add `@boxyhq/internal-ui` (#2305) 2024-02-27 22:12:39 +00:00
.prettierignore Add `@boxyhq/internal-ui` (#2305) 2024-02-27 22:12:39 +00:00
.prettierrc.js cleanup of preLoadedConfig (#2689) 2024-05-09 20:05:25 +01:00
.release-it.json run swagger after bumping version 2024-05-15 23:28:51 +01:00
CODE_OF_CONDUCT.md added code of conduct 2022-09-20 22:38:52 +01:00
CONTRIBUTING.md docs: update README (#2445) 2024-03-19 12:27:42 +00:00
Dockerfile updated node 2024-05-14 16:30:25 +01:00
LICENSE Fix react SDK and license issues (#880) 2023-01-24 22:02:37 +05:30
Procfile Support standalone build in npm start script (#1292) 2023-07-29 02:39:35 +05:30
README.md docs: update README (#2445) 2024-03-19 12:27:42 +00:00
SECURITY.md Added SECURITY.md 2022-02-16 16:05:43 +00:00
app.json Add missing env to one click deploy (#122) 2022-03-18 18:37:44 +00:00
check-locale.js New OIDC fed (#2336) 2024-03-05 16:57:02 +00:00
find-dupe-locale.js updated deployment 2024-03-26 23:54:27 +00:00
i18next.d.ts Bump next-i18next from 12.1.0 to 13.0.2 (#753) 2022-12-20 20:11:27 +00:00
middleware.ts Renaming routes for Identity Federation (#2618) 2024-05-10 11:41:23 +01:00
migrate.sh Feature/typeorm migrations (#141) 2023-10-13 23:29:21 +01:00
next-env.d.ts Next.js service (#53) 2022-01-05 12:09:51 +00:00
next-i18next.config.js feat: add i18n internationalization (#560) 2022-10-08 18:54:43 +01:00
next.config.js Renaming routes for Identity Federation (#2618) 2024-05-10 11:41:23 +01:00
package-lock.json Bump @retracedhq/retraced from 0.7.10 to 0.7.11 (#2731) 2024-05-22 22:35:08 +01:00
package.json Bump @retracedhq/retraced from 0.7.10 to 0.7.11 (#2731) 2024-05-22 22:35:08 +01:00
playwright.config.ts Renaming routes for Identity Federation (#2618) 2024-05-10 11:41:23 +01:00
postbuild.ts Fix build setup for windows (#1548) 2023-09-02 20:27:37 +01:00
postcss.config.js Signing of SBOM reports (#99) 2022-02-22 19:17:32 +00:00
prebuild.ts Fix build setup for windows (#1548) 2023-09-02 20:27:37 +01:00
samljackson480.gif docs: update README (#2445) 2024-03-19 12:27:42 +00:00
skaffold-demo-mocksaml-services.yaml updated skaffold (#2541) 2024-04-08 16:40:28 +01:00
skaffold-demo-mocksaml.yaml updated skaffold (#2541) 2024-04-08 16:40:28 +01:00
skaffold-demo-services.yaml updated skaffold (#2541) 2024-04-08 16:40:28 +01:00
skaffold-demo.yaml updated skaffold (#2541) 2024-04-08 16:40:28 +01:00
skaffold-dynamodb.yaml updated skaffold (#2541) 2024-04-08 16:40:28 +01:00
skaffold-mariadb.yaml updated skaffold (#2541) 2024-04-08 16:40:28 +01:00
skaffold-mongo.yaml updated skaffold (#2541) 2024-04-08 16:40:28 +01:00
skaffold-mssql.yaml updated skaffold (#2541) 2024-04-08 16:40:28 +01:00
skaffold-mysql.yaml updated skaffold (#2541) 2024-04-08 16:40:28 +01:00
skaffold-postgres.yaml updated skaffold (#2541) 2024-04-08 16:40:28 +01:00
skaffold-prod-eu-mocksaml-services.yaml updated skaffold (#2541) 2024-04-08 16:40:28 +01:00
skaffold-prod-eu-mocksaml.yaml updated skaffold (#2541) 2024-04-08 16:40:28 +01:00
skaffold-prod-eu-services.yaml updated skaffold (#2541) 2024-04-08 16:40:28 +01:00
skaffold-prod-eu.yaml updated skaffold (#2541) 2024-04-08 16:40:28 +01:00
tailwind.config.js Add `@boxyhq/internal-ui` (#2305) 2024-02-27 22:12:39 +00:00
tsconfig.json Bump prettier from 3.2.2 to 3.2.3 (#2163) 2024-01-17 10:53:32 +00:00

README.md

SAML Jackson: Open Source Enterprise SSO And Directory Sync

OpenSSF Best Practices Badge NPM downloads badge Docker pull statistics badge Apache 2.0 license badge Open Github issues badge Github stargazers Nodejs version support badge Swagger Validator badge

SAML Jackson bridges or proxies a SAML login flow to OAuth 2.0 or OpenID Connect, abstracting away all the complexities of the SAML protocol. It also supports Directory Sync via the SCIM 2.0 protocol for automatic user and group provisioning/de-provisioning.

We now also support OpenID Connect providers.

A quick demo of the admin portal without sound to show an overview of what to expect. It shows features such as SSO, the ability to set up SSO connections, Setup Links, Directory sync, and more

Directory Sync

SAML Jackson also supports Directory Sync based on the SCIM 2.0 protocol.

Directory sync helps organizations automate the provisioning and de-provisioning of their users. As a result, it streamlines the user lifecycle management process by saving valuable organizational hours, creating a single truth source of the user identity data, and facilitating them to keep the data secure.

For complete documentation, visit boxyhq.com/docs/directory-sync/overview

🌟 Why star this repository?

If you find this project helpful, please consider supporting us by starring the repository and sharing it with others. This helps others find the project, grow the community and ensure the long-term health of the project. 🙏

🚀 Getting Started with SAML Jackson

There are two ways to integrate SAML Jackson into an application. Depending on your use case, you can choose either of them.

  1. As a separate service (Next.js application) This includes an admin portal out of the box for managing SSO and Directory Sync connections.
  2. NPM library as an embedded library in your application.

Try A Demo

Deploying SAML Jackson as a separate service locally

Let's get you to Hello SAML Jackson in no time.

Prerequisites

  • Node.js at version 18.14.2 or higher

It is generally a good idea to install and maintain Node.js versions using a version manager like nvm or nvs on Windows. More information is available here.

Clone the repository

git clone https://github.com/boxyhq/jackson.git
cd jackson

Install dependencies

npm i

Setup environment variables

Create a .env from the existing .env.example file in the root of the project.

cp .env.example .env

Environment variable documentation: Have a look at https://boxyhq.com/docs/jackson/deploy/env-variables for all of the available environment variables.

Database

For the rest of the setup, we will use a PostgreSQL database. The easiest way to get PostgreSQL up and running on macOS is by using Postgres.app. You can download it from https://postgresapp.com/.

For other operating systems and alternative options for MacOS, please see the documentation available on the Prisma website.

Start the development server

Now that we have our database running we can start the development server. But before we do, we need a way to log into the admin portal.

To log in to the admin portal we either need to configure magic links, or enable username and password login. The easiest one, and the one we will use, is to enable username and password login.

In your .env find the NEXTAUTH_ADMIN_CREDENTIALS environment variable. We need to provide an email:password combination that we can then use to log in to the admin portal. For example:

NEXTAUTH_ADMIN_CREDENTIALS=admin@example.com:password

Now we can start the development server:

npm run dev

Open http://localhost:5225 in your browser and you should be redirected to the login screen.

At the login screen, you can now use the username and password you set in the NEXTAUTH_ADMIN_CREDENTIALS environment variable to log in. Click "Sign In" and you should be logged in and see the SSO Connections page with no configured connections. We have reached Hello SAML Jackson!

Documentation

For the full documentation, visit boxyhq.com/docs/jackson/overview

Easy Cloud Deployment

Deploy SAML Jackson to the cloud with a single click using the following providers:

Deploy with Vercel Deploy

Videos

End-to-End (E2E) tests

Create a .env.test.local file and populate the values. To execute the tests run:

npm run test:e2e

About BoxyHQ

BoxyHQ - Security building blocks for developers

BoxyHQ is on a mission to democratize enterprise readiness for developers one building block at a time. We are building a suite of security building blocks that are easy to use and integrate into your applications. Our goal is to make being enterprise-ready accessible to all developers, founders, and those responsible for the security of their internal applications regardless of their security expertise.

Follow us on Twitter/X Connect with us on LinkedIn

Community is core to our mission. We are building a community of developers, security enthusiasts, and founders who are passionate about security and building secure applications. We are building in the open and would love for you to join us on this journey.

Join the community on Discord today.

Join the community on Discord

Security And Observability

Observability

We support first-class observability on the back of OpenTelemetry, refer here for more details.

SBOM Reports (Software Bill Of Materials)

We support SBOM reports, refer here for more details.

Container Signing and Verification

We support container image verification using cosign, refer here for more details.

🛡️ Reporting Security Issues

Responsible Disclosure

Contributing

Thank you for your interest in contributing to SAML Jackson! We are excited to welcome contributions from the community. Please refer to our contributing guidelines for more information.

💫 Support

Reach out to the maintainers at one of the following places:

📌 License

Apache 2.0 License