Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
SSL_GET_PEER_CERTIFICATE(3)	    OpenSSL	   SSL_GET_PEER_CERTIFICATE(3)

NAME
       SSL_get_peer_certificate	- get the X509 certificate of the peer

SYNOPSIS
	#include <openssl/ssl.h>

	X509 *SSL_get_peer_certificate(const SSL *ssl);

DESCRIPTION
       SSL_get_peer_certificate() returns a pointer to the X509	certificate
       the peer	presented. If the peer did not present a certificate, NULL is
       returned.

NOTES
       Due to the protocol definition, a TLS/SSL server	will always send a
       certificate, if present.	A client will only send	a certificate when
       explicitly requested to do so by	the server (see
       SSL_CTX_set_verify(3)). If an anonymous cipher is used, no certificates
       are sent.

       That a certificate is returned does not indicate	information about the
       verification state, use SSL_get_verify_result(3)	to check the
       verification state.

       The reference count of the X509 object is incremented by	one, so	that
       it will not be destroyed	when the session containing the	peer
       certificate is freed. The X509 object must be explicitly	freed using
       X509_free().

RETURN VALUES
       The following return values can occur:

       NULL
	   No certificate was presented	by the peer or no connection was
	   established.

       Pointer to an X509 certificate
	   The return value points to the certificate presented	by the peer.

SEE ALSO
       ssl(7), SSL_get_verify_result(3), SSL_CTX_set_verify(3)

COPYRIGHT
       Copyright 2000-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>.

1.1.1a				  2018-11-20	   SSL_GET_PEER_CERTIFICATE(3)

NAME | SYNOPSIS | DESCRIPTION | NOTES | RETURN VALUES | SEE ALSO | COPYRIGHT

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=SSL_get_peer_certificate&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help