Skip to content

Commit ffe806c

Browse files
committed
Sync documentation of main branch
1 parent 950a397 commit ffe806c

File tree

4 files changed

+55
-4
lines changed

4 files changed

+55
-4
lines changed

_generated-doc/main/infra/quarkus-all-build-items.adoc

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5383,6 +5383,21 @@ _No Javadoc found_
53835383

53845384

53855385

5386+
a| https://github.com/quarkusio/quarkus/blob/main/extensions/kubernetes-client/spi/src/main/java/io/quarkus/kubernetes/client/spi/KubernetesDevServiceInfoBuildItem.java[`io.quarkus.kubernetes.client.spi.KubernetesDevServiceInfoBuildItem`, window="_blank"]
5387+
[.description]
5388+
--
5389+
_No Javadoc found_
5390+
-- a|`java.lang.String kubeConfig`
5391+
5392+
_No Javadoc found_
5393+
5394+
`java.lang.String containerId`
5395+
5396+
_No Javadoc found_
5397+
5398+
5399+
5400+
53865401
a| https://github.com/quarkusio/quarkus/blob/main/extensions/kubernetes-client/spi/src/main/java/io/quarkus/kubernetes/client/spi/KubernetesResourcesBuildItem.java[`io.quarkus.kubernetes.client.spi.KubernetesResourcesBuildItem`, window="_blank"]
53875402
[.description]
53885403
--

_versions/main/guides/http-reference.adoc

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -40,8 +40,7 @@ Look at the xref:web-dependency-locator.adoc[Web dependency locator] guide for d
4040

4141
Static resources can be served from a local directory by installing an additional route in the Vert.x router.
4242

43-
For instance, to serve resources from the `static/` directory relative to the current path at http://localhost:8080/static/,
44-
you can install the following route:
43+
For instance, to serve resources from the `static/` directory relative to the current path at http://localhost:8080/static/, you can install the following route:
4544

4645
[source,java]
4746
----
@@ -248,6 +247,10 @@ The files are reloaded from the same location as they were initially loaded from
248247
If there is no content change, the reloading is a no-op.
249248
It the reloading fails, the server will continue to use the previous certificates.
250249

250+
=== Preventing client renegotiation
251+
252+
See xref:./tls-registry-reference.adoc#client-renegotiation[Preventing client renegotiation] for more information.
253+
251254
== Additional HTTP Headers
252255

253256
To enable HTTP headers to be sent on every response, add the following properties:

_versions/main/guides/observability-devservices-lgtm.adoc

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,8 +10,13 @@ include::_attributes.adoc[]
1010
:topics: observability,grafana,lgtm,otlp,opentelemetry,devservices,micrometer
1111
:extensions: io.quarkus:quarkus-observability-devservices
1212

13-
This Dev Service provides the https://github.com/grafana/docker-otel-lgtm[Grafana OTel-LGTM], an `all-in-one` Docker image containing an https://opentelemetry.io/docs/collector[OpenTelemetry Collector] receiving and then forwarding telemetry data to https://prometheus.io/[Prometheus] (metrics), https://github.com/grafana/tempo[Tempo] (traces) and https://github.com/grafana/loki[Loki] (logs).
14-
This data can then be visualized by https://github.com/grafana/grafana[Grafana].
13+
This Dev Service provides the https://github.com/grafana/docker-otel-lgtm[Grafana OTel-LGTM], an `all-in-one` Docker image containing an https://opentelemetry.io/docs/collector[OpenTelemetry Collector] receiving and then forwarding telemetry data to Prometheus (metrics), Tempo (traces) and Loki (logs).
14+
This data can then be visualized by https://github.com/grafana/grafana[Grafana]. The LGTM abbreviation stands for:
15+
16+
- L -> https://github.com/grafana/loki[Loki] (logs)
17+
- G -> https://github.com/grafana/grafana[Grafana] (metrics visualization)
18+
- T -> https://github.com/grafana/tempo[Tempo] (traces)
19+
- M -> https://grafana.com/oss/mimir[Mimir] (long term storage for Prometheus)
1520
1621
== Configuring your project
1722

_versions/main/guides/tls-registry-reference.adoc

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -662,6 +662,34 @@ To disable hostname verification:
662662
quarkus.tls.hostname-verification-algorithm=NONE
663663
----
664664

665+
[[client-renegotiation]]
666+
==== Preventing client renegotiation
667+
668+
Client-initiated renegotiation allows a client to request new session parameters, such as a different cipher suite, during an established TLS connection.
669+
While this feature can provide flexibility, it also introduces a potential security risk when using TLS 1.2.
670+
671+
When a client initiates a new TLS handshake, the server typically consumes significantly more CPU resources than the client. This resource asymmetry can be exploited to launch denial-of-service (DoS) attacks, overwhelming the server with renegotiation requests.
672+
673+
TLS 1.3 completely removes support for renegotiation, effectively closing this potential attack vector.
674+
675+
* To secure TLS 1.2 and earlier, set `jdk.tls.rejectClientInitiatedRenegotiation` to `true` to prevent client-initiated renegotiation.
676+
+
677+
[source]
678+
----
679+
# JVM mode:
680+
java -Djdk.tls.rejectClientInitiatedRenegotiation=true -jar ...
681+
# Native mode
682+
./application -Djdk.tls.rejectClientInitiatedRenegotiation=true
683+
----
684+
+
685+
If you are using the Quarkus-provided `Dockerfile` in JVM mode, you can disable renegotiation by adding the property to the `JAVA_OPTS_APPEND` environment variable:
686+
+
687+
[source]
688+
----
689+
ENV JAVA_OPTS_APPPEND="-Dquarkus.http.host=0.0.0.0 -Djava.util.logging.manager=org.jboss.logmanager.LogManager -Djdk.tls.rejectClientInitiatedRenegotiation=true"
690+
----
691+
692+
665693
=== Configuration reference
666694

667695
The following table lists the supported properties:

0 commit comments

Comments
 (0)