backstage-plugin-defectdojo

Welcome to the backstage-plugin-defectdojo plugin!

Getting started

#### Overview Page - defectdojo Vulnerability Chart
!defectdojo Chart Example

#### Service Entiry Page - defectdojo Vulnerability Table List
!defectdojo Table Example

The following sections will help you get the defectdojo plugin setup and running

$3

You need to setup the defectdojo backend plugin before you move forward with any of these steps if you haven't already

Installation

This plugin needs to be added to an existing backstage instance.

``bash


From your Backstage root directory


yarn add --cwd packages/app @geislor/backstage-plugin-defectdojo
`

Note: You have 2 Options, you can setup both too

$3

Add defectdojo Vulnerability chart in to Overview page

Import the plugin to packages/app/src/components/catalog/EntityPage.tsx.


$3


`typescript
// ...
import { DefectDojoCard } from '@geislor/backstage-plugin-defectdojo';
// ...
const overviewContent = (

{entityWarningContent}



//...







);
`

$3

Add defectdojo Vulnerability Table List in to Service Entity

Import the plugin to packages/app/src/components/catalog/EntityPage.tsx and add the following.

$3


`typescript
// ...
import { DefectDojoPage } from '@geislor/backstage-plugin-defectdojo';
// ...
const serviceEntityPage = (


{overviewContent}


{cicdContent}

//...



// ...

);
`
Note: If you dont want to display the Service page if no annotation specified in catalog.
`typescript
//...
import { DefectDojoPage, isdefectdojoAvailable } from '@geislor/backstage-plugin-defectdojo';
//...



// ...

`


Configuration

Add the following into your app-config.yaml


$3


`yaml
defectdojo:
host: https://defectdojo.yourcompany.com/api
token: YOUR_API_TOKEN
`

Add the following into your catalog

$3

`yaml
apiVersion: backstage.io/v1alpha1
kind: Component
metadata:
name: backstage
annotations:
defectdojo/project: YOUR_PROJECT_NAME/YOUR_PROJECT_VERSION
``