@kyverno/backstage-plugin-policy-reporter-backend 2.5.0 → 2.7.0

package/CHANGELOG.md

@@ -1,5 +1,50 @@
 # @kyverno/backstage-plugin-policy-reporter-backend
 
+## 2.7.0
+
+### Minor Changes
+
+- 32f327e: Add cluster-scoped source, kind, category and policy filters.
+- 32f327e: Add support for fetching cluster-scoped policy results.
+- 32f327e: Backstage verion bump to v1.55.3
+
+### Patch Changes
+
+- Updated dependencies [32f327e]
+- Updated dependencies [32f327e]
+- Updated dependencies [32f327e]
+  - @kyverno/backstage-plugin-policy-reporter-common@2.6.0
+
+## 2.6.0
+
+### Minor Changes
+
+- fa25ccc: Added additional responses to all routes, they can now also return 404, 502 and 503
+- 256fb9a: Added source filtering to the PolicyReportsPage. Users can now filter the list of policy reports by selecting one or more sources from the selected cluster.
+- 2f4ac45: Added policy filtering to the PolicyReportsPage. Users can now filter the list of policy reports by selecting one or more policies from the selected cluster.
+- d598ade: Added category filtering to the PolicyReportsPage. Users can now filter the list of policy reports by selecting one or more categories from the selected cluster.
+- a664d0c: Added kind filtering to the PolicyReportsPage. Users can now filter the list of policy reports by selecting one or more kinds from the selected cluster.
+- 880eecc: Backstage version bump to v1.51.1
+- fa25ccc: Add support for configuring requestHeaders for the Policy Reporter Backend in your config using policyReporter.requestHeaders. This can be used for configuring Basic Auth credentials to the backend.
+
+  ```yaml
+  policyReporter:
+    requestHeaders:
+      Authorization: Bearer ${POLICY_REPORTER_API_TOKEN}
+  ```
+
+- 44c5238: Backstage version bump to v1.52.0
+
+### Patch Changes
+
+- Updated dependencies [256fb9a]
+- Updated dependencies [2f4ac45]
+- Updated dependencies [d598ade]
+- Updated dependencies [a664d0c]
+- Updated dependencies [880eecc]
+- Updated dependencies [44c5238]
+  - @kyverno/backstage-plugin-policy-reporter-common@2.5.0
+
 ## 2.5.0
 
 ### Minor Changes

package/config.schema.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "properties": {
+    "policyReporter": {
+      "type": "object",
+      "properties": {
+        "requestHeaders": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "Optional HTTP headers forwarded with every outbound request to every Policy Reporter API Typically used to authenticate through a gateway/proxy.",
+          "visibility": "backend"
+        }
+      }
+    }
+  }
+}

package/dist/index.d.ts

@@ -1,13 +1,199 @@
 import * as _backstage_backend_plugin_api from '@backstage/backend-plugin-api';
-import { LoggerService, RootConfigService, AuthService } from '@backstage/backend-plugin-api';
+import { LoggerService, RootConfigService } from '@backstage/backend-plugin-api';
 import express from 'express';
