ssl.h
3.88 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
/*
* "Software pw3270, desenvolvido com base nos códigos fontes do WC3270 e X3270
* (Paul Mattes Paul.Mattes@usa.net), de emulação de terminal 3270 para acesso a
* aplicativos mainframe. Registro no INPI sob o nome G3270.
*
* Copyright (C) <2008> <Banco do Brasil S.A.>
*
* Este programa é software livre. Você pode redistribuí-lo e/ou modificá-lo sob
* os termos da GPL v.2 - Licença Pública Geral GNU, conforme publicado pela
* Free Software Foundation.
*
* Este programa é distribuído na expectativa de ser útil, mas SEM QUALQUER
* GARANTIA; sem mesmo a garantia implícita de COMERCIALIZAÇÃO ou de ADEQUAÇÃO
* A QUALQUER PROPÓSITO EM PARTICULAR. Consulte a Licença Pública Geral GNU para
* obter mais detalhes.
*
* Você deve ter recebido uma cópia da Licença Pública Geral GNU junto com este
* programa; se não, escreva para a Free Software Foundation, Inc., 51 Franklin
* St, Fifth Floor, Boston, MA 02110-1301 USA
*
* Este programa está nomeado como ssl.h e possui - linhas de código.
*
* Contatos:
*
* perry.werneck@gmail.com (Alexandre Perry de Souza Werneck)
* erico.mendonca@gmail.com (Erico Mascarenhas Mendonça)
*
*/
/**
* @brief TN3270 SSL definitions.
*
* @author perry.werneck@gmail.com
*
*/
#ifndef LIB3270_SSL_H_INCLUDED
#define LIB3270_SSL_H_INCLUDED 1
#include <lib3270.h>
#ifdef __cplusplus
extern "C" {
#endif
/// @brief SSL state
typedef enum lib3270_ssl_state
{
LIB3270_SSL_UNSECURE, /**< @brief No secure connection */
LIB3270_SSL_SECURE, /**< @brief Connection secure with CA check */
LIB3270_SSL_NEGOTIATED, /**< @brief Connection secure, no CA, self-signed or expired CRL */
LIB3270_SSL_NEGOTIATING, /**< @brief Negotiating SSL */
LIB3270_SSL_VERIFYING, /**< @brief Verifying SSL (Getting CRL) */
LIB3270_SSL_UNDEFINED /**< @brief Undefined */
} LIB3270_SSL_STATE;
/**
* @brief Set URL for the certificate revocation list.
*
* @param hSession Session handle.
* @param crl URL for the certificate revocation list.
*
* @return 0 on sucess, non zero on error (sets errno).
*
*/
LIB3270_EXPORT int lib3270_crl_set_url(H3270 *hSession, const char *crl);
LIB3270_EXPORT const char * lib3270_crl_get_url(const H3270 *hSession);
LIB3270_EXPORT int lib3270_crl_set_preferred_protocol(H3270 *hSession, const char *protocol);
LIB3270_EXPORT const char * lib3270_crl_get_preferred_protocol(const H3270 *hSession);
/**
* @brief Get the available protocols for CRL download.
*
*/
LIB3270_EXPORT const char ** lib3270_get_available_crl_protocols(void);
/**
* @brief Get SSL host option.
*
* @return Non zero if the host URL has SSL scheme.
*
*/
LIB3270_EXPORT int lib3270_get_secure_host(const H3270 *hSession);
/**
* @brief Get security state.
*
*/
LIB3270_EXPORT LIB3270_SSL_STATE lib3270_get_ssl_state(const H3270 *session);
/**
* @brief Get security state as text.
*
*/
LIB3270_EXPORT const char * lib3270_get_ssl_state_message(const H3270 *hSession);
LIB3270_EXPORT const char * lib3270_get_ssl_state_icon_name(const H3270 *hSession);
/**
* @brief Get security state message.
*
*/
LIB3270_EXPORT const char * lib3270_get_ssl_state_description(const H3270 *hSession);
LIB3270_EXPORT char * lib3270_get_ssl_crl_text(const H3270 *hSession);
LIB3270_EXPORT char * lib3270_get_ssl_peer_certificate_text(const H3270 *hSession);
/**
* @brief Disable automatic download of the CRL.
*
* @param hSession Session handle.
* @param Value Non zero to enable automatic download of CRL.
*
* @return 0 if ok or error code if not (Sets errno).
*
* @retval 0 Success, the property was set.
* @retval ENOTSUP No SSL/TLS support.
*/
LIB3270_EXPORT int lib3270_ssl_set_crl_download(H3270 *hSession, int enabled);
LIB3270_EXPORT int lib3270_ssl_get_crl_download(const H3270 *hSession);
#ifdef __cplusplus
}
#endif
#endif // LIB3270_SSL_H_INCLUDED