Package ch.bailu.gtk.gio

Klasse TlsClientConnection

java.lang.Object
ch.bailu.gtk.type.Type
ch.bailu.gtk.type.Pointer
ch.bailu.gtk.gobject.Object
ch.bailu.gtk.type.PropertyHolder
ch.bailu.gtk.type.Interface
ch.bailu.gtk.gio.TlsClientConnection
Alle implementierten Schnittstellen:
PointerInterface
public class TlsClientConnection extends Interface
`GTlsClientConnection` is the client-side subclass of
[class@Gio.TlsConnection], representing a client-side TLS connection.

https://docs.gtk.org/gio/iface.TlsClientConnection.html

  • Konstruktordetails

  • Methodendetails

    • getClassHandler

      public static ClassHandler getClassHandler()

    • copySessionState

      public void copySessionState(@Nonnull TlsClientConnection source)
      Possibly copies session state from one connection to another, for use
      in TLS session resumption. This is not normally needed, but may be
      used when the same session needs to be used between different
      endpoints, as is required by some protocols, such as FTP over TLS.
      @source should have already completed a handshake and, since TLS 1.3,
      it should have been used to read data at least once. @conn should not
      have completed a handshake.

      It is not possible to know whether a call to this function will
      actually do anything. Because session resumption is normally used
      only for performance benefit, the TLS backend might not implement
      this function. Even if implemented, it may not actually succeed in
      allowing @conn to resume @source's TLS session, because the server
      may not have sent a session resumption token to @source, or it may
      refuse to accept the token from @conn. There is no way to know
      whether a call to this function is actually successful.

      Using this function is not required to benefit from session
      resumption. If the TLS backend supports session resumption, the
      session will be resumed automatically if it is possible to do so
      without weakening the privacy guarantees normally provided by TLS,
      without need to call this function. For example, with TLS 1.3,
      a session ticket will be automatically copied from any
      #GTlsClientConnection that has previously received session tickets
      from the server, provided a ticket is available that has not
      previously been used for session resumption, since session ticket
      reuse would be a privacy weakness. Using this function causes the
      ticket to be copied without regard for privacy considerations.
      Parameter:
      source - a #GTlsClientConnection

    • getAcceptedCas

      public List getAcceptedCas()
      Gets the list of distinguished names of the Certificate Authorities
      that the server will accept certificates from. This will be set
      during the TLS handshake if the server requests a certificate.
      Otherwise, it will be %NULL.

      Each item in the list is a #GByteArray which contains the complete
      subject DN of the certificate authority.
      Gibt zurück:
      the list of CA DNs. You should unref each element with g_byte_array_unref() and then the free the list with g_list_free().

    • getServerIdentity

      public SocketConnectable getServerIdentity()
      Gets @conn's expected server identity
      Gibt zurück:
      a #GSocketConnectable describing the expected server identity, or %NULL if the expected identity is not known.

    • getUseSsl3

      @Deprecated public boolean getUseSsl3()
      Veraltet.
      SSL 3.0 is no longer supported. See
      g_tls_client_connection_set_use_ssl3() for details.
      Gibt zurück:
      %FALSE

    • getValidationFlags

      @Deprecated public int getValidationFlags()
      Veraltet.
      Gets @conn's validation flags

      This function does not work as originally designed and is impossible
      to use correctly. See #GTlsClientConnection:validation-flags for more
      information.
      Gibt zurück:
      the validation flags

    • setServerIdentity

      public void setServerIdentity(@Nonnull SocketConnectable identity)
      Sets @conn's expected server identity, which is used both to tell
      servers on virtual hosts which certificate to present, and also
      to let @conn know what name to look for in the certificate when
      performing %G_TLS_CERTIFICATE_BAD_IDENTITY validation, if enabled.
      Parameter:
      identity - a #GSocketConnectable describing the expected server identity

    • setUseSsl3

      @Deprecated public void setUseSsl3(boolean use_ssl3)
      Veraltet.
      Since GLib 2.42.1, SSL 3.0 is no longer supported.

      From GLib 2.42.1 through GLib 2.62, this function could be used to
      force use of TLS 1.0, the lowest-supported TLS protocol version at
      the time. In the past, this was needed to connect to broken TLS
      servers that exhibited protocol version intolerance. Such servers
      are no longer common, and using TLS 1.0 is no longer considered
      acceptable.

      Since GLib 2.64, this function does nothing.
      Parameter:
      use_ssl3 - a #gboolean, ignored

    • setValidationFlags

      @Deprecated public void setValidationFlags(int flags)
      Veraltet.
      Sets @conn's validation flags, to override the default set of
      checks performed when validating a server certificate. By default,
      %G_TLS_CERTIFICATE_VALIDATE_ALL is used.

      This function does not work as originally designed and is impossible
      to use correctly. See #GTlsClientConnection:validation-flags for more
      information.
      Parameter:
      flags - the #GTlsCertificateFlags to use

    • _new

      public static TlsClientConnection _new(@Nonnull IOStream base_io_stream, @Nullable SocketConnectable server_identity) throws AllocationError
      Creates a new #GTlsClientConnection wrapping @base_io_stream (which
      must have pollable input and output streams) which is assumed to
      communicate with the server identified by @server_identity.

      See the documentation for #GTlsConnection:base-io-stream for restrictions
      on when application code can run operations on the @base_io_stream after
      this function has returned.
      Parameter:
      base_io_stream - the #GIOStream to wrap
      server_identity - the expected identity of the server
      Gibt zurück:
      the new #GTlsClientConnection, or %NULL on error
      Löst aus:
      AllocationError

    • getTypeID

      public static long getTypeID()

    • getParentTypeID

      public static long getParentTypeID()

    • getTypeSize

      public static TypeSystem.TypeSize getTypeSize()

    • getParentTypeSize

      public static TypeSystem.TypeSize getParentTypeSize()

    • getInstanceSize

      public static int getInstanceSize()