table of contents
SSL_CTX_SET_PSK_CLIENT_CALLBACK(3SSL) | OpenSSL | SSL_CTX_SET_PSK_CLIENT_CALLBACK(3SSL) |
NAME¶
SSL_CTX_set_psk_client_callback, SSL_set_psk_client_callback - set PSK client callbackSYNOPSIS¶
#include <openssl/ssl.h> void SSL_CTX_set_psk_client_callback(SSL_CTX *ctx, unsigned int (*callback)(SSL *ssl, const char *hint, char *identity, unsigned int max_identity_len, unsigned char *psk, unsigned int max_psk_len)); void SSL_set_psk_client_callback(SSL *ssl, unsigned int (*callback)(SSL *ssl, const char *hint, char *identity, unsigned int max_identity_len, unsigned char *psk, unsigned int max_psk_len));
DESCRIPTION¶
A client application must provide a callback function which is called when the client is sending the ClientKeyExchange message to the server.The purpose of the callback function is to select the PSK identity and the pre-shared key to use during the connection setup phase.
The callback is set using functions SSL_CTX_set_psk_client_callback() or SSL_set_psk_client_callback(). The callback function is given the connection in parameter ssl, a NULL-terminated PSK identity hint sent by the server in parameter hint, a buffer identity of length max_identity_len bytes where the resulting NULL-terminated identity is to be stored, and a buffer psk of length max_psk_len bytes where the resulting pre-shared key is to be stored.
NOTES¶
Note that parameter hint given to the callback may be NULL.RETURN VALUES¶
Return values from the client callback are interpreted as follows:On success (callback found a PSK identity and a pre-shared key to use) the length (> 0) of psk in bytes is returned.
Otherwise or on errors callback should return 0. In this case the connection setup fails.
COPYRIGHT¶
Copyright 2006-2016 The OpenSSL Project Authors. All Rights Reserved.Licensed under the OpenSSL license (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 <https://www.openssl.org/source/license.html>.
Copyright 2005 Nokia.
2018-11-28 | 1.1.0j |