# samlify · [![Build Status](https://travis-ci.org/tngan/samlify.svg?branch=master)](https://travis-ci.org/tngan/samlify) [![npm version](https://img.shields.io/npm/v/samlify.svg?style=flat)](https://www.npmjs.com/package/samlify) [![Coverage Status](https://img.shields.io/coveralls/tngan/samlify/master.svg)](https://coveralls.io/github/tngan/samlify?branch=master)

Node.js API for Single Sign On (SAML 2.0)

### Welcome PRs

Welcome all PRs for maintaining this project, or provide a link to the repositories especially for use cases alongside with different frameworks.

### Description

This module provides high-level API for scalable Single Sign On (SSO) implementation. Developers can easily configure the Service Providers and Identity Providers by importing the corresponding metadata. SAML2.0 provides a standard guide but leaves a lot of options, so we provide a simple interface that's highly configurable.

### Installation
To install the stable version

```bash
$ npm install samlify --save
$ yarn add samlify
```

### Development
This project is now developed using TypeScript 2.0, also support Yarn which is a new package manager.

```bash
$ npm install typescript -g
$ yarn
```

### Integrations
+ [GitLab](https://gitlab.com/)
+ [OneLogin](https://www.onelogin.com/)
+ [Okta](https://www.okta.com/)

### Get Started
```javascript
const saml = require('samlify');
```
See full documentation [here](https://samlify.js.org/)

### Demo

In progress

### Talks

[An introduction to Single Sign On](http://www.slideshare.net/TonyNgan/an-introduction-of-single-sign-on)

### License

[MIT](LICENSE)

### Copyright

Copyright (C) 2016-2017 Tony Ngan, released under the MIT License.