diff --git a/content/en/docs/reference/config/networking/gateway/index.html b/content/en/docs/reference/config/networking/gateway/index.html index d352713846..cd9e903963 100644 --- a/content/en/docs/reference/config/networking/gateway/index.html +++ b/content/en/docs/reference/config/networking/gateway/index.html @@ -708,8 +708,8 @@ No caCertificates string -

REQUIRED if mode is MUTUAL. The path to a file containing -certificate authority certificates to use in verifying a presented +

REQUIRED if mode is MUTUAL or OPTIONAL_MUTUAL. The path to a file +containing certificate authority certificates to use in verifying a presented client side certificate.

@@ -864,7 +864,8 @@ the destination service from the service registry.

SIMPLE -

Secure connections with standard TLS semantics.

+

Secure connections with standard TLS semantics. In this mode +client certificate is not requested during handshake.

@@ -872,7 +873,9 @@ the destination service from the service registry.

MUTUAL

Secure connections to the downstream using mutual TLS by -presenting server certificates for authentication.

+presenting server certificates for authentication. +A client certificate will also be requested during the handshake and +at least one valid certificate is required to be sent by the client.

@@ -903,6 +906,18 @@ gateway workload identity, generated automatically by Istio for mTLS authentication. When this mode is used, all other fields in TLSOptions should be empty.

+ + + +OPTIONAL_MUTUAL + +

Similar to MUTUAL mode, except that the client certificate +is optional. Unlike SIMPLE mode, A client certificate will +still be explicitly requested during handshake, but the client +is not required to send a certificate. If a client certificate +is presented, it will be validated. ca_certificates should +be specified for validating client certificates.

+ diff --git a/content/zh/docs/reference/config/networking/gateway/index.html b/content/zh/docs/reference/config/networking/gateway/index.html index a5773e69bd..c41051f8cf 100644 --- a/content/zh/docs/reference/config/networking/gateway/index.html +++ b/content/zh/docs/reference/config/networking/gateway/index.html @@ -708,8 +708,8 @@ No caCertificates string -

REQUIRED if mode is MUTUAL. The path to a file containing -certificate authority certificates to use in verifying a presented +

REQUIRED if mode is MUTUAL or OPTIONAL_MUTUAL. The path to a file +containing certificate authority certificates to use in verifying a presented client side certificate.

@@ -864,7 +864,8 @@ the destination service from the service registry.

SIMPLE -

Secure connections with standard TLS semantics.

+

Secure connections with standard TLS semantics. In this mode +client certificate is not requested during handshake.

@@ -872,7 +873,9 @@ the destination service from the service registry.

MUTUAL

Secure connections to the downstream using mutual TLS by -presenting server certificates for authentication.

+presenting server certificates for authentication. +A client certificate will also be requested during the handshake and +at least one valid certificate is required to be sent by the client.

@@ -903,6 +906,18 @@ gateway workload identity, generated automatically by Istio for mTLS authentication. When this mode is used, all other fields in TLSOptions should be empty.

+ + + +OPTIONAL_MUTUAL + +

Similar to MUTUAL mode, except that the client certificate +is optional. Unlike SIMPLE mode, A client certificate will +still be explicitly requested during handshake, but the client +is not required to send a certificate. If a client certificate +is presented, it will be validated. ca_certificates should +be specified for validating client certificates.

+