-import { CatalogService } from '@backstage/plugin-catalog-node';
+
+/**
+ * @public
+ */
+type Direction = 'asc' | 'desc';
+
+/**
+ * @public
+ */
+type Severity = 'unknown' | 'info' | 'low' | 'medium' | 'high' | 'critical';
+
+/**
+ * @public
+ */
+type Status = 'fail' | 'skip' | 'pass' | 'warn' | 'error' | 'summary';
+
+/**
+ * Filter options for policy results
+ * @public
+ */
+interface Filter {
+    /**
+     * Filter by a list of sources
+     */
+    sources?: Array<string>;
+    /**
+     * Filter by a list of namespaces
+     */
+    namespaces?: Array<string>;
+    /**
+     * Filter by a list of kinds
+     */
+    kinds?: Array<string>;
+    /**
+     * Filter by a list of resources
+     */
+    resources?: Array<string>;
+    /**
+     * Filter by a list of categories
+     */
+    categories?: Array<string>;
+    /**
+     * Filter by a list of policies
+     */
+    policies?: Array<string>;
+    /**
+     * Filter by a list of status
+     */
+    status?: Array<Status>;
+    /**
+     * Filter by a list of severities
+     */
+    severities?: Array<Severity>;
+    /**
+     * Filter by search string
+     */
+    search?: string;
+    /**
+     * Filter by label-value pairs
+     */
+    labels?: Array<string>;
+}
+
+/**
+ * @public
+ */
+interface ListResult {
+    /**
+     * Unique identifier for the result
+     */
+    id: string;
+    /**
+     * Kubernetes namespace
+     */
+    namespace: string;
+    /**
+     * Kubernetes resource kind
+     */
+    kind: string;
+    /**
+     * Resource name
+     */
+    name: string;
+    /**
+     * Unique resource identifier
+     */
+    resourceId: string;
+    /**
+     * Policy result message
+     */
+    message: string;
+    /**
+     * Policy name
+     */
+    policy: string;
+    /**
+     * Policy rule name
+     */
+    rule: string;
+    status: Status;
+    severity: Severity;
+    /**
+     * Unix timestamp of the result
+     */
+    timestamp: number;
+    /**
+     * Additional key-value properties
+     */
+    properties: {
+        [key: string]: string;
+    };
+}
+
+/**
+ * Pagination options for results
+ * @public
+ */
+interface Pagination {
+    /**
+     * Requested list page number
+     */
+    page?: number;
+    /**
+     * Number of results per page
+     */
+    offset?: number;
+    /**
+     * Fields to sort by
+     */
+    sortBy?: Array<string>;
+    direction?: Direction;
+}
+
+/**
+ * @public
+ */
+interface ResultList {
+    items: Array<ListResult>;
+    /**
+     * Total number of results
+     */
+    count: number;
+}
+
+interface PolicyReporterApi {
+    getNamespacedResourceResults(options: {
+        entityRef: string;
+        query: Filter & Pagination;
+    }): Promise<ResultList>;
+    getClusterResourceResults(options: {
+        entityRef: string;
+        query: Pick<Filter, 'sources' | 'kinds' | 'categories' | 'policies' | 'status' | 'severities' | 'search' | 'labels'> & Pagination;
+    }): Promise<ResultList>;
+    getNamespaces(options: {
+        entityRef: string;
+        query: Pick<Filter, 'sources' | 'categories' | 'policies'>;
+    }): Promise<string[]>;
+    getSources(options: {
+        entityRef: string;
+    }): Promise<string[]>;
+    getKinds(options: {
+        entityRef: string;
+        query: Pick<Filter, 'sources' | 'kinds'>;
+    }): Promise<string[]>;
+    getCategories(options: {
+        entityRef: string;
+        query: Pick<Filter, 'sources' | 'namespaces'>;
+    }): Promise<string[]>;
+    getPolicies(options: {
+        entityRef: string;
+        query: Pick<Filter, 'sources' | 'namespaces' | 'categories'>;
+    }): Promise<string[]>;
+    getClusterSources(options: {
+        entityRef: string;
+    }): Promise<string[]>;
+    getClusterKinds(options: {
+        entityRef: string;
+        query: Pick<Filter, 'sources' | 'namespaces'>;
+    }): Promise<string[]>;
+    getClusterCategories(options: {
+        entityRef: string;
+        query: Pick<Filter, 'sources'>;
+    }): Promise<string[]>;
+    getClusterPolicies(options: {
+        entityRef: string;
+        query: Pick<Filter, 'sources' | 'categories'>;
+    }): Promise<string[]>;
+}
 
 interface RouterOptions {
     logger: LoggerService;
     config: RootConfigService;
-    catalogService: CatalogService;
-    authService: AuthService;
+    policyReporterService: PolicyReporterApi;
 }
 declare function createRouter(options: RouterOptions): Promise<express.Router>;
 

package/dist/plugin.cjs.js

@@ -3,6 +3,7 @@
 var backendPluginApi = require('@backstage/backend-plugin-api');
 var router = require('./service/router.cjs.js');
 var pluginCatalogNode = require('@backstage/plugin-catalog-node');
