Interface org.freedesktop.Telepathy.Channel.Type.CertificateVerification.DRAFT

Interface Index (Compact) | Summary | Description | Methods | Signals | Properties | Types

Methods

GetCertificate () o: Certificate
SendCertificate (s: Certificate) nothing

Signals

StateChanged (u: State)

Properties

State u (Verification_State) Read only
RequestedIdentity s Read only
Resource o Read only

Types

Verification_State Enum u
WARNING: This interface is experimental and is likely to cause havoc to your API/ABI if bindings are generated. Do not include this interface in libraries that care about compatibility.
Objects implementing this interface must also implement:

Description

A channel type for verifying remote certificates and sending local certificates.

This is an anonymous channel when dealing with server verification. It would have a contact handle (or list id?), when dealing with E2E sessions.

If the channel is closed at any pre-verified state, the behavior returns to the legacy non-interactive CM verification. When a ChannelDispatcher is arbitrating, and no known handlers exist, it will close this channel, and thus current clients would function properly.

Methods

(Permalink)

GetCertificate () → o: Certificate

Returns

This would return a SSLCertVerification if it is available, otherwise return a null object path.
(Permalink)

SendCertificate (s: Certificate) → nothing

Parameters

  • Certificate — s
  • A PEM encoded certificate.
This method sends a certificate to the remote peer. The certificate should match the identity that was requested in RequestedIdentity.

Signals

(Permalink)

StateChanged (u: State)

Parameters

The state of the channel has changed, a good path for accepting a remote certificate or sending one.

Properties

Accessed using the org.freedesktop.DBus.Properties interface.
(Permalink)

State — u (Verification_State)

Read only
Indicates what stage of the verification we are in.
(Permalink)

RequestedIdentity — s

Read only
The identity for which a local certificate must be supplied.
(Permalink)

Resource — o

Read only
The object path for the resource we wish to verify, for example a Connection or a Channel.

Types

Enum (Permalink)

Verification_State — u

  • None (0)
  • Awaiting remote certificate or response
  • Accept_Certificate (1)
  • Waiting for client to accept remote certificate
  • Certificate_Requested (2)
  • Waiting for client to send client certificate
  • Verified (3)
  • Verification is complete
  • Failed (4)
  • Failed to verify