# Hypersign Authentication using JavaScript SDK
Hypersign is identity and access management infrastructure that ensures your employess and customers are really who they say they are. By combining biometric with the blockchian, it offers passwordless authentication, authorization, verification and intergrates in minutes.
Hypersign-auth-js-sdk is javascript based SDK to implement passworless authentication with any Nodejs web app. This SDK uses Websocket to communicate with client.
## Watch the demo on Youtube
[](https://www.youtube.com/watch?v=pSCmCZfeQKo&feature=youtu.be "hypersign developer exp")
## The protocol
For more detials about Hypersign protocol, read the [developer documentation](https://vishwas-anand-bhushan.gitbook.io/hypersign/developer/sdk/dev-nodejs) or read our whitepaper at our [website](https://hypersign.id).
## Installation
```
npm i hypersign-auth-js-sdk --save
```
## Intergrate Hypersign Auth with Nodejs Application
To successfully intergrate Hypersign we need to do the following:
1. The app developer intergrates the Hypersign auth sdk with their nodejs backed
2. The app developer implement code to show QR code on the login page
3. Now the user will download [Hypersign Identity Mobile wallet]() and register himself. Upon registration, he will get HypersignAuth Credenital which he can use to login to websites which supports Hypersign login.
### Pre-requisite
You must have `hypersign.json` file in root directory of your project. To generate `hypersign.json` file, please visit our [developer dashboard](https://vishwas-anand-bhushan.gitbook.io/hypersign/developer/developer-dashboard).
### Server Side
Import the package
```js
const HypersignAuth = require('hypersign-auth-js-sdk')
```
Create the server
```js
const app = express()
const server = http.createServer(app)
```
Initialise Hypersign instance
```js
const hypersign = new HypersignAuth(server);
```
Expose `/hs/api/v2/auth` API and and use `hypersign.authenticate` middleware.
```js
// Implement /hs/api/v2/auth API
app.post('/hs/api/v2/auth', hypersign.authenticate.bind(hypersign), (req, res) => {
try {
const user = req.body.hsUserData;
// Do something with the user data.
res.status(200).send({ status: 200, message: "Success", error: null });
} catch (e) {
res.status(500).send({ status: 500, message: null, error: e.message });
}
})
```
Now protect your resources using `hypersign.authorize` middlerware. Take a look at the example;
```js
app.get('/protected', hypersign.authorize.bind(hypersign), (req, res) => {
try {
const user = req.body.userData;
// Do whatever you want to do with it
res.status(200).send("I am protected by secure Hypersign authentication");
} catch (e) {
res.status(500).send(e.message)
}
})
```
Make sure to pass hsAuthorization token in `x-auth-token` header when making the protected resource call.
### Client Side
At first add a div.
```html
```
Then implement Websocket communication code.
```js
```
Get the complete implemetation demo [here](demo/README.md). You can also get detials about the Hypersign protocol from Product hunt or from our [website](https://hypersign.id)
## sdk
### authenticate
```
hypersign.authenticate.bind(server)
```
### refresh
```
hypersign.refresh.bind(server)
```
### logout
```
hypersign.logout.bind(server)
```
### register
```
hypersign.register.bind(server)
```
### issueCredential
```
hypersign.issueCredential.bind(server)
```
### challenge
```
hypersign.challenge.bind(server)
```
### poll
```
hypersign.poll.bind(server)
```