apelcoud-samlify
v0.1.1
Published
High-level API for Single Sign On (SAML 2.0)
Downloads
14
Readme
samlify ·
Highly configuarable Node.js SAML 2.0 library for Single Sign On
Welcome PRs
Welcome all PRs for maintaining this project, or provide a link to the repositories especially for use cases alongside with different frameworks.
Sponsor
| | If you want to quickly implement SAML SSO, feel free to check out Auth0's NodeJS SDK and free plan at auth0.com/developers. | | :----------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
Installation
Multiple schema validators are currently supported by our system, with couple validator modules available and the option to create custom ones. It is essential to utilize the setSchemaValidator function at the outset to avoid errors.
import * as samlify from 'samlify';
import * as validator from '@authenio/samlify-xsd-schema-validator';
// import * as validator from '@authenio/samlify-validate-with-xmllint';
// import * as validator from '@authenio/samlify-node-xmllint';
samlify.setSchemaValidator(validator);
Now you can create your own schema validator and even suppress it but you have to take the risk for accepting malicious response.
samlify.setSchemaValidator({
validate: (response: string) => {
/* implment your own or always returns a resolved promise to skip */
return Promise.resolve('skipped');
}
});
For those using Windows, windows-build-tools
should be installed globally before installing samlify if you are using libxml
validator.
yarn global add windows-build-tools
Development
This project is now developed using TypeScript, also support Yarn which is a new package manager.
yarn global add typescript
yarn
Get Started
const saml = require('samlify');
See full documentation here
Example
react-samlify SP example powered by React, TypeScript and Webpack
Talks
An introduction to Single Sign On
License
Copyright
Copyright (C) 2016-present Tony Ngan, released under the MIT License.