Skip to main content

inbound_smtp_tls_verify_callback

Last updated March 2020

Name

inbound_smtp_tls_verify_callback

Synopsis

#include "hooks/core/inbound_smtp_tls_verify_callback.h"

| int **inbound_smtp_tls_verify_callback** ( | closure, |   | |   | mc, |   | |   | ctx, |   | |   | preverify_ok, |   | |   | subject, |   | |   | issuer, |   | |   | x509ctx); |   |

void * <var class="pdparam">closure</var>; message_construct * <var class="pdparam">mc</var>; ec_ssl_ctx * <var class="pdparam">ctx</var>; int <var class="pdparam">preverify_ok</var>; const char * <var class="pdparam">subject</var>; const char * <var class="pdparam">issuer</var>; struct ssl_x509_store_ctx_st * <var class="pdparam">x509ctx</var>;

| int **has_core_inbound_smtp_tls_verify_callback_hook** ( | ); |   |

| void **register_core_inbound_smtp_tls_verify_callback_hook_first** ( | hook, |   | |   | closure); |   |

ec_hook_core_inbound_smtp_tls_verify_callback_func_t <var class="pdparam">hook</var>; void *<var class="pdparam">closure</var>;

| void **register_core_inbound_smtp_tls_verify_callback_hook_last** ( | hook, |   | |   | closure); |   |

ec_hook_core_inbound_smtp_tls_verify_callback_func_t <var class="pdparam">hook</var>; void *<var class="pdparam">closure</var>;

| int **call_core_inbound_smtp_tls_verify_callback_hook** ( | mc, |   | |   | ctx, |   | |   | preverify_ok, |   | |   | subject, |   | |   | issuer, |   | |   | x509ctx); |   |

message_construct * <var class="pdparam">mc</var>; ec_ssl_ctx * <var class="pdparam">ctx</var>; int <var class="pdparam">preverify_ok</var>; const char * <var class="pdparam">subject</var>; const char * <var class="pdparam">issuer</var>; struct ssl_x509_store_ctx_st * <var class="pdparam">x509ctx</var>;

Description

This hook allows you to augment the built-in TLS verification process for inbound SMTP sessions. The parameters are the same as the ec_ssl_verify_callback_func defined in ec_ssl.h, with the addition of the message_construct for the current session.

The subject, issuer and x509ctx parameters may be NULL in certain circumstances -- when client certificate verification fails or no client certificate was presented. This hook is called even when the listener is not configured to verify client certificates (verify_mode set to none).

Was this page helpful?