libressl-SSL_set1_param3
Get and set verification parameters
Usage
SSL Library (libssl, -lssl) libcrypto
#include <openssl/ssl.h>
X509_VERIFY_PARAM *
SSL_CTX_get0_param(SSL_CTX *ctx);
X509_VERIFY_PARAM *
SSL_get0_param(SSL *ssl);
int
SSL_CTX_set1_param(SSL_CTX *ctx, X509_VERIFY_PARAM *vpm);
int
SSL_set1_param(SSL *ssl, X509_VERIFY_PARAM *vpm);
Overview
SSL_CTX_get0_param() and SSL_get0_param() retrieve an internal pointer to the verification parameters for ctx or ssl, respectively. The returned pointer must not be freed by the calling application, but the application can modify the parameters pointed to, to suit its needs: for example to add a hostname check.
SSL_CTX_set1_param() and SSL_set1_param() set the verification parameters to vpm for ctx or ssl.
Return values
SSL_CTX_get0_param() and SSL_get0_param() return a pointer to an X509_VERIFY_PARAM structure.
SSL_CTX_set1_param() and SSL_set1_param() return 1 for success or 0 for failure.
Examples
Check that the hostname matches www.foo.com in the peer certificate:
X509_VERIFY_PARAM *vpm = SSL_get0_param(ssl); X509_VERIFY_PARAM_set1_host(vpm, "www.foo.com", 0);