108 lines
4.1 KiB
C
108 lines
4.1 KiB
C
/* Licensed to the Apache Software Foundation (ASF) under one or more
|
|
* contributor license agreements. See the NOTICE file distributed with
|
|
* this work for additional information regarding copyright ownership.
|
|
* The ASF licenses this file to You under the Apache License, Version 2.0
|
|
* (the "License"); you may not use this file except in compliance with
|
|
* the License. You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
/**
|
|
* @verbatim
|
|
_ _
|
|
_ __ ___ ___ __| | ___ ___| | mod_ssl
|
|
| '_ ` _ \ / _ \ / _` | / __/ __| | Apache Interface to OpenSSL
|
|
| | | | | | (_) | (_| | \__ \__ \ |
|
|
|_| |_| |_|\___/ \__,_|___|___/___/_|
|
|
|_____|
|
|
@endverbatim
|
|
* @file ssl_util_ssl.h
|
|
* @brief Additional Utility Functions for OpenSSL
|
|
*
|
|
* @defgroup MOD_SSL_UTIL Utilities
|
|
* @ingroup MOD_SSL
|
|
* @{
|
|
*/
|
|
|
|
#ifndef __SSL_UTIL_SSL_H__
|
|
#define __SSL_UTIL_SSL_H__
|
|
|
|
/**
|
|
* SSL library version number
|
|
*/
|
|
|
|
#define MODSSL_LIBRARY_VERSION OPENSSL_VERSION_NUMBER
|
|
#define MODSSL_LIBRARY_NAME "OpenSSL"
|
|
#define MODSSL_LIBRARY_TEXT OPENSSL_VERSION_TEXT
|
|
#if MODSSL_USE_OPENSSL_PRE_1_1_API
|
|
#define MODSSL_LIBRARY_DYNTEXT SSLeay_version(SSLEAY_VERSION)
|
|
#else
|
|
#define MODSSL_LIBRARY_DYNTEXT OpenSSL_version(OPENSSL_VERSION)
|
|
#endif
|
|
|
|
/**
|
|
* Maximum length of a DER encoded session.
|
|
* FIXME: There is no define in OpenSSL, but OpenSSL uses 1024*10,
|
|
* so this value should be ok. Although we have no warm feeling.
|
|
*/
|
|
#define MODSSL_SESSION_MAX_DER 1024*10
|
|
|
|
/** max length for modssl_SSL_SESSION_id2sz */
|
|
#define MODSSL_SESSION_ID_STRING_LEN \
|
|
((SSL_MAX_SSL_SESSION_ID_LENGTH + 1) * 2)
|
|
|
|
/**
|
|
* Additional Functions
|
|
*/
|
|
void modssl_init_app_data2_idx(void);
|
|
void *modssl_get_app_data2(SSL *);
|
|
void modssl_set_app_data2(SSL *, void *);
|
|
|
|
/* Read private key from filename in either PEM or raw base64(DER)
|
|
* format, using password entry callback cb and userdata. */
|
|
EVP_PKEY *modssl_read_privatekey(const char *filename, pem_password_cb *cb, void *ud);
|
|
|
|
int modssl_smart_shutdown(SSL *ssl);
|
|
BOOL modssl_X509_getBC(X509 *, int *, int *);
|
|
char *modssl_X509_NAME_ENTRY_to_string(apr_pool_t *p, X509_NAME_ENTRY *xsne,
|
|
int raw);
|
|
char *modssl_X509_NAME_to_string(apr_pool_t *, X509_NAME *, int);
|
|
BOOL modssl_X509_getSAN(apr_pool_t *, X509 *, int, const char *, int, apr_array_header_t **);
|
|
BOOL modssl_X509_match_name(apr_pool_t *, X509 *, const char *, BOOL, server_rec *);
|
|
char *modssl_SSL_SESSION_id2sz(IDCONST unsigned char *, int, char *, int);
|
|
|
|
/* Reads the remaining data in BIO, if not empty, and copies it into a
|
|
* pool-allocated string. If empty, returns NULL. BIO_free(bio) is
|
|
* called for both cases. */
|
|
char *modssl_bio_free_read(apr_pool_t *p, BIO *bio);
|
|
|
|
/* Read a single certificate and its private key from the given string in PEM format.
|
|
* If `key_pem` is NULL, it will expect the key in `cert_pem`.
|
|
*/
|
|
apr_status_t modssl_read_cert(apr_pool_t *p,
|
|
const char *cert_pem, const char *key_pem,
|
|
pem_password_cb *cb, void *ud,
|
|
X509 **pcert, EVP_PKEY **pkey);
|
|
|
|
/* Convert a certificate (and optionally a second) into a PEM string.
|
|
* @param p pool for allocations
|
|
* @param cert1 the certificate to convert
|
|
* @param cert2 a second cert to add to the PEM afterwards or NULL.
|
|
* @param ppem the certificate(s) in PEM format, NUL-terminated.
|
|
* @return APR_SUCCESS if ppem is valid.
|
|
*/
|
|
apr_status_t modssl_cert_get_pem(apr_pool_t *p,
|
|
X509 *cert1, X509 *cert2,
|
|
const char **ppem);
|
|
|
|
#endif /* __SSL_UTIL_SSL_H__ */
|
|
/** @} */
|
|
|