You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/values.md
+60-2Lines changed: 60 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -16,6 +16,7 @@ Comprehensive reference for all configuration values available in the BunkerWeb
16
16
-[redis](#redis) - Cache and session storage for BunkerWeb
17
17
-[grafana](#grafana) - Dashboards and visualization
18
18
-[prometheus](#prometheus) - Metrics collection and storage
19
+
-[api](#api) - External API for BunkerWeb that exposes REST interface for automation tools
19
20
-[ingressClass](#ingressclass) - Kubernetes IngressClass resource for BunkerWeb
20
21
-[networkPolicy](#networkpolicy) - Network policies for micro-segmentation
21
22
-[service](#service) - External service for BunkerWeb (LoadBalancer/NodePort)
@@ -200,7 +201,7 @@ Manages BunkerWeb configuration and coordination
200
201
|`scheduler.features.metrics`| Configuration for metrics |`object`| See nested values |
201
202
|`scheduler.features.modsecurity`| Configuration for modsecurity |`object`| See nested values |
202
203
|`scheduler.features.php`| Configuration for php |`object`| See nested values |
203
-
|`scheduler.features.rateLimit`|Configuration for rateLimit|`object`| See nested values |
204
+
|`scheduler.features.rateLimit`|Rate limiting configuration for API access https://docs.bunkerweb.io/latest/api/#rate-limiting|`object`| See nested values |
204
205
|`scheduler.features.realIp`| Configuration for realIp |`object`| See nested values |
205
206
|`scheduler.features.redirect`| Configuration for redirect |`object`| See nested values |
206
207
|`scheduler.features.reverseProxy`| Configuration for reverseProxy |`object`| See nested values |
@@ -209,7 +210,7 @@ Manages BunkerWeb configuration and coordination
209
210
|`scheduler.features.securityTxt`| Configuration for securityTxt |`object`| See nested values |
210
211
|`scheduler.features.sessions`| Configuration for sessions |`object`| See nested values |
211
212
|`scheduler.features.ssl`| Configuration for ssl |`object`| See nested values |
212
-
|`scheduler.features.whitelist`|Configuration for whitelist|`object`| See nested values |
213
+
|`scheduler.features.whitelist`|Whitelist configuration for API access|`object`| See nested values |
213
214
|`scheduler.livenessProbe.exec`| Configuration for exec |`object`| See nested values |
214
215
|`scheduler.livenessProbe.failureThreshold`| Configuration for failureThreshold |`int`|`3`|
215
216
|`scheduler.livenessProbe.initialDelaySeconds`| Configuration for initialDelaySeconds |`int`|`90`|
@@ -520,6 +521,39 @@ Metrics collection and storage
520
521
521
522
---
522
523
524
+
## api
525
+
526
+
External API for BunkerWeb that exposes REST interface for automation tools
527
+
528
+
| Parameter | Description | Type | Default |
529
+
|-----------|-------------|------|---------|
530
+
|`api`| External API for BunkerWeb that exposes REST interface for automation tools |`object`| See nested values |
531
+
|`api.enabled`| Enable external service creation |`bool`|`true`|
|`api.securityContext`| Security context for BunkerWeb container |`object`| See nested values |
541
+
|`api.tag`| Configuration for tag |`string`|`"1.6.6"`|
542
+
|`api.tolerations`| Tolerations (overrides global setting) |`list`|`[]`|
543
+
|`api.livenessProbe.exec`| Configuration for exec |`object`| See nested values |
544
+
|`api.livenessProbe.failureThreshold`| Configuration for failureThreshold |`int`|`3`|
545
+
|`api.livenessProbe.initialDelaySeconds`| Configuration for initialDelaySeconds |`int`|`30`|
546
+
|`api.livenessProbe.periodSeconds`| Configuration for periodSeconds |`int`|`5`|
547
+
|`api.livenessProbe.timeoutSeconds`| Configuration for timeoutSeconds |`int`|`1`|
548
+
|`api.securityContext.allowPrivilegeEscalation`| Configuration for allowPrivilegeEscalation |`bool`|`false`|
549
+
|`api.securityContext.capabilities`| Configuration for capabilities |`object`| See nested values |
550
+
|`api.securityContext.runAsGroup`| Configuration for runAsGroup |`int`|`101`|
551
+
|`api.securityContext.runAsUser`| Configuration for runAsUser |`int`|`101`|
552
+
|`api.livenessProbe.exec.command`| Configuration for command |`list`|`['/usr/share/bunkerweb/helpers/healthcheck-api.sh']`|
553
+
|`api.securityContext.capabilities.drop`| Configuration for drop |`list`|`['ALL']`|
554
+
555
+
---
556
+
523
557
## ingressClass
524
558
525
559
Kubernetes IngressClass resource for BunkerWeb
@@ -572,11 +606,24 @@ Configuration for BunkerWeb behavior in Kubernetes environment
572
606
| Parameter | Description | Type | Default |
573
607
|-----------|-------------|------|---------|
574
608
|`settings`| Configuration for BunkerWeb behavior in Kubernetes environment |`object`| See nested values |
609
+
|`settings.api`| Configuration for api |`object`| See nested values |
575
610
|`settings.existingSecret`| Specify the name of an existing secret containing sensitive parameters. When using this, the followi... |`string`|`""`|
576
611
|`settings.kubernetes`| Configuration for kubernetes |`object`| See nested values |
577
612
|`settings.misc`| Configuration for misc |`object`| See nested values |
578
613
|`settings.redis`| Configuration for redis |`object`| See nested values |
579
614
|`settings.ui`| Configuration for ui |`object`| See nested values |
615
+
|`settings.api.apiAclBootstrapFile`| OR/AND ConfigMap name that includes ACL based JSON File https://docs.bunkerweb.io/latest/api/#permis...|`string`|`""`|
616
+
|`settings.api.apiPassword`| Configuration for apiPassword |`string`|`""`|
617
+
|`settings.api.apiToken`| Authentication settings https://docs.bunkerweb.io/latest/api/#authentication API Bearer Token Leave ... |`string`|`""`|
618
+
|`settings.api.apiUsername`| OR/AND API Username and Password Leave Empty if using settings.existingSecret |`string`|`""`|
619
+
|`settings.api.docsUrl`| URL for API documentation, set to an empty value to disable |`string`|`"/docs"`|
620
+
|`settings.api.forwardedAllowIps`| Forwarded allow IPs for correct client IP detection |`string`|`"*"`|
621
+
|`settings.api.ingress`| Ingress configuration for UI access |`object`| See nested values |
622
+
|`settings.api.openApiUrl`| URL for OpenAPI specification, set to an empty value to disable |`string`|`"/openapi.json"`|
623
+
|`settings.api.rateLimit`| Rate limiting configuration for API access https://docs.bunkerweb.io/latest/api/#rate-limiting|`object`| See nested values |
624
+
|`settings.api.redocUrl`| URL for ReDoc API documentation, set to an empty value to disable |`string`|`"/redoc"`|
625
+
|`settings.api.rootPath`| API Configuration https://docs.bunkerweb.io/latest/api/#configuration Root path for the API |`string`|`""`|
626
+
|`settings.api.whitelist`| Whitelist configuration for API access |`object`| See nested values |
580
627
|`settings.kubernetes.domainName`| Kubernetes cluster domain name for service discovery |`string`|`"cluster.local"`|
581
628
|`settings.kubernetes.ignoreAnnotations`| Annotations to be ignored by bunkerweb-controller when multiple ingress controllers (comma-separated... |`string`|`""`|
582
629
|`settings.kubernetes.ingressClass`| Ingress class name that BunkerWeb will handle Must match the IngressClass resource name |`string`|`""`|
@@ -595,6 +642,17 @@ Configuration for BunkerWeb behavior in Kubernetes environment
595
642
|`settings.ui.overrideAdminCreds`| Override admin credentials on startup Set to "yes" to reset admin credentials to the values above |`string`|`"no"`|
596
643
|`settings.ui.totpSecrets`| TOTP secrets for two-factor authentication |`string`|`""`|
597
644
|`settings.ui.wizard`| Enable the setup wizard on first launch |`bool`|`true`|
645
+
|`settings.api.ingress.enabled`| Set to true to create an Ingress resource for the UI |`bool`|`false`|
646
+
|`settings.api.ingress.extraAnnotations`| Additional annotations for the Ingress resource |`object`|`{}`|
647
+
|`settings.api.ingress.ingressClassName`| IngressClass name to use |`string`|`""`|
648
+
|`settings.api.ingress.serverName`| Domain name for UI access |`string`|`""`|
649
+
|`settings.api.ingress.serverPath`| Path for UI access (usually "/") |`string`|`"/"`|
650
+
|`settings.api.ingress.tlsSecretName`| Secret name containing TLS certificate Leave empty to disable HTTPS |`string`|`""`|
|`settings.api.rateLimit.enabled`| Set to true to create an Ingress resource for the UI |`bool`|`true`|
653
+
|`settings.api.rateLimit.strategy`| Strategy: "fixed-window" or "moving-window" or "sliding-window" https://limits.readthedocs.io/en/sta...|`string`|`"fixed-window"`|
654
+
|`settings.api.whitelist.enabled`| Set to true to create an Ingress resource for the UI |`bool`|`true`|
655
+
|`settings.api.whitelist.whitelistIps`| space-separated list of IPs/CIDR allowed to access the API |`string`|`"10.0.0.0/8"`|
598
656
|`settings.ui.ingress.enabled`| Set to true to create an Ingress resource for the UI |`bool`|`false`|
599
657
|`settings.ui.ingress.extraAnnotations`| Additional annotations for the Ingress resource |`object`|`{}`|
600
658
|`settings.ui.ingress.ingressClassName`| IngressClass name to use |`string`|`""`|
0 commit comments