Being lightweight, fast, and scalable, Node.js is becoming a widely adopted platform for developing web applications. This project provides an environment to learn how OWASP Top 10 security risks apply to web applications developed using Node.js and how to effectively address them.
test 1 test 2 test 3
OWASP Top 10 for Node.js web applications:
Tutorial Guide explaining how each of the OWASP Top 10 vulnerabilities can manifest in Node.js web apps and how to prevent it.
A Vulnerable Node.js App for Ninjas to exploit, toast, and fix. You may like to set up your own copy of the app to fix and test vulnerabilities. Hint: Look for comments in the source code.
The database comes pre-populated with these user accounts created as part of the seed data -
- Admin Account - u:admin p:Admin_123
- User Accounts (u:user1 p:User1_123), (u:user2 p:User2_123)
- New users can also be added using the sign-up page.
The the quickest way to get running with NodeGoat is to click the button below to deploy it on Heroku.
Even though it is not essential, but recommended that you fork this repository and deploy the forked repo. This would allow you to fix vulnerabilities in your own forked version, and deploy and test it on heroku.
This Heroku instance uses Free ($0/month) node server and MongoLab add-on.
If you do not wish to run NodeGoat on Heroku, please follow these steps to setup and run it locally -
-
Install Node.js - NodeGoat requires Node v8 or above
-
Clone the github repository
git clone https://github.com/OWASP/NodeGoat.git
*go to the directory
cd NodeGoat
- Install node modules
npm install
-
Create Mongo DB: You can create a remote MongoDB instance or use local mongod installation
- A. Using Remote MongoDB
- Create a sandbox mongoDB instance (free) at mLab
- Create a new database.
- Create a user.
- Update the
db
property in fileconfig/env/development.js
to reflect your DB setup. (in format:mongodb://<username>:<password>@<databasename>
)
- OR B.Using local MongoDB
- If using local Mongo DB instance, start mongod.
- Update the
db
property in fileconfig/env/development.js
to reflect your DB setup. (in format:mongodb://localhost:27017/<databasename>
)
- A. Using Remote MongoDB
-
Populate MongoDB with seed data required for the app
- Run the npm-script below to populate the DB with seed data required for the application. Pass the desired environment as argument. If not passed, "development" is the default:
npm run db:seed
- Start server, this starts the NodeGoat application at url http://localhost:4000/
npm start
- Start server with nodemon, this starts the NodeGoat application at url http://localhost:5000/
npm run dev
You need to install docker and docker compose to be able to use this option
The repo includes the Dockerfile and docker-compose.yml necessary to setup the app and the db instance then connect them together.
- Change the db config in
config/env/development.js
to point to the respective Docker container.
db: "mongodb://mongo:27017/nodegoat",
- Build the images:
docker-compose build
- Run the app:
docker-compose up
The default application settings (database url, http port, etc.) can be changed by updating the [config file] (https://github.com/OWASP/NodeGoat/blob/master/config/env/all.js).
Please Follow the contributing guide
This project is bound by a Code of Conduct.
Here are the amazing contributors to the NodeGoat project.
- Thanks to JetBrains for providing licenses to fantastic WebStorm IDE to build this project.
Code licensed under the Apache License v2.0.