Hubot Script for interacting with Fortify on Demand
Add hubot-fod to your hubot packages
npm install --save hubot-fod
Add hubot-fod to your external-scripts.json
Here is a list of available commands shown in the hubot help menu.
|hubot list apps (page <n>)?||Lists applications|
|hubot list (passing|failing)? releases app <id> (page <n>)?||Lists the releases for App <id>|
|hubot list reports app <id>||Lists the last 3 completed reports for App <id>|
|hubot list scans app <id>||Lists the 3 most recent scans for App <id>|
|hubot show issue <id>||Links directly to the given Issue for <id>|
|hubot issues release <id>||Gives the Issue Count breakdown for Release <id>|
Additional verbiage is supported in some cases. If you are interested, you can take a look at the regex for matching the command in the script.
hubot list apps page 1 hubot show issue 48173817 hubot list reports app 45727 hubot issues release 183748908 hubot list passing releases for app 3212 page 2
Hubot requires a Fortify on Demand API Key and Secret to connect.
This is your Fortify on Demand API Key that you can generate from your Settings Page.
This is your Fortify on Demand API Key Secret.
Please be careful with these values in the case where you are automating your bot deployment. Please generate the bot its own key so that it can easily be revoked should mistakes happen.
OPTIONAL This is the URI of the instance of FoD you are interested in interacting with. Defaults to: ams.fortify.com
If you have any ideas for features that would be helpful to you, please feel free to open an issue to discuss it.
If you would like to write a feature, you can refer to the Fortify on Demand API Swagger Page for help with calling the API should the feature require it.
Working on Hubot-FoD
From the project directory, run:
npm install npm run typings npm start
This will install all of the necessary packages, get your typings installed, and start the typescript compiler watching for changes.
If you do not want to run the compiler concurrently, run:
npm run tsc
Should your changes change the file structure and you want to start clean, run:
npm run clean
Installing to a running Hubot Instance
If you are testing your changes with a live hubot, you can install this script from your local workspace.
Make sure to have compiled Hubot-FoD, and then from your Hubot directory:
npm install /path/to/hubot-fod
Then you can restart Hubot and he should be running your local version. Simply run the install again when you want to test your changes.
MIT License - Copyright (c) 2016 Matt Gibbs