Class
SecretItem
Description [src]
class Secret.Item : Gio.DBusProxy {
parent_instance: GDBusProxy
}A secret item
SecretItem represents a secret item stored in the Secret Service.
Each item has a value, represented by a SecretValue, which can be
retrieved by secret_item_get_secret() or set by secret_item_set_secret().
The item is only available when the item is not locked.
Items can be locked or unlocked using the secret_service_lock() or
secret_service_unlock() functions. The Secret Service may not be able to
unlock individual items, and may unlock an entire collection when a single
item is unlocked.
Each item has a set of attributes, which are used to locate the item later.
These are not stored or transferred in a secure manner. Each attribute has
a string name and a string value. Use secret_service_search() to search for
items based on their attributes, and secret_item_set_attributes() to change
the attributes associated with an item.
Items can be created with secret_item_create() or secret_service_store().
Stability: Stable
Constructors
secret_item_new_for_dbus_path_finish
Finish asynchronous operation to get a new item proxy for a secret item in the secret service.
Functions
secret_item_load_secrets_finish
Complete asynchronous operation to load the secret values for secret items stored in the service.
Instance methods
secret_item_get_flags
Get the flags representing what features of the SecretItem proxy
have been initialized.
secret_item_get_schema_name
Gets the name of the schema that this item was stored with. This is also
available at the xdg:schema attribute.
secret_item_load_secret_finish
Complete asynchronous operation to load the secret value of this item.
Methods inherited from GDBusProxy (19)
g_dbus_proxy_call
Asynchronously invokes the method_name method on proxy.
unstable since: 2.26
g_dbus_proxy_call_finish
Finishes an operation started with g_dbus_proxy_call().
unstable since: 2.26
g_dbus_proxy_call_sync
Synchronously invokes the method_name method on proxy.
unstable since: 2.26
g_dbus_proxy_call_with_unix_fd_list
Like g_dbus_proxy_call() but also takes a GUnixFDList object.
unstable since: 2.30
g_dbus_proxy_call_with_unix_fd_list_finish
Finishes an operation started with g_dbus_proxy_call_with_unix_fd_list().
unstable since: 2.30
g_dbus_proxy_call_with_unix_fd_list_sync
Like g_dbus_proxy_call_sync() but also takes and returns GUnixFDList objects.
unstable since: 2.30
g_dbus_proxy_get_cached_property
Looks up the value for a property from the cache. This call does no blocking IO.
unstable since: 2.26
g_dbus_proxy_get_cached_property_names
Gets the names of all cached properties on proxy.
unstable since: 2.26
g_dbus_proxy_get_connection
Gets the connection proxy is for.
unstable since: 2.26
g_dbus_proxy_get_default_timeout
Gets the timeout to use if -1 (specifying default timeout) is
passed as timeout_msec in the g_dbus_proxy_call() and
g_dbus_proxy_call_sync() functions.
unstable since: 2.26
g_dbus_proxy_get_flags
Gets the flags that proxy was constructed with.
unstable since: 2.26
g_dbus_proxy_get_interface_info
Returns the GDBusInterfaceInfo, if any, specifying the interface
that proxy conforms to. See the GDBusProxy:g-interface-info
property for more details.
unstable since: 2.26
g_dbus_proxy_get_interface_name
Gets the D-Bus interface name proxy is for.
unstable since: 2.26
g_dbus_proxy_get_name
Gets the name that proxy was constructed for.
unstable since: 2.26
g_dbus_proxy_get_name_owner
The unique name that owns the name that proxy is for or NULL if
no-one currently owns that name. You may connect to the
GObject::notify signal to track changes to the
GDBusProxy:g-name-owner property.
unstable since: 2.26
g_dbus_proxy_get_object_path
Gets the object path proxy is for.
unstable since: 2.26
g_dbus_proxy_set_cached_property
If value is not NULL, sets the cached value for the property with
name property_name to the value in value.
unstable since: 2.26
g_dbus_proxy_set_default_timeout
Sets the timeout to use if -1 (specifying default timeout) is
passed as timeout_msec in the g_dbus_proxy_call() and
g_dbus_proxy_call_sync() functions.
unstable since: 2.26
g_dbus_proxy_set_interface_info
Ensure that interactions with proxy conform to the given
interface. See the GDBusProxy:g-interface-info property for more details.
unstable since: 2.26
Methods inherited from GAsyncInitable (3)
g_async_initable_init_async
Starts asynchronous initialization of the object implementing the
interface. This must be done before any real use of the object after
initial construction. If the object also implements GInitable you can
optionally call g_initable_init() instead.
unstable since: 2.22
g_async_initable_init_finish
Finishes asynchronous initialization and returns the result. See g_async_initable_init_async().
unstable since: 2.22
g_async_initable_new_finish
Finishes the async construction for the various g_async_initable_new
calls, returning the created object or NULL on error.
unstable since: 2.22
Methods inherited from GDBusInterface (4)
g_dbus_interface_dup_object
Gets the GDBusObject that interface_ belongs to, if any.
unstable since: 2.32
g_dbus_interface_get_info
Gets D-Bus introspection information for the D-Bus interface
implemented by interface_.
unstable since: 2.30
g_dbus_interface_get_object
Gets the GDBusObject that interface_ belongs to, if any.
unstable since: 2.30
g_dbus_interface_set_object
Sets the GDBusObject for interface_ to object.
unstable since: 2.30
Methods inherited from GInitable (1)
Methods inherited from SecretRetrievable (7)
secret_retrievable_get_attributes
Get the attributes of this object.
since: 0.19.0
secret_retrievable_get_created
Get the created date and time of the object.
since: 0.19.0
secret_retrievable_get_label
Get the label of this item.
since: 0.19.0
secret_retrievable_get_modified
Get the modified date and time of the object.
since: 0.19.0
secret_retrievable_retrieve_secret
Retrieve the secret value of this object.
since: 0.19.0
secret_retrievable_retrieve_secret_finish
Complete asynchronous operation to retrieve the secret value of this object.
since: 0.19.0
secret_retrievable_retrieve_secret_sync
Retrieve the secret value of this object synchronously.
since: 0.19.0
Properties
Secret.Item:service
The SecretService object that this item is associated with and
uses to interact with the actual D-Bus Secret Service.
Properties inherited from GDBusProxy (9)
Gio.DBusProxy:g-bus-type
If this property is not G_BUS_TYPE_NONE, then
GDBusProxy:g-connection must be NULL and will be set to the
GDBusConnection obtained by calling g_bus_get() with the value
of this property.
unstable since: 2.26
Gio.DBusProxy:g-connection
The GDBusConnection the proxy is for.
unstable since: 2.26
Gio.DBusProxy:g-default-timeout
The timeout to use if -1 (specifying default timeout) is passed
as timeout_msec in the g_dbus_proxy_call() and
g_dbus_proxy_call_sync() functions.
unstable since: 2.26
Gio.DBusProxy:g-flags
Flags from the GDBusProxyFlags enumeration.
unstable since: 2.26
Gio.DBusProxy:g-interface-info
Ensure that interactions with this proxy conform to the given
interface. This is mainly to ensure that malformed data received
from the other peer is ignored. The given GDBusInterfaceInfo is
said to be the “expected interface”.
unstable since: 2.26
Gio.DBusProxy:g-interface-name
The D-Bus interface name the proxy is for.
unstable since: 2.26
Gio.DBusProxy:g-name
The well-known or unique name that the proxy is for.
unstable since: 2.26
Gio.DBusProxy:g-name-owner
The unique name that owns GDBusProxy:g-name or NULL if no-one
currently owns that name. You may connect to GObject::notify signal to
track changes to this property.
unstable since: 2.26
Gio.DBusProxy:g-object-path
The object path the proxy is for.
unstable since: 2.26
Properties inherited from SecretRetrievable (4)
SecretRetrievable:attributes
The attributes set on this item.
since: 0.19.0
SecretRetrievable:created
The date and time (in seconds since the UNIX epoch) that this item was created.
since: 0.19.0
SecretRetrievable:label
The human readable label for the item.
since: 0.19.0
SecretRetrievable:modified
The date and time (in seconds since the UNIX epoch) that this item was last modified.
since: 0.19.0
Signals
Signals inherited from GDBusProxy (2)
GDBusProxy::g-properties-changed
Emitted when one or more D-Bus properties on proxy changes. The
local cache has already been updated when this signal fires. Note
that both changed_properties and invalidated_properties are
guaranteed to never be NULL (either may be empty though).
unstable since: 2.26
GDBusProxy::g-signal
Emitted when a signal from the remote object and interface that proxy is for, has been received.
unstable since: 2.26
Signals inherited from GObject (1)
GObject::notify
The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.