:right-sidebar: True

TlsBackend
===================================================================

.. currentmodule:: gi.repository.Gio


.. versionadded:: 2.28




.. class:: TlsBackend(*args, **kwargs)
   :no-contents-entry:






TLS (Transport Layer Security, aka SSL) and DTLS backend. This is an
internal type used to coordinate the different classes implemented
by a TLS backend.




Methods
-------

.. rst-class:: interim-class

.. class:: TlsBackend
   :no-index:


   .. method:: get_certificate_type() -> ~gobject.GType

      Gets the :obj:`~gi.repository.GObject.Type` of ``backend``\'s :obj:`~gi.repository.Gio.TlsCertificate` implementation.


      .. versionadded:: 2.28








   .. method:: get_client_connection_type() -> ~gobject.GType

      Gets the :obj:`~gi.repository.GObject.Type` of ``backend``\'s :obj:`~gi.repository.Gio.TlsClientConnection` implementation.


      .. versionadded:: 2.28








   .. classmethod:: get_default() -> ~gi.repository.Gio.TlsBackend

      Gets the default :obj:`~gi.repository.Gio.TlsBackend` for the system.


      .. versionadded:: 2.28








   .. method:: get_default_database() -> ~gi.repository.Gio.TlsDatabase

      Gets the default :obj:`~gi.repository.Gio.TlsDatabase` used to verify TLS connections.


      .. versionadded:: 2.30








   .. method:: get_dtls_client_connection_type() -> ~gobject.GType

      Gets the :obj:`~gi.repository.GObject.Type` of ``backend``\’s :obj:`~gi.repository.Gio.DtlsClientConnection` implementation.


      .. versionadded:: 2.48








   .. method:: get_dtls_server_connection_type() -> ~gobject.GType

      Gets the :obj:`~gi.repository.GObject.Type` of ``backend``\’s ``GDtlsServerConnection`` implementation.


      .. versionadded:: 2.48








   .. method:: get_file_database_type() -> ~gobject.GType

      Gets the :obj:`~gi.repository.GObject.Type` of ``backend``\'s ``GTlsFileDatabase`` implementation.


      .. versionadded:: 2.30








   .. method:: get_server_connection_type() -> ~gobject.GType

      Gets the :obj:`~gi.repository.GObject.Type` of ``backend``\'s ``GTlsServerConnection`` implementation.


      .. versionadded:: 2.28








   .. method:: set_default_database(database: ~gi.repository.Gio.TlsDatabase | None = None) -> None

      Set the default :obj:`~gi.repository.Gio.TlsDatabase` used to verify TLS connections

      Any subsequent call to :func:`~gi.repository.Gio.TlsBackend.get_default_database` will return
      the database set in this call.  Existing databases and connections are not
      modified.

      Setting a :const:`None` default database will reset to using the system default
      database as if :func:`~gi.repository.Gio.TlsBackend.set_default_database` had never been called.


      .. versionadded:: 2.60





      :param database: the :obj:`~gi.repository.Gio.TlsDatabase`




   .. method:: supports_dtls() -> bool

      Checks if DTLS is supported. DTLS support may not be available even if TLS
      support is available, and vice-versa.


      .. versionadded:: 2.48








   .. method:: supports_tls() -> bool

      Checks if TLS is supported; if this returns :const:`False` for the default
      :obj:`~gi.repository.Gio.TlsBackend`\, it means no "real" TLS backend is available.


      .. versionadded:: 2.28
















Virtual Methods
---------------

.. rst-class:: interim-class

.. class:: TlsBackend
   :no-index:
   

   .. method:: do_get_default_database() -> ~gi.repository.Gio.TlsDatabase

      Gets the default :obj:`~gi.repository.Gio.TlsDatabase` used to verify TLS connections.


      .. versionadded:: 2.30








   .. method:: do_supports_dtls() -> bool

      Checks if DTLS is supported. DTLS support may not be available even if TLS
      support is available, and vice-versa.


      .. versionadded:: 2.48








   .. method:: do_supports_tls() -> bool

      Checks if TLS is supported; if this returns :const:`False` for the default
      :obj:`~gi.repository.Gio.TlsBackend`\, it means no "real" TLS backend is available.


      .. versionadded:: 2.28