mirror of
https://gitlab.gnome.org/GNOME/glib.git
synced 2024-12-27 07:56:14 +01:00
0f99cfa882
The database is an abstract object implemented by the various TLS backends, which is used by GTlsConnection to lookup certificates and keys, as well as verify certificate chains. Also add GTlsInteraction, which can be used to prompt the user for a password or PIN (used with the database). https://bugzilla.gnome.org/show_bug.cgi?id=636572
101 lines
3.6 KiB
C
101 lines
3.6 KiB
C
/* GIO - GLib Input, Output and Streaming Library
|
|
*
|
|
* Copyright (C) 2010 Red Hat, Inc.
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2 of the License, or (at your option) any later version.
|
|
*
|
|
* This library is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General
|
|
* Public License along with this library; if not, write to the
|
|
* Free Software Foundation, Inc., 59 Temple Place, Suite 330,
|
|
* Boston, MA 02111-1307, USA.
|
|
*/
|
|
|
|
#if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION)
|
|
#error "Only <gio/gio.h> can be included directly."
|
|
#endif
|
|
|
|
#ifndef __G_TLS_BACKEND_H__
|
|
#define __G_TLS_BACKEND_H__
|
|
|
|
#include <gio/giotypes.h>
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
/**
|
|
* G_TLS_BACKEND_EXTENSION_POINT_NAME:
|
|
*
|
|
* Extension point for TLS functionality via #GTlsBackend.
|
|
* See <link linkend="extending-gio">Extending GIO</link>.
|
|
*/
|
|
#define G_TLS_BACKEND_EXTENSION_POINT_NAME "gio-tls-backend"
|
|
|
|
#define G_TYPE_TLS_BACKEND (g_tls_backend_get_type ())
|
|
#define G_TLS_BACKEND(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), G_TYPE_TLS_BACKEND, GTlsBackend))
|
|
#define G_IS_TLS_BACKEND(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), G_TYPE_TLS_BACKEND))
|
|
#define G_TLS_BACKEND_GET_INTERFACE(obj) (G_TYPE_INSTANCE_GET_INTERFACE ((obj), G_TYPE_TLS_BACKEND, GTlsBackendInterface))
|
|
|
|
/**
|
|
* GTlsBackend:
|
|
*
|
|
* TLS (Transport Layer Security, aka SSL) backend. This is an
|
|
* internal type used to coordinate the different classes implemented
|
|
* by a TLS backend.
|
|
*
|
|
* Since: 2.28
|
|
*/
|
|
|
|
typedef struct _GTlsBackend GTlsBackend;
|
|
typedef struct _GTlsBackendInterface GTlsBackendInterface;
|
|
|
|
/**
|
|
* GTlsBackendInterface:
|
|
* @g_iface: The parent interface.
|
|
* @supports_tls: returns whether the backend supports TLS.
|
|
* @get_default_database: returns a default #GTlsDatabase instance.
|
|
* @get_certificate_type: returns the #GTlsCertificate implementation type
|
|
* @get_client_connection_type: returns the #GTlsClientConnection implementation type
|
|
* @get_server_connection_type: returns the #GTlsServerConnection implementation type
|
|
* @get_file_database_type: returns the #GTlsFileDatabase implementation type.
|
|
*
|
|
* Provides an interface for describing TLS-related types.
|
|
*
|
|
* Since: 2.28
|
|
*/
|
|
struct _GTlsBackendInterface
|
|
{
|
|
GTypeInterface g_iface;
|
|
|
|
/* methods */
|
|
gboolean ( *supports_tls) (GTlsBackend *backend);
|
|
GType ( *get_certificate_type) (void);
|
|
GType ( *get_client_connection_type) (void);
|
|
GType ( *get_server_connection_type) (void);
|
|
GType ( *get_file_database_type) (void);
|
|
GTlsDatabase * ( *get_default_database) (GTlsBackend *backend);
|
|
};
|
|
|
|
GType g_tls_backend_get_type (void) G_GNUC_CONST;
|
|
|
|
GTlsBackend * g_tls_backend_get_default (void);
|
|
|
|
GTlsDatabase * g_tls_backend_get_default_database (GTlsBackend *backend);
|
|
|
|
gboolean g_tls_backend_supports_tls (GTlsBackend *backend);
|
|
|
|
GType g_tls_backend_get_certificate_type (GTlsBackend *backend);
|
|
GType g_tls_backend_get_client_connection_type (GTlsBackend *backend);
|
|
GType g_tls_backend_get_server_connection_type (GTlsBackend *backend);
|
|
GType g_tls_backend_get_file_database_type (GTlsBackend *backend);
|
|
|
|
G_END_DECLS
|
|
|
|
#endif /* __G_TLS_BACKEND_H__ */
|