Name |
Type |
Description |
|
Set the cache maximum TTL value in seconds. After successful resolution IP addresses are cached with their DNS response TTL, use this to set a maximum value to all responses TTL. |
|
|
Set the cache minimum TTL value in seconds. After resolution successful IP addresses are cached with their DNS response TTL, use this to set a minimum value to all responses TTL. |
|
|
Set the negative cache TTL value in seconds. After a failed hostname resolution, DNS queries won't be retried for a period of time equals to the negative TTL. This allows to reduce the response time of negative replies and reduce the amount of messages to DNS servers. |
|
|
Set the path of an alternate hosts configuration file to use instead of the one provided by the os. The default value is null, so the operating system hosts config is used. |
|
|
Set an alternate hosts configuration file to use instead of the one provided by the os. The value should contain the hosts content literaly, for instance 127.0.0.1 localhost The default value is null, so the operating system hosts config is used. |
|
|
Set the maximum number of queries when an hostname is resolved. |
|
|
Set the ndots value used when resolving using search domains, the default value is |
|
|
Set to true to enable the automatic inclusion in DNS queries of an optional record that hints the remote DNS server about how much data the resolver can read per response. |
|
|
Set the query timeout in milliseconds, i.e the amount of time after a query is considered to be failed. |
|
|
Set the DNS queries Recursion Desired flag value. |
|
|
Set to |
|
|
Set the lists of DNS search domains. When the search domain list is null, the effective search domain list will be populated using the system DNS search domains. |
|
|
Set the list of DNS server addresses, an address is the IP of the dns server, followed by an optional
colon and a port, e.g |
Name |
Type |
Description |
|
Sets the argument name of this link. |
|
|
Sets the default value of this link. |
|
|
Sets the description of the link. |
|
|
|
Sets whether or not the current link is hidden. |
|
Sets the argument index. |
|
|
Sets whether or not the argument can receive several values. Only the last argument can receive several values. |
|
|
Sets whether or not the current link is required. |
Name |
Type |
Description |
|
Set the connect timeout |
|
|
Add a CRL path |
|
|
Add a CRL value |
|
|
Add an enabled cipher suite, appended to the ordered suites. |
|
|
Sets the list of enabled SSL/TLS protocols. |
|
|
Set the idle timeout, default time unit is seconds. Zero means don't timeout. This determines if a connection will timeout and be closed if no data is received within the timeout. If you want change default time unit, use link |
|
Set the idle timeout unit. If not specified, default is seconds. |
||
- |
||
Set the key/cert options in jks format, aka Java keystore. |
||
|
Set the local interface to bind for network connections. When the local address is null, it will pick any local address, the default local address is null. |
|
|
Set to true to enabled network activity logging: Netty's pipeline is configured for logging on Netty's logger. |
|
|
Set the metrics name identifying the reported metrics, useful for grouping metrics with the same name. |
|
- |
||
Set the key/cert store options in pem format. |
||
Set the trust options in pem format |
||
Set the key/cert options in pfx format. |
||
Set the trust options in pfx format |
||
Set proxy options for connections via CONNECT proxy (e.g. Squid) or a SOCKS proxy. |
||
|
Set the TCP receive buffer size |
|
|
Set the value of reuse address |
|
|
Set the value of reuse port. This is only supported by native transports. |
|
|
Set the TCP send buffer size |
|
|
Set whether SO_linger keep alive is enabled |
|
|
Set whether SSL/TLS is enabled |
|
|
Enable the |
|
|
Enable the |
|
|
Set whether TCP keep alive is enabled |
|
|
Set whether TCP no delay is enabled |
|
|
Enable the |
|
|
Set the value of traffic class |
|
|
Set whether all server certificates should be trusted |
|
Set the trust options in jks format, aka Java truststore |
||
|
Set the ALPN usage. |
|
|
Set whether Netty pooled buffers are enabled |
Name |
Type |
Description |
|
Whether move should be performed as an atomic filesystem operation. Defaults to |
|
|
Whether the file attributes should be copied. Defaults to |
|
|
Whether symbolic links should not be followed during copy or move operations. Defaults to |
|
|
Whether an existing file, empty directory, or link should be replaced. Defaults to |
Name |
Type |
Description |
|
Set if the socket can send or receive broadcast packets |
|
|
Set if IP v6 should be used |
|
|
Set to true to enabled network activity logging: Netty's pipeline is configured for logging on Netty's logger. |
|
|
Set if loopback mode is disabled |
|
|
Set the multicast network interface address |
|
|
Set the multicast ttl value |
|
|
Set the TCP receive buffer size |
|
|
Set the value of reuse address |
|
|
Set the value of reuse port. This is only supported by native transports. |
|
|
Set the TCP send buffer size |
|
|
Set the value of traffic class |
Delivery options allow to configure delivery timeout and message codec name, and to provide any headers that you wish to send with the message.
Name |
Type |
Description |
|
Set the codec name. |
|
|
Add a message header. Message headers can be sent with any message and will be accessible with link at the recipient. |
|
|
Whether a message should be delivered to local consumers only. Defaults to This option is effective in clustered mode only and does not apply to reply messages. |
|
|
Set the send timeout. |
Name |
Type |
Description |
|
Set the JSON configuration that will be passed to the verticle(s) when it's deployed |
|
|
Set any extra classpath to be used when deploying the verticle. Ignored if no isolation group is set. |
|
|
Set whether the verticle(s) will be deployed as HA. |
|
|
Set the number of instances that should be deployed. |
|
|
Set the isolated class names. |
|
|
Set the isolation group that will be used when deploying the verticle(s) |
|
|
Sets the value of max worker execute time, in link. The default value of link is |
|
Set the time unit of |
||
|
Set whether the verticle(s) should be deployed as a multi-threaded worker verticle. WARNING: Multi-threaded worker verticles are a deprecated feature. Most applications will have no need for them. Because of the concurrency in these verticles you have to be very careful to keep the verticle in a consistent state using standard Java techniques for multi-threaded programming.
You can read the documentation that explains how you can replace this feature by the usage of custom worker
pools or |
|
|
Set whether the verticle(s) should be deployed as a worker verticle |
|
|
Set the worker pool name to use for this verticle. When no name is set, the Vert.x worker pool will be used, when a name is set, the verticle will use a named worker pool. |
|
|
Set the maximum number of worker threads to be used by the Vert.x instance. |
Name |
Type |
Description |
|
Set the host name to be used by this client in requests. |
|
|
Set to true to enabled network activity logging: Netty's pipeline is configured for logging on Netty's logger. |
|
|
Set the port to be used by this client in requests. |
|
|
Set the query timeout in milliseconds, i.e the amount of time after a query is considered to be failed. |
|
|
Set whether or not recursion is desired |
Name |
Type |
Description |
|
Set the accept back log. |
|
Set whether client auth is required |
||
|
Set the value of cluster ping interval, in ms. |
|
|
Set the value of cluster ping reply interval, in ms. |
|
|
Set the public facing hostname to be used for clustering. Sometimes, e.g. when running on certain clouds, the local address the server listens on for clustering is not the same address that other nodes connect to it at, as the OS / cloud infrastructure does some kind of proxying. If this is the case you can specify a public hostname which is different from the hostname the server listens at. The default value is null which means use the same as the cluster hostname. |
|
|
See link for an explanation. |
|
|
Sets whether or not the event bus is clustered. |
|
|
Sets the connect timeout |
|
|
Add a CRL path |
|
|
Add a CRL value |
|
|
Add an enabled cipher suite, appended to the ordered suites. |
|
|
Sets the list of enabled SSL/TLS protocols. |
|
|
Sets the host. |
|
|
Set the idle timeout, default time unit is seconds. Zero means don't timeout. This determines if a connection will timeout and be closed if no data is received within the timeout. If you want change default time unit, use link |
|
Set the idle timeout unit. If not specified, default is seconds. |
||
- |
||
Set the key/cert options in jks format, aka Java keystore. |
||
|
Set to true to enabled network activity logging: Netty's pipeline is configured for logging on Netty's logger. |
|
- |
||
Set the key/cert store options in pem format. |
||
Set the trust options in pem format |
||
Set the key/cert options in pfx format. |
||
Set the trust options in pfx format |
||
|
Sets the port. |
|
|
Set the TCP receive buffer size |
|
|
Sets the value of reconnect attempts. |
|
|
Set the reconnect interval. |
|
|
Set the value of reuse address |
|
|
Set the value of reuse port. This is only supported by native transports. |
|
|
Set the TCP send buffer size |
|
|
Set whether SO_linger keep alive is enabled |
|
|
Set whether SSL/TLS is enabled |
|
|
Enable the |
|
|
Enable the |
|
|
Set whether TCP keep alive is enabled |
|
|
Set whether TCP no delay is enabled |
|
|
Enable the |
|
|
Set the value of traffic class |
|
|
Set whether all server certificates should be trusted. |
|
Set the trust options in jks format, aka Java truststore |
||
|
Set the ALPN usage. |
|
|
Set whether Netty pooled buffers are enabled |
Name |
Type |
Description |
|
When vert.x cannot find the file on the filesystem it tries to resolve the
file from the class path when this is set to |
|
|
Set to |
The settings expose the parameters defined by the HTTP/2 specification, as well as extra settings for protocol extensions.
Name |
Type |
Description |
|
Set HTTP/2 setting. |
|
|
Set the HTTP/2 setting |
|
|
Set the HTTP/2 setting |
|
|
Set the HTTP/2 setting |
|
|
Set the HTTP/2 setting |
|
|
Set the HTTP/2 setting |
Name |
Type |
Description |
|
Set the list of protocol versions to provide to the server during the Application-Layer Protocol Negotiation. When the list is empty, the client provides a best effort list according to link:
|
|
|
Set the connect timeout |
|
|
Add a CRL path |
|
|
Add a CRL value |
|
|
set to |
|
|
Set the default host name to be used by this client in requests if none is provided when making the request. |
|
|
Set the default port to be used by this client in requests if none is provided when making the request. |
|
|
Add an enabled cipher suite, appended to the ordered suites. |
|
|
Sets the list of enabled SSL/TLS protocols. |
|
|
By default, the server name is only sent for Fully Qualified Domain Name (FQDN), setting
this property to |
|
|
Set to |
|
|
Set the default HTTP/2 connection window size. It overrides the initial window size set by link, so the connection window size is greater than for its streams, in order the data throughput. A value of-1 reuses the initial window size setting. |
|
|
Set the keep alive timeout for HTTP/2 connections, in seconds. This value determines how long a connection remains unused in the pool before being evicted and closed. |
|
|
Set the maximum pool size for HTTP/2 connections |
|
|
Set a client limit of the number concurrent streams for each HTTP/2 connection, this limits the number of streams the client can create for a connection. The effective number of streams for a connection is the min of this value and the server's initial settings. Setting the value to-1 means to use the value sent by the server's initial settings.
-1 is the default value. |
|
|
Set the idle timeout, default time unit is seconds. Zero means don't timeout. This determines if a connection will timeout and be closed if no data is received within the timeout. If you want change default time unit, use link |
|
Set the idle timeout unit. If not specified, default is seconds. |
||
Set the HTTP/2 connection settings immediately sent by to the server when the client connects. |
||
- |
||
|
Set whether keep alive is enabled on the client |
|
|
Set the keep alive timeout for HTTP/1.x, in seconds. This value determines how long a connection remains unused in the pool before being evicted and closed. |
|
Set the key/cert options in jks format, aka Java keystore. |
||
|
Set the local interface to bind for network connections. When the local address is null, it will pick any local address, the default local address is null. |
|
|
Set to true to enabled network activity logging: Netty's pipeline is configured for logging on Netty's logger. |
|
|
Set the maximum HTTP chunk size |
|
|
Set the maximum length of all headers for HTTP/1.x . |
|
|
Set the maximum length of the initial line for HTTP/1.x (e.g. |
|
|
Set the maximum pool size for connections |
|
|
Set to |
|
|
Set the maximum requests allowed in the wait queue, any requests beyond the max size will result in a ConnectionPoolTooBusyException. If the value is set to a negative number then the queue will be unbounded. |
|
|
Set the max websocket frame size |
|
|
Set the max websocket message size |
|
|
Set the metrics name identifying the reported metrics, useful for grouping metrics with the same name. |
|
- |
||
Set the key/cert store options in pem format. |
||
Set the trust options in pem format |
||
Set the key/cert options in pfx format. |
||
Set the trust options in pfx format |
||
|
Set whether pipe-lining is enabled on the client |
|
|
Set the limit of pending requests a pipe-lined HTTP/1 connection can send. |
|
|
Set the connection pool cleaner period in milli seconds, a non positive value disables expiration checks and connections will remain in the pool until they are closed. |
|
Set the protocol version. |
||
Set proxy options for connections via CONNECT proxy (e.g. Squid) or a SOCKS proxy. |
||
|
Set the TCP receive buffer size |
|
|
Set the value of reuse address |
|
|
Set the value of reuse port. This is only supported by native transports. |
|
|
Set the TCP send buffer size |
|
|
Set true when the client wants to skip frame masking. You may want to set it true on server by server websocket communication: In this case you are by passing RFC6455 protocol. It's false as default. |
|
|
Set whether SO_linger keep alive is enabled |
|
|
Set whether SSL/TLS is enabled |
|
|
Enable the |
|
|
Enable the |
|
|
Set whether TCP keep alive is enabled |
|
|
Set whether TCP no delay is enabled |
|
|
Enable the |
|
|
Set the value of traffic class |
|
|
Set whether all server certificates should be trusted |
|
Set the trust options in jks format, aka Java truststore |
||
|
Set whether compression is enabled |
|
|
Set option to offer per frame WebSocket compression. |
|
|
Set option to offer per message WebSocket compression. |
|
|
Set the ALPN usage. |
|
|
Set whether Netty pooled buffers are enabled |
|
|
Set whether hostname verification is enabled |
|
|
Set the WebSocket compression allow client no context option. |
|
|
Set WebSocket compression level |
|
|
Set the WebSocket compression server no context option |
Name |
Type |
Description |
|
Set the accept back log |
|
|
Set true when the server accepts unmasked frame. As default Server doesn't accept unmasked frame, you can bypass this behaviour (RFC 6455) setting true It's set to false as default. |
|
|
Set the list of protocol versions to provide to the server during the Application-Layer Protocol Negotiatiation. |
|
Set whether client auth is required |
||
|
Set whether client auth is required |
|
|
This method allows to set the compression level to be used in http1.x/2 response bodies
when compression support is turned on (@see setCompressionSupported) and the client advertises
to support default value is : 6 (Netty legacy) The compression level determines how much the data is compressed on a scale from 1 to 9, where '9' is trying to achieve the maximum compression ratio while '1' instead is giving priority to speed instead of compression ratio using some algorithm optimizations and skipping pedantic loops that usually gives just little improvements While one can think that best value is always the maximum compression ratio, there's a trade-off to consider: the most compressed level requires the most computational work to compress/decompress data, e.g. more dictionary lookups and loops. E.g. you have it set fairly high on a high-volume website, you may experience performance degradation and latency on resource serving due to CPU overload, and, however - as the computational work is required also client side while decompressing - setting an higher compression level can result in an overall higher page load time especially nowadays when many clients are handled mobile devices with a low CPU profile. see also: http://www.gzip.org/algorithm.txt |
|
|
Set whether the server should support gzip/deflate compression (serving compressed responses to clients advertising support for them with Accept-Encoding header) |
|
|
Add a CRL path |
|
|
Add a CRL value |
|
|
Set the initial buffer size for the HTTP decoder |
|
|
Set whether the server supports decompression |
|
|
Add an enabled cipher suite, appended to the ordered suites. |
|
|
Sets the list of enabled SSL/TLS protocols. |
|
|
Set whether 100 Continue should be handled automatically |
|
|
Set the host |
|
|
Set the default HTTP/2 connection window size. It overrides the initial window size set by link, so the connection window size is greater than for its streams, in order the data throughput. A value of-1 reuses the initial window size setting. |
|
|
Set the idle timeout, default time unit is seconds. Zero means don't timeout. This determines if a connection will timeout and be closed if no data is received within the timeout. If you want change default time unit, use link |
|
Set the idle timeout unit. If not specified, default is seconds. |
||
Set the HTTP/2 connection settings immediatly sent by the server when a client connects. |
||
- |
||
Set the key/cert options in jks format, aka Java keystore. |
||
|
Set to true to enabled network activity logging: Netty's pipeline is configured for logging on Netty's logger. |
|
|
Set the maximum HTTP chunk size that link will receive |
|
|
Set the maximum length of all headers for HTTP/1.x . |
|
|
Set the maximum length of the initial line for HTTP/1.x (e.g. |
|
|
Set the maximum websocket frames size |
|
|
Set the maximum websocket message size |
|
- |
||
Set the key/cert store options in pem format. |
||
Set the trust options in pem format |
||
|
Enable or disable support for WebSocket Defalte Frame compression |
|
|
Enable or disable support for WebSocket Permessage Deflate compression |
|
Set the key/cert options in pfx format. |
||
Set the trust options in pfx format |
||
|
Set the port |
|
|
Set the TCP receive buffer size |
|
|
Set the value of reuse address |
|
|
Set the value of reuse port. This is only supported by native transports. |
|
|
Set the TCP send buffer size |
|
|
Set whether the server supports Server Name Indiciation |
|
|
Set whether SO_linger keep alive is enabled |
|
|
Set whether SSL/TLS is enabled |
|
|
Enable the |
|
|
Enable the |
|
|
Set whether TCP keep alive is enabled |
|
|
Set whether TCP no delay is enabled |
|
|
Enable the |
|
|
Set the value of traffic class |
|
Set the trust options in jks format, aka Java truststore |
||
|
Set the ALPN usage. |
|
|
Set whether Netty pooled buffers are enabled |
|
|
Set the WebSocket Allow Server No Context option |
|
|
Set the WebSocket compression level |
|
|
Set the WebSocket Preferred Client No Context setting |
|
|
Set the websocket subprotocols supported by the server. |
Name |
Type |
Description |
When used as a key store, it should point to a store containing a private key and its certificate. When used as a trust store, it should point to a store containing a list of trusted certificates.
The store can either be loaded by Vert.x from the filesystem:
HttpServerOptions options = HttpServerOptions.httpServerOptions();
options.setKeyStore(new JKSOptions().setPath("/mykeystore.jks").setPassword("foo"));
Or directly provided as a buffer:
Buffer store = vertx.fileSystem().readFileSync("/mykeystore.jks");
options.setKeyStore(new JKSOptions().setValue(store).setPassword("foo"));
Name |
Type |
Description |
|
Set the password for the key store |
|
|
Set the path to the key store |
|
|
Set the key store as a buffer |
Name |
Type |
Description |
|
Set the connect timeout |
|
|
Add a CRL path |
|
|
Add a CRL value |
|
|
Add an enabled cipher suite, appended to the ordered suites. |
|
|
Sets the list of enabled SSL/TLS protocols. |
|
|
Set the hostname verification algorithm interval To disable hostname verification, set hostnameVerificationAlgorithm to an empty String |
|
|
Set the idle timeout, default time unit is seconds. Zero means don't timeout. This determines if a connection will timeout and be closed if no data is received within the timeout. If you want change default time unit, use link |
|
Set the idle timeout unit. If not specified, default is seconds. |
||
- |
||
Set the key/cert options in jks format, aka Java keystore. |
||
|
Set the local interface to bind for network connections. When the local address is null, it will pick any local address, the default local address is null. |
|
|
Set to true to enabled network activity logging: Netty's pipeline is configured for logging on Netty's logger. |
|
|
Set the metrics name identifying the reported metrics, useful for grouping metrics with the same name. |
|
- |
||
Set the key/cert store options in pem format. |
||
Set the trust options in pem format |
||
Set the key/cert options in pfx format. |
||
Set the trust options in pfx format |
||
Set proxy options for connections via CONNECT proxy (e.g. Squid) or a SOCKS proxy. |
||
|
Set the TCP receive buffer size |
|
|
Set the value of reconnect attempts |
|
|
Set the reconnect interval |
|
|
Set the value of reuse address |
|
|
Set the value of reuse port. This is only supported by native transports. |
|
|
Set the TCP send buffer size |
|
|
Set whether SO_linger keep alive is enabled |
|
|
Set whether SSL/TLS is enabled |
|
|
Enable the |
|
|
Enable the |
|
|
Set whether TCP keep alive is enabled |
|
|
Set whether TCP no delay is enabled |
|
|
Enable the |
|
|
Set the value of traffic class |
|
|
Set whether all server certificates should be trusted |
|
Set the trust options in jks format, aka Java truststore |
||
|
Set the ALPN usage. |
|
|
Set whether Netty pooled buffers are enabled |
Name |
Type |
Description |
|
Set the accept back log |
|
Set whether client auth is required |
||
|
Set whether client auth is required |
|
|
Add a CRL path |
|
|
Add a CRL value |
|
|
Add an enabled cipher suite, appended to the ordered suites. |
|
|
Sets the list of enabled SSL/TLS protocols. |
|
|
Set the host |
|
|
Set the idle timeout, default time unit is seconds. Zero means don't timeout. This determines if a connection will timeout and be closed if no data is received within the timeout. If you want change default time unit, use link |
|
Set the idle timeout unit. If not specified, default is seconds. |
||
- |
||
Set the key/cert options in jks format, aka Java keystore. |
||
|
Set to true to enabled network activity logging: Netty's pipeline is configured for logging on Netty's logger. |
|
- |
||
Set the key/cert store options in pem format. |
||
Set the trust options in pem format |
||
Set the key/cert options in pfx format. |
||
Set the trust options in pfx format |
||
|
Set the port |
|
|
Set the TCP receive buffer size |
|
|
Set the value of reuse address |
|
|
Set the value of reuse port. This is only supported by native transports. |
|
|
Set the TCP send buffer size |
|
|
Set whether the server supports Server Name Indiciation |
|
|
Set whether SO_linger keep alive is enabled |
|
|
Set whether SSL/TLS is enabled |
|
|
Enable the |
|
|
Enable the |
|
|
Set whether TCP keep alive is enabled |
|
|
Set whether TCP no delay is enabled |
|
|
Enable the |
|
|
Set the value of traffic class |
|
Set the trust options in jks format, aka Java truststore |
||
|
Set the ALPN usage. |
|
|
Set whether Netty pooled buffers are enabled |
Name |
Type |
Description |
|
Set to true to enabled network activity logging: Netty's pipeline is configured for logging on Netty's logger. |
|
|
Set the TCP receive buffer size |
|
|
Set the value of reuse address |
|
|
Set the value of reuse port. This is only supported by native transports. |
|
|
Set the TCP send buffer size |
|
|
Set the value of traffic class |
Name |
Type |
Description |
|
Whether the file should be opened in append mode. Defaults to |
|
|
Set whether the file should be created if it does not already exist. |
|
|
Set whether the file should be created and fail if it does exist already. |
|
|
Set whether the file should be deleted when it's closed, or the JVM is shutdown. |
|
|
Set whether every write to the file's content ill be written synchronously to the underlying hardware. |
|
|
Set the permissions string |
|
|
Set whether the file is to be opened for reading |
|
|
Set whether a hint should be provided that the file to created is sparse |
|
|
Set whether every write to the file's content and meta-data will be written synchronously to the underlying hardware. |
|
|
Set whether the file should be truncated to zero length on opening if it exists and is opened for write |
|
|
Set whether the file is to be opened for writing |
Name |
Type |
Description |
|
Sets te arg name for this option. |
|
|
Sets the list of values accepted by this option. If the value set by the user does not match once of these values, a link exception is thrown. |
|
|
Sets the default value of this option |
|
|
Sets te description of this option. |
|
|
Configures the current link to be a flag. It will be evaluated to |
|
|
Sets whether or not this option is a "help" option |
|
|
|
Sets whether or not this option should be hidden |
|
Sets the long name of this option. |
|
|
Sets whether or not this option can receive several values. |
|
|
||
|
Sets whether or not this option is mandatory. |
|
|
Sets the short name of this option. |
|
|
Sets whether or not this option can receive a value. |
A key file must contain a non encrypted private key in PKCS8 format wrapped in a PEM block, for example:
-----BEGIN PRIVATE KEY----- MIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQDV6zPk5WqLwS0a ... K5xBhtm1AhdnZjx5KfW3BecE -----END PRIVATE KEY-----
Or contain a non encrypted private key in PKCS1 format wrapped in a PEM block, for example:
-----BEGIN RSA PRIVATE KEY----- MIIEowIBAAKCAQEAlO4gbHeFb/fmbUF/tOJfNPJumJUEqgzAzx8MBXv9Acyw9IRa ... zJ14Yd+t2fsLYVs2H0gxaA4DW6neCzgY3eKpSU0EBHUCFSXp/1+/ -----END RSA PRIVATE KEY-----
A certificate file must contain an X.509 certificate wrapped in a PEM block, for example:
-----BEGIN CERTIFICATE----- MIIDezCCAmOgAwIBAgIEZOI/3TANBgkqhkiG9w0BAQsFADBuMRAwDgYDVQQGEwdV ... +tmLSvYS39O2nqIzzAUfztkYnUlZmB0l/mKkVqbGJA== -----END CERTIFICATE-----Keys and certificates can either be loaded by Vert.x from the filesystem:
HttpServerOptions options = new HttpServerOptions();
options.setPemKeyCertOptions(new PemKeyCertOptions().setKeyPath("/mykey.pem").setCertPath("/mycert.pem"));
Or directly provided as a buffer:
Buffer key = vertx.fileSystem().readFileSync("/mykey.pem");
Buffer cert = vertx.fileSystem().readFileSync("/mycert.pem");
options.setPemKeyCertOptions(new PemKeyCertOptions().setKeyValue(key).setCertValue(cert));
Several key/certificate pairs can be used:
HttpServerOptions options = new HttpServerOptions();
options.setPemKeyCertOptions(new PemKeyCertOptions()
.addKeyPath("/mykey1.pem").addCertPath("/mycert1.pem")
.addKeyPath("/mykey2.pem").addCertPath("/mycert2.pem"));
Name |
Type |
Description |
|
Set the path of the first certificate, replacing the previous certificates paths |
|
|
Set all the paths to the certificates files |
|
|
Set the first certificate as a buffer, replacing the previous certificates buffers |
|
|
Set all the certificates as a list of buffer |
|
|
Set the path of the first key file, replacing the keys paths |
|
|
Set all the paths to the keys files |
|
|
Set the first key a a buffer, replacing the previous keys buffers |
|
|
Set all the keys as a list of buffer |
Validating certificates must contain X.509 certificates wrapped in a PEM block:
-----BEGIN CERTIFICATE----- MIIDezCCAmOgAwIBAgIEVmLkwTANBgkqhkiG9w0BAQsFADBuMRAwDgYDVQQGEwdV ... z5+DuODBJUQst141Jmgq8bS543IU/5apcKQeGNxEyQ== -----END CERTIFICATE-----The certificates can either be loaded by Vert.x from the filesystem:
HttpServerOptions options = new HttpServerOptions();
options.setPemTrustOptions(new PemTrustOptions().addCertPath("/cert.pem"));
Or directly provided as a buffer:
Buffer cert = vertx.fileSystem().readFileSync("/cert.pem");
HttpServerOptions options = new HttpServerOptions();
options.setPemTrustOptions(new PemTrustOptions().addCertValue(cert));
Name |
Type |
Description |
|
Add a certificate path |
|
|
Add a certificate value |
When used as a key store, it should point to a store containing a private key and its certificate. When used as a trust store, it should point to a store containing a list of accepted certificates.
The store can either be loaded by Vert.x from the filesystem:
HttpServerOptions options = new HttpServerOptions();
options.setPfxKeyCertOptions(new PfxOptions().setPath("/mykeystore.p12").setPassword("foo"));
Or directly provided as a buffer:
Buffer store = vertx.fileSystem().readFileSync("/mykeystore.p12");
options.setPfxKeyCertOptions(new PfxOptions().setValue(store).setPassword("foo"));
Name |
Type |
Description |
|
Set the password |
|
|
Set the path |
|
|
Set the store as a buffer |
Name |
Type |
Description |
|
Set proxy host. |
|
|
Set proxy password. |
|
|
Set proxy port. |
|
Set proxy type. ProxyType can be HTTP, SOCKS4 and SOCKS5 |
||
|
Set proxy username. |
Name |
Type |
Description |
|
Set the host name to be used by the client request. |
|
|
Set the port to be used by the client request. |
|
|
Set whether SSL/TLS is enabled |
|
|
Set the request relative URI |
Name |
Type |
Description |
|
Add a CRL path |
|
|
Add a CRL value |
|
|
Add an enabled cipher suite, appended to the ordered suites. |
|
|
Sets the list of enabled SSL/TLS protocols. |
|
|
Set the idle timeout, default time unit is seconds. Zero means don't timeout. This determines if a connection will timeout and be closed if no data is received within the timeout. If you want change default time unit, use link |
|
Set the idle timeout unit. If not specified, default is seconds. |
||
- |
||
Set the key/cert options in jks format, aka Java keystore. |
||
|
Set to true to enabled network activity logging: Netty's pipeline is configured for logging on Netty's logger. |
|
- |
||
Set the key/cert store options in pem format. |
||
Set the trust options in pem format |
||
Set the key/cert options in pfx format. |
||
Set the trust options in pfx format |
||
|
Set the TCP receive buffer size |
|
|
Set the value of reuse address |
|
|
Set the value of reuse port. This is only supported by native transports. |
|
|
Set the TCP send buffer size |
|
|
Set whether SO_linger keep alive is enabled |
|
|
Set whether SSL/TLS is enabled |
|
|
Enable the |
|
|
Enable the |
|
|
Set whether TCP keep alive is enabled |
|
|
Set whether TCP no delay is enabled |
|
|
Enable the |
|
|
Set the value of traffic class |
|
Set the trust options in jks format, aka Java truststore |
||
|
Set the ALPN usage. |
|
|
Set whether Netty pooled buffers are enabled |
Name |
Type |
Description |
Sets the address resolver configuration to configure resolving DNS servers, cache TTL, etc... |
||
|
Sets the value of blocked thread check period, in link. The default value of link is |
|
Set the time unit of |
||
|
Set the hostname to be used for clustering. |
|
|
Set the value of cluster ping interval, in ms. |
|
|
Set the value of cluster ping reply interval, in ms. |
|
|
Set the port to be used for clustering. |
|
|
Set the public facing hostname to be used for clustering. Sometimes, e.g. when running on certain clouds, the local address the server listens on for clustering is not the same address that other nodes connect to it at, as the OS / cloud infrastructure does some kind of proxying. If this is the case you can specify a public hostname which is different from the hostname the server listens at. The default value is null which means use the same as the cluster hostname. |
|
|
See link for an explanation. |
|
|
Set whether or not the Vert.x instance will be clustered. |
|
Sets the event bus configuration to configure the host, port, ssl... |
||
|
Set the number of event loop threads to be used by the Vert.x instance. |
|
|
Set whether the Vert.x file resolver uses caching for classpath resources. Deprecated. Use FileSystemOptions instead. |
|
Set the file system options |
||
|
Set whether HA will be enabled on the Vert.x instance. |
|
|
Set the HA group to be used when HA is enabled. |
|
|
Set the value of internal blocking pool size |
|
|
Sets the value of max event loop execute time, in link. The default value of linkis |
|
Set the time unit of |
||
|
Sets the value of max worker execute time, in link. The default value of link is |
|
Set the time unit of |
||
Set the metrics options |
||
|
Set wether to prefer the native transport to the JDK transport. |
|
|
Set the quorum size to be used when HA is enabled. |
|
|
Set the threshold value above this, the blocked warning contains a stack trace. in link. The default value of link is |
|
Set the time unit of |
||
|
Set the maximum number of worker threads to be used by the Vert.x instance. |