Git Product home page Git Product logo

bulwark's Introduction

Bulwark is an organizational asset and vulnerability management tool designed for building and generating application security reports.

Running Bulwark

Note

Please keep in mind, this project is very early in the development phase.

Installing

$ git clone (url)
$ cd bulwark
$ npm install

Run in development mode:

$ npm run start:dev

Run in production mode:

$ npm start

Environment variables

Create a .env file which will be parsed with dotenv.

DB_PASSWORD

DB_PASSWORD="somePassword"

Set this variable to database password

DB_USERNAME

DB_USERNAME="foobar"

Set this variable to database user name

DB_URL

DB_URL=something-foo-bar.dbnet

Set this variable to database URL

DB_PORT

DB_PORT=3306

Set this variable to database port

DB_NAME

DB_NAME="foobar"

Set this variable to database connection name

DB_TYPE

DB_TYPE="mysql"

The application was developed using a MySQL database. See the typeorm documentation for more database options.

NODE_ENV

NODE_ENV=production

Set this variable to determine node environment

DEV_URL="http://localhost:4200"

Only update if a different port is required

PROD_URL="http://localhost:5000"

Only update if a different port is required

JWT_KEY

JWT_KEY="changeMe"

Set this variable to the JWT secret

JWT_REFRESH_KEY

JWT_REFRESH_KEY="changeMe"

Set this variable to the refresh JWT secret

FROM_EMAIL

FROM_EMAIL="[email protected]"

Set this variable to sender email

FROM_EMAIL_PASSWORD

FROM_EMAIL_PASSWORD="somePassword"

Set this variable to sender email password or a Gmail app passwords

COMPANY_NAME

COMPANY_NAME="United Nations Space Command"

Set this variable to the application security company name to be published on the report

Empty .env example

DB_PASSWORD=""
DB_URL=""
DB_USERNAME=""
DB_PORT=3306
DB_NAME=""
DB_TYPE=""
NODE_ENV=""
DEV_URL="http://localhost:4200"
PROD_URL="http://localhost:5000"
JWT_KEY=""
JWT_REFRESH_KEY=""
FROM_EMAIL=""
FROM_EMAIL_PASSWORD=""
COMPANY_NAME=""

Create Initial Database Migration

  1. Create the initial database migration
$ npm run migration:init
  1. Run the initial database migration
$ npm run migration:run

Insert First User

  1. Insert the first user by running the following command with the required arguments. Example:
$ node dist/init/seed-user.js --firstName=John --lastName=OneOneSeven [email protected] --title='Master Chief Petty Officer' --password=blueTeam
  1. Login to Bulwark with the newly created user

Built With

  • Typeorm - The ORM used
  • Angular - The Angular Framework
  • Express - A minimal and flexible Node.js web application framework

Team

The Softrams Bulwark core development team are:

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change. Read the contribution guidelines first.

License

MIT

bulwark's People

Contributors

alejandrosaenz117 avatar darrellrichards avatar dependabot[bot] avatar joshuaseidel avatar skewled avatar waterweasel4 avatar whamo12 avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.