ottoka commented on a change in pull request #750:
URL: https://github.com/apache/james-project/pull/750#discussion_r754287030
##########
File path:
server/apps/distributed-app/docs/modules/ROOT/pages/configure/ssl.adoc
##########
@@ -84,6 +84,32 @@ Please note `JKS` keystore format is also supported (default
value if no keystor
</tls>
....
+
+=== Client authentication via certificates
+
+When you enable TLS, you may also configure the server to request a client
certificate for authentication:
+
+....
+<tls socketTLS="false" startTLS="true">
+ <keystore>file://conf/keystore</keystore>
+ <keystoreType>JKS</keystoreType>
+ <secret>yoursecret</secret>
+
+ <clientAuth required="true">
+ <truststore>file://conf/truststore</truststore>
+ <truststoreType>JKS</truststoreType>
+ <truststoreSecret>yoursecret</truststoreSecret>
+ </clientAuth>
+</tls>
+....
+
+With `required="true"`, the server refuses any client connections that do not
include a client certificate.
+
+With `required="false"`, the servers requests an optional client certificate,
but also accepts connections without one.
Review comment:
Fixed in latest push. I decided to keep the three states in an enum
because that's how TLS works, but removed the option for WANT from the
configuration. Now its either NEED with `<clientAuth>...</clientAuth>` or NONE
without this XML element.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
