类别

GioTlsCertificate

自 2.28 起

描述 [src]

abstract class Gio.TlsCertificate : GObject.Object
{
  priv: GTlsCertificatePrivate*
}

用于 TLS 身份验证和加密的证书。它既可以表示单独的证书（例如，客户端从服务器接收的证书），也可以表示证书和私钥的组合（当充当 GTlsServerConnection 时，需要这个组合）。

自 2.28 起可用

父类

GObject

构造函数

g_tls_certificate_new_from_file

根据 file 中的数据创建一个 GTlsCertificate。

自 2.28 起

g_tls_certificate_new_from_file_with_password

根据 file 中的数据创建一个 GTlsCertificate。

自 2.72 起

g_tls_certificate_new_from_files

从 cert_file 和 key_file 中的 PEM 编码数据创建 GTlsCertificate。返回的证书将是 cert_file 中找到的第一张证书。从 GLib 2.44 开始，如果 cert_file 包含多张证书，它将尝试加载一个证书链。所有证书都将按照找到的顺序进行验证（顶级证书应该是文件中最后一个证书），并根据验证成功情况设置每个证书的 GTlsCertificate:issuer 属性。如果链中的任何证书都不能验证，仍然将返回文件中的第一张证书。

自 2.28 起

g_tls_certificate_new_from_pem

从 data 中的 PEM 编码数据创建 GTlsCertificate。如果 data 包括证书和私钥，则返回的证书也将包括私钥数据。（有关支持的格式的信息，请参阅 GTlsCertificate:private-key-pem 属性）。

自 2.28 起

g_tls_certificate_new_from_pkcs11_uris

从 PKCS #11 URI 创建 GTlsCertificate。

自 2.68 起生效

g_tls_certificate_new_from_pkcs12

从 data 中的数据创建 GTlsCertificate。它必须包含证书和匹配的私钥。

自 2.72 起

函数

g_tls_certificate_list_new_from_file

从 file 中的 PEM 编码数据创建一或多个 GTlsCertificates。如果无法读取或解析 file，该函数将返回 NULL 并设置 error。如果 file 不包含任何 PEM 编码证书，这将返回一个空列表，而不会设置 error。

自 2.28 起

实例方法

g_tls_certificate_get_dns_names

获取 GTlsCertificate:dns-names 的值。

自 2.70 起生效

g_tls_certificate_get_ip_addresses

获取 GTlsCertificate:ip-addresses 的值。

自 2.70 起生效

g_tls_certificate_get_issuer

获取表示 cert 颁发者的 GTlsCertificate，如果已知的话。

自 2.28 起

g_tls_certificate_get_issuer_name

从证书返回颁发者名称。

自 2.70 起生效

g_tls_certificate_get_not_valid_after

返回证书失效或将失效的时间。

自 2.70 起生效

g_tls_certificate_get_not_valid_before

返回证书生效或将生效的时间。

自 2.70 起生效

g_tls_certificate_get_subject_name

从证书返回主题名称。

自 2.70 起生效

g_tls_certificate_is_same

检查两个 GTlsCertificate 对象是否表示同一证书。将检查两个证书的原始 DER 字节数据的相等性。这会产生这样的效果：即使它们的 GTlsCertificate:issuer、GTlsCertificate:private-key 或 GTlsCertificate:private-key-pem 属性不同，两个证书也可能进行比较。

自 2.34 起生效

g_tls_certificate_verify

这将验证 cert 并返回一组 GTlsCertificateFlags，指示在其中发现的任何问题。这可用于在连接的环境外验证证书，或针对不属于系统 CA 数据库的 CA 检查证书。

自 2.28 起

从 GObject（43）继承的方法

有关方法的完整列表，请参阅 GObject。

信号

从 GObject (1) 继承的信号

GObject::notify

当通过 g_object_set_property()、g_object_set() 等方式设置一个对象的一个属性值时，notify 信号将在该对象上发送。

类结构

struct GioTlsCertificateClass {
  GObjectClass parent_class;
  GTlsCertificateFlags (* verify) (
    GTlsCertificate* cert,
    GSocketConnectable* identity,
    GTlsCertificate* trusted_ca
  );
  
}

无可用描述。

类成员

parent_class: GObjectClass: 无可用描述。
verify: GTlsCertificateFlags (* verify) ( GTlsCertificate* cert, GSocketConnectable* identity, GTlsCertificate* trusted_ca ): 无可用描述。

虚拟方法

Gio.TlsCertificateClass.verify

这将验证 cert 并返回一组 GTlsCertificateFlags，指示在其中发现的任何问题。这可用于在连接的环境外验证证书，或针对不属于系统 CA 数据库的 CA 检查证书。

自 2.28 起