README.md

XSS Safeguard

Performance oriented safeguard for all possible XSS attacks

Made with ❤️ by developers for developers

Want to show your love?

Click on 🌟 button.

Table of Contents

• Want to show your love?
• Table of Contents
• Installation
• Features
• Usage
• FAQ
  • Is it supported and tested both on web and mobile?
• Contributing
  • Step 1
  • Step 2
  • Step 3
• Support
• License

Installation

$ yarn add @mohalla-tech/xss-safeguard

OR

$ npm i @mohalla-tech/xss-safeguard --save

Features

• URL sanitization (With express middleware for SSR) 💯
• Query Param Sanitization (Client Side) 💯
• String Sanitization 💯
• Input Sanitization 💯

Usage

Express Middleware for SSR

import express from 'express';
import { secure } from '@mohalla-tech/xss-safeguard';

const app = express();

// Default configuration
app.use(secure());

// Callback on xss attack
app.use(secure({ callback: () => {} }));

// Custom response handler when xss attack happens
app.use(
  secure({
    handleResponseCustom: res => {
      res.redirect('/error');
    },
  })
);

Query Param Sanitization

import { getSafeSearchParam } from '@mohalla-tech/xss-safeguard';

// URL : https://sharechat.com?language=en
const sanitizedString = getSafeSearchParam('language');
console.log(sanitizedString); // en

// URL : https://sharechat.com?language=<script>alert("Hello")</script>
const sanitizedString = getSafeSearchParam('language');
console.log(sanitizedString); // scriptalertHello/script

String Sanitization

import { sanitizeString } from '@mohalla-tech/xss-safeguard';

const sanitizedString = sanitizeString('<script>Hello</script>');
console.log(sanitizedString);

FAQ

Is it supported and tested both on web and mobile?

Yes

Contributing

To get started...

Step 1

• Option 1

  • 🍴 Fork this repo!

• Option 2

  • 👯 Clone this repo to your local machine using https://github.com/ShareChat/xss-safeguard

Step 2

• HACK AWAY! 🔨🔨🔨

Step 3

• 🔃 Create a new pull request using https://github.com/ShareChat/xss-safeguard.

Support

Reach out to one of the following:

• garganurag893@gmail.com
• sumit07sinha@gmail.com
• himandwivedi@gmail.com
• satishshriwasofficial@gmail.com

License

• MIT license