Skip to content

Commit 8b8c282

Browse files
rseedorffsecureCodeBoxBot
authored andcommitted
Updating Helm Docs
1 parent 9576cd3 commit 8b8c282

3 files changed

Lines changed: 246 additions & 12 deletions

File tree

operator/README.md

Lines changed: 68 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,52 @@
1-
# operator
1+
---
2+
title: "secreCodeBox Operator"
3+
category: "core"
4+
type: "Operator"
5+
state: "released"
6+
appVersion: ""
7+
usecase: "secureCodeBox Operator is the core componente."
8+
---
29

3-
![Version: v2.7.0-alpha1](https://img.shields.io/badge/Version-v2.7.0--alpha1-informational?style=flat-square) ![Type: application](https://img.shields.io/badge/Type-application-informational?style=flat-square)
10+
![operator logo](https://docs.securecodebox.io/img/Logo_Color.svg)
411

5-
secureCodeBox Operator to automate the execution of security scans on kubernetes
12+
<!--
13+
SPDX-FileCopyrightText: 2020 iteratec GmbH
614
7-
**Homepage:** <https://docs.securecodebox.io/docs/getting-started/installation>
15+
SPDX-License-Identifier: Apache-2.0
16+
-->
17+
<!--
18+
.: IMPORTANT! :.
19+
--------------------------
20+
This file is generated automaticaly with `helm-docs` based on the following template files:
21+
- ./.helm-docs/templates.gotmpl (general template data for all charts)
22+
- ./chart-folder/.helm-docs.gotmpl (chart specific template data)
23+
24+
Please be aware of that and apply your changes only within those template files instead of this file.
25+
Otherwise your changes will be reverted/overriden automaticaly due to the build process `./.github/workflows/helm-docs.yaml`
26+
--------------------------
27+
-->
828

9-
## Maintainers
29+
<p align="center">
30+
<a href="https://opensource.org/licenses/Apache-2.0"><img alt="License Apache-2.0" src="https://img.shields.io/badge/License-Apache%202.0-blue.svg"></a>
31+
<a href="https://github.com/secureCodeBox/secureCodeBox/releases/latest"><img alt="GitHub release (latest SemVer)" src="https://img.shields.io/github/v/release/secureCodeBox/secureCodeBox?sort=semver"></a>
32+
<a href="https://owasp.org/www-project-securecodebox/"><img alt="OWASP Incubator Project" src="https://img.shields.io/badge/OWASP-Incubator%20Project-365EAA"></a>
33+
<a href="https://artifacthub.io/packages/search?repo=seccurecodebox"><img alt="Artifact HUB" src="https://img.shields.io/endpoint?url=https://artifacthub.io/badge/repository/seccurecodebox"></a>
34+
<a href="https://github.com/secureCodeBox/secureCodeBox/"><img alt="GitHub Repo stars" src="https://img.shields.io/github/stars/secureCodeBox/secureCodeBox?logo=GitHub"></a>
35+
<a href="https://twitter.com/securecodebox"><img alt="Twitter Follower" src="https://img.shields.io/twitter/follow/securecodebox?style=flat&color=blue&logo=twitter"></a>
36+
</p>
1037

11-
| Name | Email | Url |
12-
| ---- | ------ | --- |
13-
| iteratec GmbH | secureCodeBox@iteratec.com | |
38+
## What is secureCodeBox Operator?
39+
The secureCodeBox operator is running on Kubernetes and is the core component of the complete secureCodeBox stack, responsible for managing all scans and resources.
1440

15-
## Source Code
41+
**Homepage:** <https://docs.securecodebox.io/docs/getting-started/installation>
1642

17-
* <https://github.com/secureCodeBox/secureCodeBox>
43+
## Deployment
44+
The operator `scanType` can be deployed via helm:
45+
46+
```bash
47+
# Install HelmChart (use -n to configure another namespace)
48+
helm upgrade --install operator secureCodeBox/operator
49+
```
1850

1951
## Requirements
2052

@@ -24,6 +56,19 @@ Kubernetes: `>=v1.11.0-0`
2456
|------------|------|---------|
2557
| https://helm.min.io/ | minio | 7.1.2 |
2658

59+
## Deployment
60+
61+
The secureCodeBox Operator can be deployed via helm:
62+
63+
```bash
64+
# Add the secureCodeBox Helm Repo
65+
helm repo add secureCodeBox https://charts.securecodebox.io
66+
# Create a new namespace for the secureCodeBox Operator
67+
kubectl create namespace securecodebox-system
68+
# Install the Operator & CRDs
69+
helm install securecodebox-operator secureCodeBox/operator
70+
```
71+
2772
## Values
2873

2974
| Key | Type | Default | Description |
@@ -65,5 +110,16 @@ Kubernetes: `>=v1.11.0-0`
65110
| serviceAccount.name | string | `"securecodebox-operator"` | Name of the serviceAccount the operator uses to talk to the k8s api |
66111
| telemetryEnabled | bool | `true` | The Operator sends anonymous telemetry data, to give the team an overview how much the secureCodeBox is used. Find out more at https://www.securecodebox.io/telemetry |
67112

68-
----------------------------------------------
69-
Autogenerated from chart metadata using [helm-docs v1.5.0](https://github.com/norwoodj/helm-docs/releases/v1.5.0)
113+
## License
114+
[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
115+
116+
Code of secureCodeBox is licensed under the [Apache License 2.0][scb-license].
117+
118+
[scb-owasp]: https://www.owasp.org/index.php/OWASP_secureCodeBox
119+
[scb-docs]: https://docs.securecodebox.io/
120+
[scb-site]: https://www.securecodebox.io/
121+
[scb-github]: https://github.com/secureCodeBox/
122+
[scb-twitter]: https://twitter.com/secureCodeBox
123+
[scb-slack]: https://join.slack.com/t/securecodebox/shared_invite/enQtNDU3MTUyOTM0NTMwLTBjOWRjNjVkNGEyMjQ0ZGMyNDdlYTQxYWQ4MzNiNGY3MDMxNThkZjJmMzY2NDRhMTk3ZWM3OWFkYmY1YzUxNTU
124+
[scb-license]: https://github.com/secureCodeBox/secureCodeBox/blob/master/LICENSE
125+

operator/docs/README.ArtifactHub.md

Lines changed: 119 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -23,3 +23,122 @@ Otherwise your changes will be reverted/overriden automaticaly due to the build
2323
<a href="https://github.com/secureCodeBox/secureCodeBox/"><img alt="GitHub Repo stars" src="https://img.shields.io/github/stars/secureCodeBox/secureCodeBox?logo=GitHub"></a>
2424
<a href="https://twitter.com/securecodebox"><img alt="Twitter Follower" src="https://img.shields.io/twitter/follow/securecodebox?style=flat&color=blue&logo=twitter"></a>
2525
</p>
26+
27+
## What is OWASP secureCodeBox?
28+
29+
<p align="center">
30+
<img alt="secureCodeBox Logo" src="https://docs.securecodebox.io/img/Logo_Color.svg" width="250px">
31+
</p>
32+
33+
_[OWASP secureCodeBox][scb-github]_ is an automated and scalable open source solution that can be used to integrate various *security vulnerability scanners* with a simple and lightweight interface. The _secureCodeBox_ mission is to support *DevSecOps* Teams to make it easy to automate security vulnerability testing in different scenarios.
34+
35+
With the _secureCodeBox_ we provide a toolchain for continuous scanning of applications to find the low-hanging fruit issues early in the development process and free the resources of the penetration tester to concentrate on the major security issues.
36+
37+
The secureCodeBox project is running on [Kubernetes](https://kubernetes.io/). To install it you need [Helm](https://helm.sh), a package manager for Kubernetes. It is also possible to start the different integrated security vulnerability scanners based on a docker infrastructure.
38+
39+
### Quickstart with secureCodeBox on kubernetes
40+
41+
You can find resources to help you get started on our [documentation website](https://docs.securecodebox.io) including instruction on how to [install the secureCodeBox project](https://docs.securecodebox.io/docs/getting-started/installation) and guides to help you [run your first scans](https://docs.securecodebox.io/docs/getting-started/first-scans) with it.
42+
43+
## What is secureCodeBox Operator?
44+
The secureCodeBox operator is running on Kubernetes and is the core component of the complete secureCodeBox stack, responsible for managing all scans and resources.
45+
46+
**Homepage:** <https://docs.securecodebox.io/docs/getting-started/installation>
47+
48+
## Deployment
49+
The operator `scanType` can be deployed via helm:
50+
51+
```bash
52+
# Install HelmChart (use -n to configure another namespace)
53+
helm upgrade --install operator secureCodeBox/operator
54+
```
55+
56+
## Requirements
57+
58+
Kubernetes: `>=v1.11.0-0`
59+
60+
| Repository | Name | Version |
61+
|------------|------|---------|
62+
| https://helm.min.io/ | minio | 7.1.2 |
63+
64+
## Deployment
65+
66+
The secureCodeBox Operator can be deployed via helm:
67+
68+
```bash
69+
# Add the secureCodeBox Helm Repo
70+
helm repo add secureCodeBox https://charts.securecodebox.io
71+
# Create a new namespace for the secureCodeBox Operator
72+
kubectl create namespace securecodebox-system
73+
# Install the Operator & CRDs
74+
helm install securecodebox-operator secureCodeBox/operator
75+
```
76+
77+
## Values
78+
79+
| Key | Type | Default | Description |
80+
|-----|------|---------|-------------|
81+
| customCACertificate | object | `{"certificate":"public.crt","existingCertificate":null}` | Setup for Custom CA certificates. These are automatically mounted into every secureCodeBox component (lurcher, parser & hooks). Requires that every namespace has a configmap with the CA certificate(s) |
82+
| customCACertificate.certificate | string | `"public.crt"` | key in the configmap holding the certificate(s) |
83+
| customCACertificate.existingCertificate | string | `nil` | name of the configMap holding the ca certificate(s), needs to be the same across all namespaces |
84+
| image.pullPolicy | string | `"Always"` | Image pull policy |
85+
| image.repository | string | `"docker.io/securecodebox/operator"` | The operator image repository |
86+
| image.tag | string | defaults to the charts version | Parser image tag |
87+
| lurcher.image.pullPolicy | string | `"Always"` | Image pull policy |
88+
| lurcher.image.repository | string | `"docker.io/securecodebox/lurcher"` | The operator image repository |
89+
| lurcher.image.tag | string | defaults to the charts version | Parser image tag |
90+
| minio.defaultBucket.enabled | bool | `true` | |
91+
| minio.defaultBucket.name | string | `"securecodebox"` | |
92+
| minio.enabled | bool | `true` | Enable this to use minio as storage backend instead of a cloud bucket provider like AWS S3, Google Cloud Storage, DigitalOcean Spaces etc. |
93+
| minio.resources.requests.memory | string | `"256Mi"` | |
94+
| minio.tls.certSecret | string | `"minio-tls"` | |
95+
| minio.tls.enabled | bool | `false` | |
96+
| podSecurityContext | object | `{}` | Sets the securityContext on the operators pod level. See: https://kubernetes.io/docs/tasks/configure-pod-container/security-context/#set-the-security-context-for-a-container |
97+
| resources | object | `{"limits":{"cpu":"100m","memory":"30Mi"},"requests":{"cpu":"100m","memory":"20Mi"}}` | CPU/memory resource requests/limits (see: https://kubernetes.io/docs/tasks/configure-pod-container/assign-memory-resource/, https://kubernetes.io/docs/tasks/configure-pod-container/assign-cpu-resource/) |
98+
| s3.authType | string | `"access-secret-key"` | Authentication method. Supports access-secret-key (used by most s3 endpoint) and aws-irsa (Used by AWS EKS IAM Role to Kubenetes Service Account Binding. Support for AWS IRSA is considered experimental in the secureCodeBox) |
99+
| s3.awsStsEndpoint | string | `"https://sts.amazonaws.com"` | STS Endpoint used in AWS IRSA Authentication. Change this to the sts endpoint of your aws region. Only used when s3.authType is set to "aws-irsa" |
100+
| s3.bucket | string | `"my-bucket"` | |
101+
| s3.enabled | bool | `false` | |
102+
| s3.endpoint | string | `"fra1.digitaloceanspaces.com"` | |
103+
| s3.keySecret | string | `"my-secret"` | |
104+
| s3.port | string | `nil` | |
105+
| s3.secretAttributeNames.accesskey | string | `"accesskey"` | |
106+
| s3.secretAttributeNames.secretkey | string | `"secretkey"` | |
107+
| securityContext | object | `{"allowPrivilegeEscalation":false,"capabilities":{"drop":["all"]},"privileged":false,"readOnlyRootFilesystem":true,"runAsNonRoot":true}` | Sets the securityContext on the operators container level. See: https://kubernetes.io/docs/tasks/configure-pod-container/security-context/#set-the-security-context-for-a-pod |
108+
| securityContext.allowPrivilegeEscalation | bool | `false` | Ensure that users privileges cannot be escalated |
109+
| securityContext.capabilities.drop[0] | string | `"all"` | This drops all linux privileges from the operator container. They are not required |
110+
| securityContext.privileged | bool | `false` | Ensures that the operator container is not run in privileged mode |
111+
| securityContext.readOnlyRootFilesystem | bool | `true` | Prevents write access to the containers file system |
112+
| securityContext.runAsNonRoot | bool | `true` | Enforces that the Operator image is run as a non root user |
113+
| serviceAccount.annotations | object | `{}` | Annotations of the serviceAccount the operator uses to talk to the k8s api |
114+
| serviceAccount.labels | object | `{}` | Labels of the serviceAccount the operator uses to talk to the k8s api |
115+
| serviceAccount.name | string | `"securecodebox-operator"` | Name of the serviceAccount the operator uses to talk to the k8s api |
116+
| telemetryEnabled | bool | `true` | The Operator sends anonymous telemetry data, to give the team an overview how much the secureCodeBox is used. Find out more at https://www.securecodebox.io/telemetry |
117+
118+
## Contributing
119+
120+
Contributions are welcome and extremely helpful 🙌
121+
Please have a look at [Contributing](./CONTRIBUTING.md)
122+
123+
## Community
124+
125+
You are welcome, please join us on... 👋
126+
127+
- [GitHub][scb-github]
128+
- [Slack][scb-slack]
129+
- [Twitter][scb-twitter]
130+
131+
secureCodeBox is an official [OWASP][scb-owasp] project.
132+
133+
## License
134+
[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
135+
136+
Code of secureCodeBox is licensed under the [Apache License 2.0][scb-license].
137+
138+
[scb-owasp]: https://www.owasp.org/index.php/OWASP_secureCodeBox
139+
[scb-docs]: https://docs.securecodebox.io/
140+
[scb-site]: https://www.securecodebox.io/
141+
[scb-github]: https://github.com/secureCodeBox/
142+
[scb-twitter]: https://twitter.com/secureCodeBox
143+
[scb-slack]: https://join.slack.com/t/securecodebox/shared_invite/enQtNDU3MTUyOTM0NTMwLTBjOWRjNjVkNGEyMjQ0ZGMyNDdlYTQxYWQ4MzNiNGY3MDMxNThkZjJmMzY2NDRhMTk3ZWM3OWFkYmY1YzUxNTU
144+
[scb-license]: https://github.com/secureCodeBox/secureCodeBox/blob/master/LICENSE

operator/docs/README.DockerHub-Core.md

Lines changed: 59 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -23,3 +23,62 @@ Otherwise your changes will be reverted/overriden automaticaly due to the build
2323
<a href="https://github.com/secureCodeBox/secureCodeBox/"><img alt="GitHub Repo stars" src="https://img.shields.io/github/stars/secureCodeBox/secureCodeBox?logo=GitHub"></a>
2424
<a href="https://twitter.com/securecodebox"><img alt="Twitter Follower" src="https://img.shields.io/twitter/follow/securecodebox?style=flat&color=blue&logo=twitter"></a>
2525
</p>
26+
27+
## What is OWASP secureCodeBox?
28+
29+
<p align="center">
30+
<img alt="secureCodeBox Logo" src="https://docs.securecodebox.io/img/Logo_Color.svg" width="250px">
31+
</p>
32+
33+
_[OWASP secureCodeBox][scb-github]_ is an automated and scalable open source solution that can be used to integrate various *security vulnerability scanners* with a simple and lightweight interface. The _secureCodeBox_ mission is to support *DevSecOps* Teams to make it easy to automate security vulnerability testing in different scenarios.
34+
35+
With the _secureCodeBox_ we provide a toolchain for continuous scanning of applications to find the low-hanging fruit issues early in the development process and free the resources of the penetration tester to concentrate on the major security issues.
36+
37+
The secureCodeBox project is running on [Kubernetes](https://kubernetes.io/). To install it you need [Helm](https://helm.sh), a package manager for Kubernetes. It is also possible to start the different integrated security vulnerability scanners based on a docker infrastructure.
38+
39+
### Quickstart with secureCodeBox on kubernetes
40+
41+
You can find resources to help you get started on our [documentation website](https://docs.securecodebox.io) including instruction on how to [install the secureCodeBox project](https://docs.securecodebox.io/docs/getting-started/installation) and guides to help you [run your first scans](https://docs.securecodebox.io/docs/getting-started/first-scans) with it.
42+
43+
## Supported Tags
44+
- `latest` (represents the latest stable release build)
45+
- tagged releases, e.g. `v2.7.0-alpha1`
46+
47+
## How to use this image
48+
This `core` image is intended to work in combination with the OWASP secureCodeBox. For more informations details please take a look at the documentation page: https://docs.securecodebox.io/docs/getting-started/installation.
49+
50+
```bash
51+
docker pull securecodebox/operator
52+
```
53+
54+
## What is secureCodeBox Operator?
55+
The secureCodeBox operator is running on Kubernetes and is the core component of the complete secureCodeBox stack, responsible for managing all scans and resources.
56+
57+
**Homepage:** <https://docs.securecodebox.io/docs/getting-started/installation>
58+
59+
## Community
60+
61+
You are welcome, please join us on... 👋
62+
63+
- [GitHub][scb-github]
64+
- [Slack][scb-slack]
65+
- [Twitter][scb-twitter]
66+
67+
secureCodeBox is an official [OWASP][scb-owasp] project.
68+
69+
## License
70+
[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
71+
72+
View [license information](https://github.com/secureCodeBox/secureCodeBox/blob/master/LICENSE) for the software contained in this image.
73+
74+
As with all Docker images, these likely also contain other software which may be under other licenses (such as Bash, etc from the base distribution, along with any direct or indirect dependencies of the primary software being contained).
75+
76+
As for any pre-built image usage, it is the image user's responsibility to ensure that any use of this image complies with any relevant licenses for all software contained within.
77+
78+
[scb-owasp]: https://www.owasp.org/index.php/OWASP_secureCodeBox
79+
[scb-docs]: https://docs.securecodebox.io/
80+
[scb-site]: https://www.securecodebox.io/
81+
[scb-github]: https://github.com/secureCodeBox/
82+
[scb-twitter]: https://twitter.com/secureCodeBox
83+
[scb-slack]: https://join.slack.com/t/securecodebox/shared_invite/enQtNDU3MTUyOTM0NTMwLTBjOWRjNjVkNGEyMjQ0ZGMyNDdlYTQxYWQ4MzNiNGY3MDMxNThkZjJmMzY2NDRhMTk3ZWM3OWFkYmY1YzUxNTU
84+
[scb-license]: https://github.com/secureCodeBox/secureCodeBox/blob/master/LICENSE

0 commit comments

Comments
 (0)