Back to Seed Clases

Gio

Classes

Interfaces

Structs

Unions

Enums

GObject.Object
parent-child marker Gio.TlsCertificate

Class Gio.TlsCertificate

Import line:	Gio = imports.gi.Gio;
GIR File:	Gio-2.0.gir
C documentation:	GTlsCertificate
Class :	TlsCertificate
Extends:	GObject.Object

A certificate used for TLS authentication and encryption.
This can represent either a public key only (eg, the certificate
received by a client from a server), or the combination of
a public key and a private key (which is needed when acting as a
GTlsServerConnection).

Properties
Properties		Defined By
	certificate : Array The DER (binary) encoded representation of the certificate's public key. The DER (binary) encoded representation of the certificate's public key. This property and the GTlsCertificate:certificate-pem property represent the same data, just in different forms.	Gio.TlsCertificate
	certificate_pem : String The PEM (ASCII) encoded representation of the certificate's public key. The PEM (ASCII) encoded representation of the certificate's public key. This property and the GTlsCertificate:certificate property represent the same data, just in different forms.	Gio.TlsCertificate
	issuer : Gio.TlsCertificate A GTlsCertificate representing the entity that issued this certificate. A GTlsCertificate representing the entity that issued this certificate. If NULL, this means that the certificate is either self-signed, or else the certificate of the issuer is not available.	Gio.TlsCertificate
	parent_instance : GObject.Object read only	Gio.TlsCertificate
	priv : Gio.TlsCertificatePrivate read only	Gio.TlsCertificate
	private_key : Array The DER (binary) encoded representation of the certificate's private key. The DER (binary) encoded representation of the certificate's private key. This property (or the GTlsCertificate:private-key-pem property) can be set when constructing a key (eg, from a file), but cannot be read.	Gio.TlsCertificate
	private_key_pem : String The PEM (ASCII) encoded representation of the certificate's private key. The PEM (ASCII) encoded representation of the certificate's private key. This property (or the GTlsCertificate:private-key property) can be set when constructing a key (eg, from a file), but cannot be read.	Gio.TlsCertificate

Methods / Constructors
Method / Constructor		Defined By
	new Gio.TlsCertificate (Object *properties) Create a new Gio.TlsCertificate Create a new Gio.TlsCertificate Parameters: Object properties*
	new Gio.TlsCertificate.from_file (String *file) : Gio.TlsCertificate Create a new Gio.TlsCertificate Create a new Gio.TlsCertificate Parameters: String file* Required (not null) file containing a PEM-encoded certificate to import Returns: Gio.TlsCertificate the new certificate, or NULL on error
	new Gio.TlsCertificate.from_files (String *cert_file, String key_file) : Gio.TlsCertificate Create a new Gio.TlsCertificate Create a new Gio.TlsCertificate Parameters: String cert_file* Required (not null) file containing a PEM-encoded certificate to import String key_file Required (not null) file containing a PEM-encoded private key to import Returns: Gio.TlsCertificate the new certificate, or NULL on error
	new Gio.TlsCertificate.from_pem (String *data, gint32 length) : Gio.TlsCertificate Create a new Gio.TlsCertificate Create a new Gio.TlsCertificate Parameters: String data* Required (not null) PEM-encoded certificate data gint32 length Required (not null) the length of data, or -1 if it's 0-terminated. Returns: Gio.TlsCertificate the new certificate, or NULL if data is invalid
	Gio.TlsCertificate.list_new_from_file (String *file) : Array Creates one or more GTlsCertificates from the PEM-encoded data in file. Creates one or more GTlsCertificates from the PEM-encoded data in file. If file* cannot be read or parsed, the function will return NULL and set error. If file does not contain any PEM-encoded certificates, this will return an empty list and not set error. GList containing GTlsCertificate objects. You must free the list and its contents when you are done with it. Parameters: String file Required (not null) file containing PEM-encoded certificates to import Returns: Array a	Gio.TlsCertificate
	get_issuer () : Gio.TlsCertificate Gets the GTlsCertificate representing cert's issuer, if known or NULL if cert is self-signed or signed with an unknown certificate. Gets the GTlsCertificate representing cert's issuer, if known or NULL if cert is self-signed or signed with an unknown certificate. Returns: Gio.TlsCertificate The certificate of cert's issuer,	Gio.TlsCertificate
	verify (SocketConnectable *identity, TlsCertificate trusted_ca) : Gio.TlsCertificateFlags This verifies cert* and returns a set of GTlsCertificateFlags indicating any problems found with it. This verifies cert and returns a set of GTlsCertificateFlags indicating any problems found with it. This can be used to verify a certificate outside the context of making a connection, or to check a certificate against a CA that is not part of the system CA database. If identity is not NULL, cert's name(s) will be compared against it, and G_TLS_CERTIFICATE_BAD_IDENTITY will be set in the return value if it does not match. If identity is NULL, that bit will never be set in the return value. If trusted_ca is not NULL, then cert (or one of the certificates in its chain) must be signed by it, or else G_TLS_CERTIFICATE_UNKNOWN_CA will be set in the return value. If value. (All other GTlsCertificateFlags values will always be set or unset as appropriate.) Parameters: Gio.SocketConnectable identity the expected peer identity Gio.TlsCertificate trusted_ca the certificate of a trusted authority Returns: Gio.TlsCertificateFlags the appropriate GTlsCertificateFlags	Gio.TlsCertificate

Events
None

Used by These Methods / Signals / Properties
Class / Namespace	Method / Signal / Properties
Gio.TlsCertificate Property	issuer : Gio.TlsCertificate A GTlsCertificate representing the entity that issued this certificate.
Gio.TlsConnection Property	certificate : Gio.TlsCertificate The connection's certificate; see g_tls_connection_set_certificate().
Gio.TlsConnection Property	peer_certificate : Gio.TlsCertificate read only The connection's peer's certificate, after the TLS handshake has completed and the certificate has been accepted.
Gio.TlsConnection Signal	accept_certificate (TlsConnection *self, TlsCertificate peer_cert, TlsCertificateFlags errors*) : gboolean Emitted during the TLS handshake after the peer certificate has been received.
Gio.TlsConnection Method	emit_accept_certificate (TlsCertificate *peer_cert, TlsCertificateFlags errors) : gboolean Used by GTlsConnection* implementations to emit the GTlsConnection::accept-certificate signal.
Gio.TlsConnection Method	get_certificate () : Gio.TlsCertificate Gets conn's certificate, as set by g_tls_connection_set_certificate().
Gio.TlsConnection Method	get_peer_certificate () : Gio.TlsCertificate Gets conn's peer's certificate after the handshake has completed.
Gio.TlsConnection Method	set_certificate (TlsCertificate *certificate) : none This sets the certificate that conn* will present to its peer during the TLS handshake.
Soup.Message Property	tls_certificate : Gio.TlsCertificate
Soup.Socket Property	tls_certificate : Gio.TlsCertificate read only