Socket
Socket
Sign inDemoInstall

express-secure-handlebars

Package Overview
Dependencies
191
Maintainers
4
Versions
15
Alerts
File Explorer

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

    express-secure-handlebars

Secure Express/Handlebars with Context Parser


Version published
Weekly downloads
1
Maintainers
4
Install size
7.15 MB
Created
Weekly downloads
 

Readme

Source

Express with Secure Handlebars

We enhance the ExpressHandlebars server-side view engine by automatically applying Context-aware XSS output filters to better secure your web applications.

  • Immediate Benefits: Our approach outperforms the existing HTML escaping by applying precise filtering rules that are specific to different output contexts, and is thus secure against more attack vectors while eliminating double encodings altogether. Kindly refer to xss-filters for details.
  • Least Adoption Effort: The manual effort required is as easy as batch replacing express-handlebars with express-secure-handlebars (i.e., to update those require() calls as well as the dependency in your package.json). The nitty-gritties of filter choices and integrations are all automated!

Quick Start

Installation

$ npm install express-secure-handlebars --save

Usage

Simply replace express-handlebars with the express-secure-handlebars package in all require()!

Basic Example

Based on the basic example of ExpressHandlebars, here we show an example app that can be secured only with our package.

views/profile.handlebars:

Given that there is a very typical handlebars template file written like so to incorporate user inputs. The enhanced package can secure the web application by automatically applying context-sensitive output filters, which otherwise is still subject to XSS attacks if using the default escaping approach (e.g., when url is javascript:alert(1) or onclick=alert(1)).

<h1>Example App: {{title}}</h1>
...
<div>User-provided URL: <a href="{{url}}">{{url}}</a></div>
...

views/layouts/main.handlebars:

Same as the Handlebars original example, this file serves as the HTML page wrapper which can be reused for the different views of the app. {{{body}}} is used as a placeholder for where the main content should be rendered.

<!DOCTYPE html>
<html>
<head><meta charset="utf-8"><title>{{title}}</title></head>
<body>
    {{{body}}}
</body>
</html>

app.js:

A super simple Express app that registers the Handlebars view engine.

var express = require('express'),
//  The only difference is to replace 'express-handlebars' with our enhanced package.
//  exphbs  = require('express-handlebars');
    exphbs  = require('express-secure-handlebars');

var app = express(),
    hbs = exphbs.create({ /* config */ });

app.engine('handlebars', hbs.engine);
app.set('view engine', 'handlebars');

app.use('/profile', function (req, res) {
    res.render('profile', {
        title:  'User Profile',
        url:    req.query.url    // an untrusted user input
    });
});

app.listen(3000);

Development

Apply your changes to files in src/, and then run the tests.

$ npm test

Build

Build Status

License

This software is free to use under the Yahoo Inc. BSD license. See the LICENSE file for license text and copyright information.

Keywords

FAQs

Last updated on 20 Apr 2015

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc