| =pod |
| {- OpenSSL::safe::output_do_not_edit_headers(); -} |
| |
| =head1 NAME |
| |
| openssl-s_server - SSL/TLS server program |
| |
| =head1 SYNOPSIS |
| |
| B<openssl> B<s_server> |
| [B<-help>] |
| [B<-port> I<+int>] |
| [B<-accept> I<val>] |
| [B<-unix> I<val>] |
| [B<-4>] |
| [B<-6>] |
| [B<-unlink>] |
| [B<-context> I<val>] |
| [B<-verify> I<int>] |
| [B<-Verify> I<int>] |
| [B<-cert> I<infile>] |
| [B<-naccept> I<+int>] |
| [B<-serverinfo> I<val>] |
| [B<-certform> B<DER>|B<PEM>] |
| [B<-key> I<infile>] |
| [B<-keyform> B<DER>|B<PEM>] |
| [B<-pass> I<val>] |
| [B<-dcert> I<infile>] |
| [B<-dcertform> B<DER>|B<PEM>] |
| [B<-dkey> I<infile>] |
| [B<-dkeyform> B<DER>|B<PEM>] |
| [B<-dpass> I<val>] |
| [B<-nbio_test>] |
| [B<-crlf>] |
| [B<-debug>] |
| [B<-msg>] |
| [B<-msgfile> I<outfile>] |
| [B<-state>] |
| [B<-nocert>] |
| [B<-quiet>] |
| [B<-no_resume_ephemeral>] |
| [B<-www>] |
| [B<-WWW>] |
| [B<-servername>] |
| [B<-servername_fatal>] |
| [B<-cert2> I<infile>] |
| [B<-key2> I<infile>] |
| [B<-tlsextdebug>] |
| [B<-HTTP>] |
| [B<-id_prefix> I<val>] |
| [B<-keymatexport> I<val>] |
| [B<-keymatexportlen> I<+int>] |
| [B<-CRL> I<infile>] |
| [B<-crl_download>] |
| [B<-cert_chain> I<infile>] |
| [B<-dcert_chain> I<infile>] |
| [B<-chainCApath> I<dir>] |
| [B<-verifyCApath> I<dir>] |
| [B<-chainCAstore> I<uri>] |
| [B<-verifyCAstore> I<uri>] |
| [B<-no_cache>] |
| [B<-ext_cache>] |
| [B<-verify_return_error>] |
| [B<-verify_quiet>] |
| [B<-build_chain>] |
| [B<-chainCAfile> I<infile>] |
| [B<-verifyCAfile> I<infile>] |
| [B<-ign_eof>] |
| [B<-no_ign_eof>] |
| [B<-status>] |
| [B<-status_verbose>] |
| [B<-status_timeout> I<int>] |
| [B<-status_url> I<val>] |
| [B<-status_file> I<infile>] |
| [B<-trace>] |
| [B<-security_debug>] |
| [B<-security_debug_verbose>] |
| [B<-brief>] |
| [B<-rev>] |
| [B<-async>] |
| [B<-ssl_config> I<val>] |
| [B<-max_send_frag> I<+int>] |
| [B<-split_send_frag> I<+int>] |
| [B<-max_pipelines> I<+int>] |
| [B<-read_buf> I<+int>] |
| [B<-no_ssl3>] |
| [B<-no_tls1>] |
| [B<-no_tls1_1>] |
| [B<-no_tls1_2>] |
| [B<-no_tls1_3>] |
| [B<-bugs>] |
| [B<-no_comp>] |
| [B<-comp>] |
| [B<-no_ticket>] |
| [B<-num_tickets>] |
| [B<-serverpref>] |
| [B<-legacy_renegotiation>] |
| [B<-no_renegotiation>] |
| [B<-legacy_server_connect>] |
| [B<-no_resumption_on_reneg>] |
| [B<-no_legacy_server_connect>] |
| [B<-allow_no_dhe_kex>] |
| [B<-prioritize_chacha>] |
| [B<-strict>] |
| [B<-sigalgs> I<val>] |
| [B<-client_sigalgs> I<val>] |
| [B<-groups> I<val>] |
| [B<-curves> I<val>] |
| [B<-named_curve> I<val>] |
| [B<-cipher> I<val>] |
| [B<-ciphersuites> I<val>] |
| [B<-dhparam> I<infile>] |
| [B<-record_padding> I<val>] |
| [B<-debug_broken_protocol>] |
| [B<-policy> I<val>] |
| [B<-purpose> I<val>] |
| [B<-verify_name> I<val>] |
| [B<-verify_depth> I<int>] |
| [B<-auth_level> I<int>] |
| [B<-attime> I<intmax>] |
| [B<-verify_hostname> I<val>] |
| [B<-verify_email> I<val>] |
| [B<-verify_ip>] |
| [B<-ignore_critical>] |
| [B<-issuer_checks>] |
| [B<-crl_check>] |
| [B<-crl_check_all>] |
| [B<-policy_check>] |
| [B<-explicit_policy>] |
| [B<-inhibit_any>] |
| [B<-inhibit_map>] |
| [B<-x509_strict>] |
| [B<-extended_crl>] |
| [B<-use_deltas>] |
| [B<-policy_print>] |
| [B<-check_ss_sig>] |
| [B<-trusted_first>] |
| [B<-suiteB_128_only>] |
| [B<-suiteB_128>] |
| [B<-suiteB_192>] |
| [B<-partial_chain>] |
| [B<-no_alt_chains>] |
| [B<-no_check_time>] |
| [B<-allow_proxy_certs>] |
| [B<-nbio>] |
| [B<-psk_identity> I<val>] |
| [B<-psk_hint> I<val>] |
| [B<-psk> I<val>] |
| [B<-psk_session> I<file>] |
| [B<-srpvfile> I<infile>] |
| [B<-srpuserseed> I<val>] |
| [B<-ssl3>] |
| [B<-tls1>] |
| [B<-tls1_1>] |
| [B<-tls1_2>] |
| [B<-tls1_3>] |
| [B<-dtls>] |
| [B<-timeout>] |
| [B<-mtu> I<+int>] |
| [B<-listen>] |
| [B<-dtls1>] |
| [B<-dtls1_2>] |
| [B<-sctp>] |
| [B<-sctp_label_bug>] |
| [B<-no_dhe>] |
| [B<-nextprotoneg> I<val>] |
| [B<-use_srtp> I<val>] |
| [B<-alpn> I<val>] |
| [B<-engine> I<val>] |
| [B<-keylogfile> I<outfile>] |
| [B<-max_early_data> I<int>] |
| [B<-early_data>] |
| [B<-anti_replay>] |
| [B<-no_anti_replay>] |
| [B<-http_server_binmode>] |
| {- $OpenSSL::safe::opt_name_synopsis -} |
| {- $OpenSSL::safe::opt_x_synopsis -} |
| {- $OpenSSL::safe::opt_trust_synopsis -} |
| {- $OpenSSL::safe::opt_r_synopsis -} |
| |
| =for openssl ifdef unix 4 6 unlink no_dhe nextprotoneg use_srtp engine |
| |
| =for openssl ifdef status status_verbose status_timeout status_url status_file |
| |
| =for openssl ifdef psk_hint srpvfile srpuserseed sctp sctp_label_bug |
| |
| =for openssl ifdef sctp sctp_label_bug trace mtu timeout listen |
| |
| =for openssl ifdef ssl3 tls1 tls1_1 tls1_2 tls1_3 dtls mtu dtls1 dtls1_2 |
| |
| =head1 DESCRIPTION |
| |
| This command implements a generic SSL/TLS server which |
| listens for connections on a given port using SSL/TLS. |
| |
| =head1 OPTIONS |
| |
| In addition to the options below, this command also supports |
| the common and server only options documented |
| L<SSL_CONF_cmd(3)/Supported Command Line Commands> |
| |
| =over 4 |
| |
| =item B<-help> |
| |
| Print out a usage message. |
| |
| =item B<-port> I<+int> |
| |
| The TCP port to listen on for connections. If not specified 4433 is used. |
| |
| =item B<-accept> I<val> |
| |
| The optional TCP host and port to listen on for connections. If not specified, *:4433 is used. |
| |
| =item B<-unix> I<val> |
| |
| Unix domain socket to accept on. |
| |
| =item B<-4> |
| |
| Use IPv4 only. |
| |
| =item B<-6> |
| |
| Use IPv6 only. |
| |
| =item B<-unlink> |
| |
| For -unix, unlink any existing socket first. |
| |
| =item B<-context> I<val> |
| |
| Sets the SSL context id. It can be given any string value. If this option |
| is not present a default value will be used. |
| |
| =item B<-verify> I<int>, B<-Verify> I<int> |
| |
| The verify depth to use. This specifies the maximum length of the |
| client certificate chain and makes the server request a certificate from |
| the client. With the B<-verify> option a certificate is requested but the |
| client does not have to send one, with the B<-Verify> option the client |
| must supply a certificate or an error occurs. |
| |
| If the cipher suite cannot request a client certificate (for example an |
| anonymous cipher suite or PSK) this option has no effect. |
| |
| =item B<-cert> I<infile> |
| |
| The certificate to use, most servers cipher suites require the use of a |
| certificate and some require a certificate with a certain public key type: |
| for example the DSS cipher suites require a certificate containing a DSS |
| (DSA) key. If not specified then the filename F<server.pem> will be used. |
| |
| =item B<-cert_chain> |
| |
| A file containing trusted certificates to use when attempting to build the |
| client/server certificate chain related to the certificate specified via the |
| B<-cert> option. |
| |
| =item B<-build_chain> |
| |
| Specify whether the application should build the certificate chain to be |
| provided to the client. |
| |
| =item B<-naccept> I<+int> |
| |
| The server will exit after receiving the specified number of connections, |
| default unlimited. |
| |
| =item B<-serverinfo> I<val> |
| |
| A file containing one or more blocks of PEM data. Each PEM block |
| must encode a TLS ServerHello extension (2 bytes type, 2 bytes length, |
| followed by "length" bytes of extension data). If the client sends |
| an empty TLS ClientHello extension matching the type, the corresponding |
| ServerHello extension will be returned. |
| |
| =item B<-certform> B<DER>|B<PEM>, B<-CRLForm> B<DER>|B<PEM> |
| |
| The certificate and CRL format; the default is PEM. |
| See L<openssl(1)/Format Options> for details. |
| |
| =item B<-key> I<infile> |
| |
| The private key to use. If not specified then the certificate file will |
| be used. |
| |
| =item B<-keyform> B<DER>|B<PEM> |
| |
| The key format; the default is B<PEM>. |
| See L<openssl(1)/Format Options> for details. |
| |
| =item B<-pass> I<val> |
| |
| The private key password source. |
| For more information about the format of I<val>, |
| see L<openssl(1)/Pass Phrase Options>. |
| |
| =item B<-dcert> I<infile>, B<-dkey> I<infile> |
| |
| Specify an additional certificate and private key, these behave in the |
| same manner as the B<-cert> and B<-key> options except there is no default |
| if they are not specified (no additional certificate and key is used). As |
| noted above some cipher suites require a certificate containing a key of |
| a certain type. Some cipher suites need a certificate carrying an RSA key |
| and some a DSS (DSA) key. By using RSA and DSS certificates and keys |
| a server can support clients which only support RSA or DSS cipher suites |
| by using an appropriate certificate. |
| |
| =item B<-dcert_chain> |
| |
| A file containing trusted certificates to use when attempting to build the |
| server certificate chain when a certificate specified via the B<-dcert> option |
| is in use. |
| |
| =item B<-dcertform> B<DER>|B<PEM>, B<-dkeyform> B<DER>|B<PEM> |
| |
| The format of the certificate and private key; the default is B<PEM> |
| see L<openssl(1)/Format Options>. |
| |
| =item B<-dpass> I<val> |
| |
| The passphrase for the additional private key. |
| For more information about the format of I<val>, |
| see L<openssl(1)/Pass Phrase Options>. |
| |
| =item B<-nbio_test> |
| |
| Tests non blocking I/O. |
| |
| =item B<-crlf> |
| |
| This option translated a line feed from the terminal into CR+LF. |
| |
| =item B<-debug> |
| |
| Print extensive debugging information including a hex dump of all traffic. |
| |
| =item B<-msg> |
| |
| Show all protocol messages with hex dump. |
| |
| =item B<-msgfile> I<outfile> |
| |
| File to send output of B<-msg> or B<-trace> to, default standard output. |
| |
| =item B<-state> |
| |
| Prints the SSL session states. |
| |
| =item B<-chainCApath> I<dir> |
| |
| The directory to use for building the chain provided to the client. This |
| directory must be in "hash format", see L<openssl-verify(1)> for more |
| information. |
| |
| =item B<-chainCAfile> I<file> |
| |
| A file containing trusted certificates to use when attempting to build the |
| server certificate chain. |
| |
| =item B<-chainCAstore> I<uri> |
| |
| The URI to a store to use for building the chain provided to the client. |
| The URI may indicate a single certificate, as well as a collection of |
| them. |
| With URIs in the C<file:> scheme, this acts as B<-chainCAfile> or |
| B<-chainCApath>, depending on if the URI indicates a directory or a |
| single file. |
| See L<ossl_store-file(7)> for more information on the C<file:> scheme. |
| |
| =item B<-nocert> |
| |
| If this option is set then no certificate is used. This restricts the |
| cipher suites available to the anonymous ones (currently just anonymous |
| DH). |
| |
| =item B<-quiet> |
| |
| Inhibit printing of session and certificate information. |
| |
| =item B<-www> |
| |
| Sends a status message back to the client when it connects. This includes |
| information about the ciphers used and various session parameters. |
| The output is in HTML format so this option will normally be used with a |
| web browser. Cannot be used in conjunction with B<-early_data>. |
| |
| =item B<-WWW> |
| |
| Emulates a simple web server. Pages will be resolved relative to the |
| current directory, for example if the URL https://myhost/page.html is |
| requested the file F<./page.html> will be loaded. Cannot be used in conjunction |
| with B<-early_data>. |
| |
| =item B<-tlsextdebug> |
| |
| Print a hex dump of any TLS extensions received from the server. |
| |
| =item B<-HTTP> |
| |
| Emulates a simple web server. Pages will be resolved relative to the |
| current directory, for example if the URL https://myhost/page.html is |
| requested the file F<./page.html> will be loaded. The files loaded are |
| assumed to contain a complete and correct HTTP response (lines that |
| are part of the HTTP response line and headers must end with CRLF). Cannot be |
| used in conjunction with B<-early_data>. |
| |
| =item B<-id_prefix> I<val> |
| |
| Generate SSL/TLS session IDs prefixed by I<val>. This is mostly useful |
| for testing any SSL/TLS code (eg. proxies) that wish to deal with multiple |
| servers, when each of which might be generating a unique range of session |
| IDs (eg. with a certain prefix). |
| |
| =item B<-verify_return_error> |
| |
| Verification errors normally just print a message but allow the |
| connection to continue, for debugging purposes. |
| If this option is used, then verification errors close the connection. |
| |
| =item B<-status> |
| |
| Enables certificate status request support (aka OCSP stapling). |
| |
| =item B<-status_verbose> |
| |
| Enables certificate status request support (aka OCSP stapling) and gives |
| a verbose printout of the OCSP response. |
| |
| =item B<-status_timeout> I<int> |
| |
| Sets the timeout for OCSP response to I<int> seconds. |
| |
| =item B<-status_url> I<val> |
| |
| Sets a fallback responder URL to use if no responder URL is present in the |
| server certificate. Without this option an error is returned if the server |
| certificate does not contain a responder address. |
| |
| =item B<-status_file> I<infile> |
| |
| Overrides any OCSP responder URLs from the certificate and always provides the |
| OCSP Response stored in the file. The file must be in DER format. |
| |
| =item B<-trace> |
| |
| Show verbose trace output of protocol messages. OpenSSL needs to be compiled |
| with B<enable-ssl-trace> for this option to work. |
| |
| =item B<-brief> |
| |
| Provide a brief summary of connection parameters instead of the normal verbose |
| output. |
| |
| =item B<-rev> |
| |
| Simple test server which just reverses the text received from the client |
| and sends it back to the server. Also sets B<-brief>. Cannot be used in |
| conjunction with B<-early_data>. |
| |
| =item B<-async> |
| |
| Switch on asynchronous mode. Cryptographic operations will be performed |
| asynchronously. This will only have an effect if an asynchronous capable engine |
| is also used via the B<-engine> option. For test purposes the dummy async engine |
| (dasync) can be used (if available). |
| |
| =item B<-max_send_frag> I<+int> |
| |
| The maximum size of data fragment to send. |
| See L<SSL_CTX_set_max_send_fragment(3)> for further information. |
| |
| =item B<-split_send_frag> I<+int> |
| |
| The size used to split data for encrypt pipelines. If more data is written in |
| one go than this value then it will be split into multiple pipelines, up to the |
| maximum number of pipelines defined by max_pipelines. This only has an effect if |
| a suitable cipher suite has been negotiated, an engine that supports pipelining |
| has been loaded, and max_pipelines is greater than 1. See |
| L<SSL_CTX_set_split_send_fragment(3)> for further information. |
| |
| =item B<-max_pipelines> I<+int> |
| |
| The maximum number of encrypt/decrypt pipelines to be used. This will only have |
| an effect if an engine has been loaded that supports pipelining (e.g. the dasync |
| engine) and a suitable cipher suite has been negotiated. The default value is 1. |
| See L<SSL_CTX_set_max_pipelines(3)> for further information. |
| |
| =item B<-read_buf> I<+int> |
| |
| The default read buffer size to be used for connections. This will only have an |
| effect if the buffer size is larger than the size that would otherwise be used |
| and pipelining is in use (see L<SSL_CTX_set_default_read_buffer_len(3)> for |
| further information). |
| |
| =item B<-ssl2>, B<-ssl3>, B<-tls1>, B<-tls1_1>, B<-tls1_2>, B<-tls1_3>, B<-no_ssl2>, B<-no_ssl3>, B<-no_tls1>, B<-no_tls1_1>, B<-no_tls1_2>, B<-no_tls1_3> |
| |
| These options require or disable the use of the specified SSL or TLS protocols. |
| By default, this command will negotiate the highest mutually supported |
| protocol version. |
| When a specific TLS version is required, only that version will be accepted |
| from the client. |
| Note that not all protocols and flags may be available, depending on how |
| OpenSSL was built. |
| |
| =item B<-bugs> |
| |
| There are several known bugs in SSL and TLS implementations. Adding this |
| option enables various workarounds. |
| |
| =item B<-no_comp> |
| |
| Disable negotiation of TLS compression. |
| TLS compression is not recommended and is off by default as of |
| OpenSSL 1.1.0. |
| |
| =item B<-comp> |
| |
| Enable negotiation of TLS compression. |
| This option was introduced in OpenSSL 1.1.0. |
| TLS compression is not recommended and is off by default as of |
| OpenSSL 1.1.0. |
| |
| =item B<-no_ticket> |
| |
| Disable RFC4507bis session ticket support. This option has no effect if TLSv1.3 |
| is negotiated. See B<-num_tickets>. |
| |
| =item B<-num_tickets> |
| |
| Control the number of tickets that will be sent to the client after a full |
| handshake in TLSv1.3. The default number of tickets is 2. This option does not |
| affect the number of tickets sent after a resumption handshake. |
| |
| =item B<-serverpref> |
| |
| Use the server's cipher preferences, rather than the client's preferences. |
| |
| =item B<-prioritize_chacha> |
| |
| Prioritize ChaCha ciphers when preferred by clients. Requires B<-serverpref>. |
| |
| =item B<-no_resumption_on_reneg> |
| |
| Set the B<SSL_OP_NO_SESSION_RESUMPTION_ON_RENEGOTIATION> option. |
| |
| =item B<-client_sigalgs> I<val> |
| |
| Signature algorithms to support for client certificate authentication |
| (colon-separated list). |
| |
| =item B<-named_curve> I<val> |
| |
| Specifies the elliptic curve to use. NOTE: this is single curve, not a list. |
| For a list of all possible curves, use: |
| |
| $ openssl ecparam -list_curves |
| |
| =item B<-cipher> I<val> |
| |
| This allows the list of TLSv1.2 and below ciphersuites used by the server to be |
| modified. This list is combined with any TLSv1.3 ciphersuites that have been |
| configured. When the client sends a list of supported ciphers the first client |
| cipher also included in the server list is used. Because the client specifies |
| the preference order, the order of the server cipherlist is irrelevant. See |
| L<openssl-ciphers(1)> for more information. |
| |
| =item B<-ciphersuites> I<val> |
| |
| This allows the list of TLSv1.3 ciphersuites used by the server to be modified. |
| This list is combined with any TLSv1.2 and below ciphersuites that have been |
| configured. When the client sends a list of supported ciphers the first client |
| cipher also included in the server list is used. Because the client specifies |
| the preference order, the order of the server cipherlist is irrelevant. See |
| L<openssl-ciphers(1)> command for more information. The format for this list is |
| a simple colon (":") separated list of TLSv1.3 ciphersuite names. |
| |
| =item B<-dhparam> I<infile> |
| |
| The DH parameter file to use. The ephemeral DH cipher suites generate keys |
| using a set of DH parameters. If not specified then an attempt is made to |
| load the parameters from the server certificate file. |
| If this fails then a static set of parameters hard coded into this command |
| will be used. |
| |
| =item B<-attime>, B<-check_ss_sig>, B<-crl_check>, B<-crl_check_all>, |
| B<-explicit_policy>, B<-extended_crl>, B<-ignore_critical>, B<-inhibit_any>, |
| B<-inhibit_map>, B<-no_alt_chains>, B<-no_check_time>, B<-partial_chain>, B<-policy>, |
| B<-policy_check>, B<-policy_print>, B<-purpose>, B<-suiteB_128>, |
| B<-suiteB_128_only>, B<-suiteB_192>, B<-trusted_first>, B<-use_deltas>, |
| B<-auth_level>, B<-verify_depth>, B<-verify_email>, B<-verify_hostname>, |
| B<-verify_ip>, B<-verify_name>, B<-x509_strict> |
| |
| Set different peer certificate verification options. |
| See the L<openssl-verify(1)> manual page for details. |
| |
| =item B<-crl_check>, B<-crl_check_all> |
| |
| Check the peer certificate has not been revoked by its CA. |
| The CRL(s) are appended to the certificate file. With the B<-crl_check_all> |
| option all CRLs of all CAs in the chain are checked. |
| |
| =item B<-nbio> |
| |
| Turns on non blocking I/O. |
| |
| =item B<-psk_identity> I<val> |
| |
| Expect the client to send PSK identity I<val> when using a PSK |
| cipher suite, and warn if they do not. By default, the expected PSK |
| identity is the string "Client_identity". |
| |
| =item B<-psk_hint> I<val> |
| |
| Use the PSK identity hint I<val> when using a PSK cipher suite. |
| |
| =item B<-psk> I<val> |
| |
| Use the PSK key I<val> when using a PSK cipher suite. The key is |
| given as a hexadecimal number without leading 0x, for example -psk |
| 1a2b3c4d. |
| This option must be provided in order to use a PSK cipher. |
| |
| =item B<-psk_session> I<file> |
| |
| Use the pem encoded SSL_SESSION data stored in I<file> as the basis of a PSK. |
| Note that this will only work if TLSv1.3 is negotiated. |
| |
| =item B<-listen> |
| |
| This option can only be used in conjunction with one of the DTLS options above. |
| With this option, this command will listen on a UDP port for incoming |
| connections. |
| Any ClientHellos that arrive will be checked to see if they have a cookie in |
| them or not. |
| Any without a cookie will be responded to with a HelloVerifyRequest. |
| If a ClientHello with a cookie is received then this command will |
| connect to that peer and complete the handshake. |
| |
| =item B<-dtls>, B<-dtls1>, B<-dtls1_2> |
| |
| These options make this command use DTLS protocols instead of TLS. |
| With B<-dtls>, it will negotiate any supported DTLS protocol |
| version, whilst B<-dtls1> and B<-dtls1_2> will only support DTLSv1.0 and |
| DTLSv1.2 respectively. |
| |
| =item B<-sctp> |
| |
| Use SCTP for the transport protocol instead of UDP in DTLS. Must be used in |
| conjunction with B<-dtls>, B<-dtls1> or B<-dtls1_2>. This option is only |
| available where OpenSSL has support for SCTP enabled. |
| |
| =item B<-sctp_label_bug> |
| |
| Use the incorrect behaviour of older OpenSSL implementations when computing |
| endpoint-pair shared secrets for DTLS/SCTP. This allows communication with |
| older broken implementations but breaks interoperability with correct |
| implementations. Must be used in conjunction with B<-sctp>. This option is only |
| available where OpenSSL has support for SCTP enabled. |
| |
| =item B<-no_dhe> |
| |
| If this option is set then no DH parameters will be loaded effectively |
| disabling the ephemeral DH cipher suites. |
| |
| =item B<-alpn> I<val>, B<-nextprotoneg> I<val> |
| |
| These flags enable the Enable the Application-Layer Protocol Negotiation |
| or Next Protocol Negotiation (NPN) extension, respectively. ALPN is the |
| IETF standard and replaces NPN. |
| The I<val> list is a comma-separated list of supported protocol |
| names. The list should contain the most desirable protocols first. |
| Protocol names are printable ASCII strings, for example "http/1.1" or |
| "spdy/3". |
| The flag B<-nextprotoneg> cannot be specified if B<-tls1_3> is used. |
| |
| =item B<-engine> I<val> |
| |
| Specifying an engine (by its unique id string in I<val>) will cause |
| this command to attempt to obtain a functional reference to the |
| specified engine, thus initialising it if needed. The engine will then be |
| set as the default for all available algorithms. |
| |
| =item B<-keylogfile> I<outfile> |
| |
| Appends TLS secrets to the specified keylog file such that external programs |
| (like Wireshark) can decrypt TLS connections. |
| |
| =item B<-max_early_data> I<int> |
| |
| Change the default maximum early data bytes that are specified for new sessions |
| and any incoming early data (when used in conjunction with the B<-early_data> |
| flag). The default value is approximately 16k. The argument must be an integer |
| greater than or equal to 0. |
| |
| =item B<-early_data> |
| |
| Accept early data where possible. Cannot be used in conjunction with B<-www>, |
| B<-WWW>, B<-HTTP> or B<-rev>. |
| |
| =item B<-anti_replay>, B<-no_anti_replay> |
| |
| Switches replay protection on or off, respectively. Replay protection is on by |
| default unless overridden by a configuration file. When it is on, OpenSSL will |
| automatically detect if a session ticket has been used more than once, TLSv1.3 |
| has been negotiated, and early data is enabled on the server. A full handshake |
| is forced if a session ticket is used a second or subsequent time. Any early |
| data that was sent will be rejected. |
| |
| =item B<-http_server_binmode> |
| |
| When acting as web-server (using option B<-WWW> or B<-HTTP>) open files requested |
| by the client in binary mode. |
| |
| {- $OpenSSL::safe::opt_name_item -} |
| |
| {- $OpenSSL::safe::opt_x_item -} |
| |
| {- $OpenSSL::safe::opt_trust_item -} |
| |
| {- $OpenSSL::safe::opt_r_item -} |
| |
| =back |
| |
| =head1 CONNECTED COMMANDS |
| |
| If a connection request is established with an SSL client and neither the |
| B<-www> nor the B<-WWW> option has been used then normally any data received |
| from the client is displayed and any key presses will be sent to the client. |
| |
| Certain commands are also recognized which perform special operations. These |
| commands are a letter which must appear at the start of a line. They are listed |
| below. |
| |
| =over 4 |
| |
| =item B<q> |
| |
| End the current SSL connection but still accept new connections. |
| |
| =item B<Q> |
| |
| End the current SSL connection and exit. |
| |
| =item B<r> |
| |
| Renegotiate the SSL session (TLSv1.2 and below only). |
| |
| =item B<R> |
| |
| Renegotiate the SSL session and request a client certificate (TLSv1.2 and below |
| only). |
| |
| =item B<P> |
| |
| Send some plain text down the underlying TCP connection: this should |
| cause the client to disconnect due to a protocol violation. |
| |
| =item B<S> |
| |
| Print out some session cache status information. |
| |
| =item B<k> |
| |
| Send a key update message to the client (TLSv1.3 only) |
| |
| =item B<K> |
| |
| Send a key update message to the client and request one back (TLSv1.3 only) |
| |
| =item B<c> |
| |
| Send a certificate request to the client (TLSv1.3 only) |
| |
| =back |
| |
| =head1 NOTES |
| |
| This command can be used to debug SSL clients. To accept connections |
| from a web browser the command: |
| |
| openssl s_server -accept 443 -www |
| |
| can be used for example. |
| |
| Although specifying an empty list of CAs when requesting a client certificate |
| is strictly speaking a protocol violation, some SSL clients interpret this to |
| mean any CA is acceptable. This is useful for debugging purposes. |
| |
| The session parameters can printed out using the L<openssl-sess_id(1)> command. |
| |
| =head1 BUGS |
| |
| Because this program has a lot of options and also because some of the |
| techniques used are rather old, the C source for this command is rather |
| hard to read and not a model of how things should be done. |
| A typical SSL server program would be much simpler. |
| |
| The output of common ciphers is wrong: it just gives the list of ciphers that |
| OpenSSL recognizes and the client supports. |
| |
| There should be a way for this command to print out details |
| of any unknown cipher suites a client says it supports. |
| |
| =head1 SEE ALSO |
| |
| L<openssl(1)>, |
| L<openssl-sess_id(1)>, |
| L<openssl-s_client(1)>, |
| L<openssl-ciphers(1)>, |
| L<SSL_CONF_cmd(3)>, |
| L<SSL_CTX_set_max_send_fragment(3)>, |
| L<SSL_CTX_set_split_send_fragment(3)>, |
| L<SSL_CTX_set_max_pipelines(3)>, |
| L<ossl_store-file(7)> |
| |
| =head1 HISTORY |
| |
| The -no_alt_chains option was added in OpenSSL 1.1.0. |
| |
| The |
| -allow-no-dhe-kex and -prioritize_chacha options were added in OpenSSL 1.1.1. |
| |
| =head1 COPYRIGHT |
| |
| Copyright 2000-2019 The OpenSSL Project Authors. All Rights Reserved. |
| |
| Licensed under the Apache License 2.0 (the "License"). You may not use |
| this file except in compliance with the License. You can obtain a copy |
| in the file LICENSE in the source distribution or at |
| L<https://www.openssl.org/source/license.html>. |
| |
| =cut |