Mesh-Kridik - An Open-Source Security Checker That Performs Various Security Checks On A Kubernetes Cluster With Istio Service Mesh And Is Leveraged By OPA (Open Policy Agent) To Enforce Security Rules
Enhance your Kubernetes service mesh security !!
mesh-kridik is an open-source security checker that performs various security checks on a Kubernetes cluster with istio service mesh and outputs a security report.
The security checks tests are the full implementation of istio security best practices
The security checks performed on a Kubernetes cluster with istio service mesh and is leveraged by OPA (Open Policy Agent) to enforce security rules, and the output audit report includes: the root cause of the security issue and proposed remediation for the security issue.
Requirements
- Go 1.16+
- jq
- istio
Installation
git clone https://github.com/chen-keinan/mesh-kridik
cd mesh-kridik
make build
- Note: mesh-kridik require root user to be executed
Quick Start
Execute Mesh-Kridik without any flags , execute all tests
./mesh-kridik
Execute mesh-kridik with flags , execute test on demand
Usage: mesh-kridik [--version] [--help] <command> [<args>]
Available commands are:
-r , --report : run audit tests and generate remediation report
Execute tests and generate failure tests report and it remediation's
./mesh-kridik -r
Istio Security Checks
Name | Description | Impact |
---|---|---|
Mutual TLS | Istio Mutual TLS proxies are configured in permissive mode by default | proxies will accept both mutual TLS and plaintext traffic |
Istio Safer Authorization Policy Patterns | Use ALLOW-with-positive-matching or DENY-with-negative-match patterns | These authorization policy patterns are safer because the worst result in the case of policy mismatch is an unexpected 403 rejection instead of an authorization policy bypass. |
path normalization in authorization policy | The enforcement point for authorization policies is the Envoy proxy instead of the usual resource access point in the backend application | A mismatch can lead to either unexpected rejection or a policy bypass |
TLS origination for egress traffic | Use of DestinationRule on service ServiceEntry for egress traffic | Not using TLS origination for egress traffic to an external service will be send with plain/text |
Protocol detection | explicitly declare the service protocol | miss detection may result in unexpected traffic behavior |
CNI support | istio transparent traffic capture | not al net traffic will not be capture |
overly broad hosts | avoid overly broad hosts settings in Gateway | may cause potential exposure of unexpected domains |
Restrict Gateway creation privileges | restrict creation of Gateway resources to trusted cluster administrators | may cause creation of gateway by untrusted users |
Configure a limit on downstream connections | Update global_downstream_max_connections in the config map according to the number of concurrent connections needed by individual gateway instances in your deployment. Once the limit is reached, Envoy will start rejecting tcp connections | no limit on the number of downstream connections can cause exploited by a malicious actor |
Configure third party service account tokens | It is recommended to configure 3rd party tokens Because the properties of the first party token are less secure | first party token properties are less secure and might cause authentication breach |
Control Plane | Istiod exposes a few unauthenticated plaintext ports for convenience by default | exposes the XDS service port 15010 and debug port 8080 over unauthenticated plaintext |
Data Plane | The proxy exposes a variety of ports | The applications running in the same pod as the proxy have access; there is no trust boundary between the sidecar and application |
Understand traffic capture limitations | Securing egress traffic by setting the meshConfig.outboundTrafficPolicy.mode | external service access will not be controlled |
User Plugin Usage (via go plugins)
The Kube-kridik expose a hook for user plugins Example :
- MeshSecurityCheckResultHook - this hook accepts k8s service mesh security checks results
Compile user plugin
go build -buildmode=plugin -o=~/<plugin folder>/<plugin>.so ~/<plugin folder>/<plugin>.go
Copy plugin to folder (.kube-kridik folder is created on the 1st startup)
cp ~/<plugin folder>/<plugin>.so ~/.kube-kridik/plugins/compile/<plugin>.so
Supported Spec
The Kube-kridik support this specs and can be easily extended:
- The full Istio service mesh best practices istio security best practices
this specs can be easily extended by amended the spec files under ~/.mesh-kridik/security/mesh/istio
folder
Contribution
- code contribution is welcome !! , contribution with tests and passing linter is more than welcome :)
- /.dev folder include vagrantfile to be used for development : Dev Instruction