+var policyReporterService = require('./service/policyReporterService.cjs.js');
 
 const kyvernoPolicyReportsPlugin = backendPluginApi.createBackendPlugin({
   pluginId: "policy-reporter",
@@ -16,12 +17,17 @@ const kyvernoPolicyReportsPlugin = backendPluginApi.createBackendPlugin({
         authService: backendPluginApi.coreServices.auth
       },
       async init({ httpRouter, logger, config, catalogService, authService }) {
+        const policyReporterService$1 = new policyReporterService.PolicyReporterService({
+          logger,
+          configService: config,
+          catalogService,
+          authService
+        });
         httpRouter.use(
           await router.createRouter({
             logger,
             config,
-            catalogService,
-            authService
+            policyReporterService: policyReporterService$1
           })
         );
       }

package/dist/plugin.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.cjs.js","sources":["../src/plugin.ts"],"sourcesContent":["import {\n  coreServices,\n  createBackendPlugin,\n} from '@backstage/backend-plugin-api';\nimport { createRouter } from './service/router';\nimport { catalogServiceRef } from '@backstage/plugin-catalog-node';\n\n/**\n * kyvernoPolicyReportsPlugin backend plugin\n *\n * @public\n */\nexport const kyvernoPolicyReportsPlugin = createBackendPlugin({\n  pluginId: 'policy-reporter',\n  register(env) {\n    env.registerInit({\n      deps: {\n        httpRouter: coreServices.httpRouter,\n        logger: coreServices.logger,\n        config: coreServices.rootConfig,\n        catalogService: catalogServiceRef,\n        authService: coreServices.auth,\n      },\n      async init({ httpRouter, logger, config, catalogService, authService }) {\n        httpRouter.use(\n          await createRouter({\n            logger,\n            config,\n            catalogService,\n            authService,\n          }),\n        );\n      },\n    });\n  },\n});\n"],"names":["createBackendPlugin","coreServices","catalogServiceRef","createRouter"],"mappings":";;;;;;AAYO,MAAM,6BAA6BA,oCAAA,CAAoB;AAAA,EAC5D,QAAA,EAAU,iBAAA;AAAA,EACV,SAAS,GAAA,EAAK;AACZ,IAAA,GAAA,CAAI,YAAA,CAAa;AAAA,MACf,IAAA,EAAM;AAAA,QACJ,YAAYC,6BAAA,CAAa,UAAA;AAAA,QACzB,QAAQA,6BAAA,CAAa,MAAA;AAAA,QACrB,QAAQA,6BAAA,CAAa,UAAA;AAAA,QACrB,cAAA,EAAgBC,mCAAA;AAAA,QAChB,aAAaD,6BAAA,CAAa;AAAA,OAC5B;AAAA,MACA,MAAM,KAAK,EAAE,UAAA,EAAY,QAAQ,MAAA,EAAQ,cAAA,EAAgB,aAAY,EAAG;AACtE,QAAA,UAAA,CAAW,GAAA;AAAA,UACT,MAAME,mBAAA,CAAa;AAAA,YACjB,MAAA;AAAA,YACA,MAAA;AAAA,YACA,cAAA;AAAA,YACA;AAAA,WACD;AAAA,SACH;AAAA,MACF;AAAA,KACD,CAAA;AAAA,EACH;AACF,CAAC;;;;"}
+{"version":3,"file":"plugin.cjs.js","sources":["../src/plugin.ts"],"sourcesContent":["import {\n  coreServices,\n  createBackendPlugin,\n} from '@backstage/backend-plugin-api';\nimport { createRouter } from './service/router';\nimport { catalogServiceRef } from '@backstage/plugin-catalog-node';\nimport { PolicyReporterService } from './service/policyReporterService';\n\n/**\n * kyvernoPolicyReportsPlugin backend plugin\n *\n * @public\n */\nexport const kyvernoPolicyReportsPlugin = createBackendPlugin({\n  pluginId: 'policy-reporter',\n  register(env) {\n    env.registerInit({\n      deps: {\n        httpRouter: coreServices.httpRouter,\n        logger: coreServices.logger,\n        config: coreServices.rootConfig,\n        catalogService: catalogServiceRef,\n        authService: coreServices.auth,\n      },\n      async init({ httpRouter, logger, config, catalogService, authService }) {\n        const policyReporterService = new PolicyReporterService({\n          logger,\n          configService: config,\n          catalogService,\n          authService,\n        });\n\n        httpRouter.use(\n          await createRouter({\n            logger,\n            config,\n            policyReporterService,\n          }),\n        );\n      },\n    });\n  },\n});\n"],"names":["createBackendPlugin","coreServices","catalogServiceRef","policyReporterService","PolicyReporterService","createRouter"],"mappings":";;;;;;;AAaO,MAAM,6BAA6BA,oCAAA,CAAoB;AAAA,EAC5D,QAAA,EAAU,iBAAA;AAAA,EACV,SAAS,GAAA,EAAK;AACZ,IAAA,GAAA,CAAI,YAAA,CAAa;AAAA,MACf,IAAA,EAAM;AAAA,QACJ,YAAYC,6BAAA,CAAa,UAAA;AAAA,QACzB,QAAQA,6BAAA,CAAa,MAAA;AAAA,QACrB,QAAQA,6BAAA,CAAa,UAAA;AAAA,QACrB,cAAA,EAAgBC,mCAAA;AAAA,QAChB,aAAaD,6BAAA,CAAa;AAAA,OAC5B;AAAA,MACA,MAAM,KAAK,EAAE,UAAA,EAAY,QAAQ,MAAA,EAAQ,cAAA,EAAgB,aAAY,EAAG;AACtE,QAAA,MAAME,uBAAA,GAAwB,IAAIC,2CAAA,CAAsB;AAAA,UACtD,MAAA;AAAA,UACA,aAAA,EAAe,MAAA;AAAA,UACf,cAAA;AAAA,UACA;AAAA,SACD,CAAA;AAED,QAAA,UAAA,CAAW,GAAA;AAAA,UACT,MAAMC,mBAAA,CAAa;AAAA,YACjB,MAAA;AAAA,YACA,MAAA;AAAA,mCACAF;AAAA,WACD;AAAA,SACH;AAAA,MACF;AAAA,KACD,CAAA;AAAA,EACH;AACF,CAAC;;;;"}