Changeset View
Changeset View
Standalone View
Standalone View
src/widgets/sslui.h
Show All 16 Lines | |||||
17 | * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, | 17 | * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, | ||
18 | * Boston, MA 02110-1301, USA. | 18 | * Boston, MA 02110-1301, USA. | ||
19 | */ | 19 | */ | ||
20 | 20 | | |||
21 | #ifndef _KSSLUI_H | 21 | #ifndef _KSSLUI_H | ||
22 | #define _KSSLUI_H | 22 | #define _KSSLUI_H | ||
23 | 23 | | |||
24 | #include "kiowidgets_export.h" | 24 | #include "kiowidgets_export.h" | ||
25 | #include <ktcpsocket.h> | 25 | #include <ksslerroruidata.h> | ||
26 | #include <ktcpsocket.h> // TODO KF6 remove this include | ||||
26 | 27 | | |||
27 | namespace KIO | 28 | namespace KIO | ||
28 | { | 29 | { | ||
30 | /** UI methods for handling SSL errors. */ | ||||
29 | namespace SslUi | 31 | namespace SslUi | ||
30 | { | 32 | { | ||
31 | 33 | | |||
34 | /** Error rule storage behavior. */ | ||||
32 | enum RulesStorage { | 35 | enum RulesStorage { | ||
33 | RecallRules = 1, ///< apply stored certificate rules (typically ignored errors) | 36 | RecallRules = 1, ///< apply stored certificate rules (typically ignored errors) | ||
34 | StoreRules = 2, ///< make new ignore rules from the user's choice and store them | 37 | StoreRules = 2, ///< make new ignore rules from the user's choice and store them | ||
35 | RecallAndStoreRules = 3 ///< apply stored rules and store new rules | 38 | RecallAndStoreRules = 3 ///< apply stored rules and store new rules | ||
36 | }; | 39 | }; | ||
37 | 40 | | |||
38 | bool KIOWIDGETS_EXPORT askIgnoreSslErrors(const KTcpSocket *socket, | 41 | /** | ||
39 | RulesStorage storedRules = RecallAndStoreRules); | 42 | * @deprecated since 5.64 use the KSslErrorUiData variant instead. | ||
43 | */ | ||||
44 | bool KIOWIDGETS_DEPRECATED_EXPORT askIgnoreSslErrors(const KTcpSocket *socket, | ||||
45 | RulesStorage storedRules = RecallAndStoreRules); // TODO KF6 remove | ||||
40 | 46 | | |||
41 | /** | 47 | /** | ||
42 | * If there are errors while establishing an SSL encrypted connection to a peer, usually due to | 48 | * If there are errors while establishing an SSL encrypted connection to a peer, usually due to | ||
43 | * certificate issues, and since this poses a security issue, we need confirmation from the user about | 49 | * certificate issues, and since this poses a security issue, we need confirmation from the user about | ||
44 | * how they wish to proceed. | 50 | * how they wish to proceed. | ||
45 | * | 51 | * | ||
46 | * This function provides a dialog asking the user if they wish to abort the connection or ignore | 52 | * This function provides a dialog asking the user if they wish to abort the connection or ignore | ||
47 | * the SSL errors that occurred and continue connecting. And in case of the latter whether to remember | 53 | * the SSL errors that occurred and continue connecting. And in case of the latter whether to remember | ||
Show All 12 Lines |