TlsConnection

---

Object Hierarchy:

Description:

Content:

Properties:

• public IOStream base_io_stream { construct; owned get; }
  The IOStream that the connection wraps
• public TlsCertificate certificate { set; get; }
  The connection's certificate; see set_certificate.
• public TlsDatabase database { set; get; }
  The certificate database to use when verifying this TLS connection.
• public TlsInteraction interaction { set; get; }
  A TlsInteraction object to be used when the connection or certificate database need to interact with the user.
• public TlsCertificate peer_certificate { get; }
  The connection's peer's certificate, after the TLS handshake has completed and the certificate has been accepted.
• public TlsCertificateFlags peer_certificate_errors { get; }
  The errors noticed-and-ignored while verifying peer_certificate.
• public TlsRehandshakeMode rehandshake_mode { construct set; get; }
  The rehandshaking mode.
• public bool require_close_notify { construct set; get; }
  Whether or not proper TLS close notification is required.
• public bool use_system_certdb { construct set; get; }
  Whether or not the system certificate database will be used to verify peer certificates.

Creation methods:

• protected TlsConnection ()

Methods:

• public bool emit_accept_certificate (TlsCertificate peer_cert, TlsCertificateFlags errors)
  Used by TlsConnection implementations to emit the accept_certificate signal.
• public weak TlsCertificate get_certificate ()
  Gets this's certificate, as set by set_certificate.
• public weak TlsDatabase get_database ()
  Gets the certificate database that this uses to verify peer certificates.
• public weak TlsInteraction get_interaction ()
  Get the object that will be used to interact with the user.
• public weak TlsCertificate get_peer_certificate ()
  Gets this's peer's certificate after the handshake has completed.
• public TlsCertificateFlags get_peer_certificate_errors ()
  Gets the errors associated with validating this's peer's certificate, after the handshake has completed.
• public TlsRehandshakeMode get_rehandshake_mode ()
  Gets this rehandshaking mode.
• public bool get_require_close_notify ()
  Tests whether or not this expects a proper TLS close notification when the connection is closed.
• public bool get_use_system_certdb ()
  Gets whether this uses the system certificate database to verify peer certificates.
• public virtual bool handshake (Cancellable? cancellable = null) throws Error
  Attempts a TLS handshake on this.
• public virtual async bool handshake_async (int io_priority = DEFAULT, Cancellable? cancellable = null) throws Error
  Asynchronously performs a TLS handshake on this.
• public void set_certificate (TlsCertificate certificate)
  This sets the certificate that this will present to its peer during the TLS handshake.
• public void set_database (TlsDatabase database)
  Sets the certificate database that is used to verify peer certificates.
• public void set_interaction (TlsInteraction? interaction)
  Set the object that will be used to interact with the user.
• public void set_rehandshake_mode (TlsRehandshakeMode mode)
  Sets how this behaves with respect to rehandshaking requests.
• public void set_require_close_notify (bool require_close_notify)
  Sets whether or not this expects a proper TLS close notification before the connection is closed.
• public void set_use_system_certdb (bool use_system_certdb)
  Sets whether this uses the system certificate database to verify peer certificates.

Signals:

• public virtual signal bool accept_certificate (TlsCertificate peer_cert, TlsCertificateFlags errors)
  Emitted during the TLS handshake after the peer certificate has been received.

Inherited Members: