workload-security-guard

module
v0.0.61 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Aug 23, 2022 License: Apache-2.0

README

Security Guard

Security

guard-gate uses Micro-rules to monitor and potentialy block requests and/or responses to services. Micro-rules offer a fine grain filtering performed against each value delivered to/from the service. By using Micro-rules, guard-gate makes it hard to deliver an exploit to be used against a vulnerability embedded as part of the service or its dependencies.

Using guard-gate will typically require an offender to build a dedicated delivery mechanism in order to explore options for detecting and exploiting service vulnerabilities. This leangthy process may need to be repeated for each service, as each service maintains a different set of micro-rules. As a result, an offender will not be able to use common statistical attack patterns.

The user of guard-gate gains Situational Awareness both thanks to alerts about request/responses out of pattern and by the identification of indicators that the service is misused. Such indicators include longer than usual service times and the list of external IP addresses appraoched by the service.

Beyond, Situational Awareness, guard-gate enables blocking of out-of-pattern behaviours and the ability to react to potential attacks and/or to on-going attacks by introducing a fine-tune configrable security gate in front of the service.

Overall the solution offers both visibility into the security of the service as well as the ability to monitor/block both known patterns and unknown patterns (using a zero day exploits).

Solution components

This project adds:

  1. A workload security gate named guard-gate implemented as a go package
  2. A set of micro-rules used by guard-gate named Guardian implemenyedas a CRD or configmap
  3. A learner service to auto learn the micro-rules in Guardian named guard-learner
  4. A user interface web app to simplify manual configuration of micro-rules named guard-ui

In addition, the project adds:

  1. A go package to enable using guard-gate woth Knative Queue Proxy Option named qpoption
  2. A go package to enable testing Knative Queue Proxy Options named test-gate

Guard Gate

guard-gate can be loaded as a knative queue proxy option using qpoption

Once loaded, it monitors the proxied requests and responses. If the proxy runs as a sidecar conatiner to the service, the pod network may also be monitored.

Note that guard-gate can also be used for more generic kubernetes use cases by loading:

  • As a standalone reverse proxy, see for example: guard-rproxy
  • As an extension to any go proxy, for example by using: rtplugs.

Guardian

guard-gate uses Guardian - a set of micro-rules that define the expected behaviour of the service.

Guardian may reside in a CRD (guardians.wsecurity.ibmresearch.com) under the name . or in a configmap under the name 'guardian-'. If a Guardian is not found, guard-gate will look for a namespace-default Guardian as a starting point under the name - or in a configmap under the name 'guardian--'. If a namespace-default Guardian is not found, guard-gate will use an empty set of micro-rules as a starting point and will set itself to work in auto-learning mode (See guard-gate for more details on the different working modes).

Guard Learner

guard-learner is a standalone service used to learn Guardian micro-srules based on inputs from instances of guard-gate. guard-learner stores the Guardian as a CRD (guardians.wsecurity.ibmresearch.com) under the name . or in a configmap under the name 'guardian-'.

Guard User Interface

Although Guardian CRDs and Configmaps can be controled directly via kubectl. An optional guard-ui is offered to simplify and clarify the micro-rules.

Directories

Path Synopsis
cmd
pkg
apis/wsecurity/v1
Package v1 is the v1 version of the API.
Package v1 is the v1 version of the API.
generated/clientset/guardians
This package has the automatically generated clientset.
This package has the automatically generated clientset.
generated/clientset/guardians/fake
This package has the automatically generated fake clientset.
This package has the automatically generated fake clientset.
generated/clientset/guardians/scheme
This package contains the scheme of the automatically generated clientset.
This package contains the scheme of the automatically generated clientset.
generated/clientset/guardians/typed/wsecurity/v1
This package has the automatically generated typed clients.
This package has the automatically generated typed clients.
generated/clientset/guardians/typed/wsecurity/v1/fake
Package fake has the automatically generated clients.
Package fake has the automatically generated clients.
examples/create-update-delete-deployment
Note: the example only works with the code within the same release/branch.
Note: the example only works with the code within the same release/branch.
examples/dynamic-create-update-delete-deployment
Note: the example only works with the code within the same release/branch.
Note: the example only works with the code within the same release/branch.
examples/fake-client
Package fakeclient contains examples on how to use fakeclient in tests.
Package fakeclient contains examples on how to use fakeclient in tests.
examples/in-cluster-client-configuration
Note: the example only works with the code within the same release/branch.
Note: the example only works with the code within the same release/branch.
examples/out-of-cluster-client-configuration
Note: the example only works with the code within the same release/branch.
Note: the example only works with the code within the same release/branch.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL