Gcr.SecretExchange – gcr-3 – Vala Binding Reference

Description:

[ CCode ( type_id = "gcr_secret_exchange_get_type ()" ) ]
public class SecretExchange : Object

Allows exchange of secrets between two processes on the same system without exposing those secrets to things like loggers, non-pageable memory etc.

This does not protect against active attacks like MITM attacks.

Each side creates a secret exchange object, and one of the sides calls [[email protected]]. This creates a string, which should be passed to the other side. Each side passes the strings it receives into [[email protected]].

In order to send a reply (either with or without a secret) use [[email protected]]. A side must have successfully called [ [email protected]] before it can use [[email protected]].

The secret exchange objects can be used for multiple iterations of the conversation, or for just one request/reply. The only limitation being that the initial request cannot contain a secret.

Caveat: Information about the approximate length (rounded up to the nearest 16 bytes) may be leaked. If this is considered inacceptable, do not use [class@SecretExchange].

Namespace: Gcr

Package: gcr-3

Content:

Properties:

public string protocol { get; construct; }

The protocol being used for the exchange.

Creation methods:

public SecretExchange (string? protocol)

Create a new secret exchange object.

Methods:

public string begin ()

Begin the secret exchange.

public virtual bool derive_transport_key (uint8 peer, size_t n_peer)

public virtual bool generate_exchange_key (string scheme, uint8 public_key, size_t n_public_key)

public unowned string get_protocol ()

Will return null if no protocol was specified, and either [method@SecretExchange.

public unowned string[] get_secret ()

Returns the last secret received.

public bool receive (string exchange)

Receive a string from the other side of secret exchange.

public string send (string? secret, ssize_t secret_len)

Send a reply to the other side of the secret exchange, optionally sending a secret.

Inherited Members:

All known members inherited from class GLib.Object

@get
@new
@ref
@set
add_toggle_ref
add_weak_pointer
bind_property
connect
constructed
disconnect
dispose
dup_data
dup_qdata
force_floating
freeze_notify
get_class
get_data

get_property
get_qdata
get_type
getv
interface_find_property
interface_install_property
interface_list_properties
is_floating
new_valist
new_with_properties
newv
notify
notify_property
ref_count
ref_sink
remove_toggle_ref
remove_weak_pointer

replace_data
replace_qdata
set_data
set_data_full
set_property
set_qdata
set_qdata_full
set_valist
setv
steal_data
steal_qdata
thaw_notify
unref
watch_closure
weak_ref
weak_unref