Skip to content

🛡 Security Module for Nuxt based on OWASP Top 10 and Helmet

License

Notifications You must be signed in to change notification settings

Qrzy/nuxt-security

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

nuxt-security

nuxt-security

npm version npm downloads Github Actions CI Codecov License

OWASP Top 10 module that adds a few security improvements in form of a customizable server middlewares to your Nuxt application. All middlewares can be modified or disabled if needed. They can also be configured to work only on certain routes. By default all middlewares are configured to work globally.

Features

  • Nuxt 3 ready
  • Same Security headers set as by popular Express.js middleware helmet
  • Hidden 'X-Powered-By' header
  • Request Size Limiter
  • Rate Limiter
  • XSS Validator for both GET and POST requests
  • CORS Handler similar to popular Express.js middleware
  • Allowed HTTP Methods Restricter
  • Basic Auth support
  • TypeScript support

📖  Read the documentation

Preview

Open in StackBlitz

Setup

yarn add nuxt-security # yarn
npm i nuxt-security # npm

Usage

The only thing you need to do to use the module in the default configuration is to register the module in the modules array in nuxt.config.ts:

// nuxt.config.js

{
  modules: [
    "nuxt-security",
  ],
  security: {} // optional
}

The module will configure for you several response headers with the values recommended by Helmet as well as custom middlewares for rate and request limiting, xss validation, and CORS handling. More to come soon!

If you wish to modify them you can do so from the configuration:

// nuxt.config.js

{
  modules: [
    "nuxt-security",
  ],
  security: {
    requestSizeLimiter: {
      value: {
        maxRequestSizeInBytes: 3000000,
        maxUploadFileRequestInBytes: 9000000,
      },
      route: '/upload-file'
    }
  }
}

Or, you can pass options directly

export default defineNuxtConfig({
  modules: [
  [
    'nuxt-security',
    {
      requestSizeLimiter: {
        value: {
          maxRequestSizeInBytes: 3000000,
          maxUploadFileRequestInBytes: 9000000,
        },
        route: '/upload-file'
      }
      // Other options
    }
  ]
  ]
})

For all available configuration options check out the docs

Development

  • Run yarn dev:prepare to generate type stubs.
  • Use yarn dev to start playground in development mode.

License

MIT License

About

🛡 Security Module for Nuxt based on OWASP Top 10 and Helmet

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 98.8%
  • Vue 1.2%