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.
secret_item_new_for_dbus_path_sync
Get a new item proxy for a secret item in the secret service.
Functions
secret_item_create
Create a new item in the secret service.
secret_item_create_finish
Finish operation to create a new item in the secret service.
secret_item_create_sync
Create a new item in the secret service.
secret_item_load_secrets
Load the secret values for a secret item stored in the service.
secret_item_load_secrets_finish
Complete asynchronous operation to load the secret values for secret items stored in the service.
secret_item_load_secrets_sync
Load the secret values for a secret item stored in the service.
secret_item_new_for_dbus_path
Get a new item proxy for a secret item in the secret service.
Instance methods
secret_item_delete
Delete this item.
secret_item_delete_finish
Complete asynchronous operation to delete the secret item.
secret_item_delete_sync
Delete this secret item.
secret_item_get_attributes
Set the attributes of this item.
secret_item_get_created
Get the created date and time of the item.
secret_item_get_flags
Get the flags representing what features of the SecretItem
proxy
have been initialized.
secret_item_get_label
Get the label of this item.
secret_item_get_locked
Get whether the item is locked or not.
secret_item_get_modified
Get the modified date and time of the item.
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_get_secret
Get the secret value of this item.
secret_item_get_service
Get the Secret Service object that this item was created with.
secret_item_load_secret
Load the secret value of this item.
secret_item_load_secret_finish
Complete asynchronous operation to load the secret value of this item.
secret_item_load_secret_sync
Load the secret value of this item.
secret_item_refresh
Refresh the properties on this item.
secret_item_set_attributes
Set the attributes of this item.
secret_item_set_attributes_finish
Complete operation to set the attributes of this item.
secret_item_set_attributes_sync
Set the attributes of this item.
secret_item_set_label
Set the label of this item.
secret_item_set_label_finish
Complete asynchronous operation to set the label of this collection.
secret_item_set_label_sync
Set the label of this item.
secret_item_set_secret
Set the secret value of this item.
secret_item_set_secret_finish
Complete asynchronous operation to set the secret value of this item.
secret_item_set_secret_sync
Set the secret value of this item.
Methods inherited from GDBusProxy (19)
g_dbus_proxy_call
Asynchronously invokes the method_name
method on proxy
.
Available since: 2.26
g_dbus_proxy_call_finish
Finishes an operation started with g_dbus_proxy_call().
Available since: 2.26
g_dbus_proxy_call_sync
Synchronously invokes the method_name
method on proxy
.
Available since: 2.26
g_dbus_proxy_call_with_unix_fd_list
Like g_dbus_proxy_call()
but also takes a GUnixFDList
object.
Available 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().
Available 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.
Available 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.
Available since: 2.26
g_dbus_proxy_get_cached_property_names
Gets the names of all cached properties on proxy
.
Available since: 2.26
g_dbus_proxy_get_connection
Gets the connection proxy
is for.
Available 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.
Available since: 2.26
g_dbus_proxy_get_flags
Gets the flags that proxy
was constructed with.
Available 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.
Available since: 2.26
g_dbus_proxy_get_interface_name
Gets the D-Bus interface name proxy
is for.
Available since: 2.26
g_dbus_proxy_get_name
Gets the name that proxy
was constructed for.
Available 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.
Available since: 2.26
g_dbus_proxy_get_object_path
Gets the object path proxy
is for.
Available 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
.
Available 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.
Available 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.
Available 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.
Available since: 2.22
g_async_initable_init_finish
Finishes asynchronous initialization and returns the result. See g_async_initable_init_async().
Available 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.
Available since: 2.22
Methods inherited from GDBusInterface (4)
g_dbus_interface_dup_object
Gets the GDBusObject
that interface_
belongs to, if any.
Available since: 2.32
g_dbus_interface_get_info
Gets D-Bus introspection information for the D-Bus interface
implemented by interface_
.
Available since: 2.30
g_dbus_interface_get_object
Gets the GDBusObject
that interface_
belongs to, if any.
Available since: 2.30
g_dbus_interface_set_object
Sets the GDBusObject
for interface_
to object
.
Available since: 2.30
Methods inherited from GInitable (1)
Methods inherited from SecretRetrievable (7)
secret_retrievable_get_attributes
Get the attributes of this object.
Available since: 0.19.0
secret_retrievable_get_created
Get the created date and time of the object.
Available since: 0.19.0
secret_retrievable_get_label
Get the label of this item.
Available since: 0.19.0
secret_retrievable_get_modified
Get the modified date and time of the object.
Available since: 0.19.0
secret_retrievable_retrieve_secret
Retrieve the secret value of this object.
Available since: 0.19.0
secret_retrievable_retrieve_secret_finish
Complete asynchronous operation to retrieve the secret value of this object.
Available since: 0.19.0
secret_retrievable_retrieve_secret_sync
Retrieve the secret value of this object synchronously.
Available since: 0.19.0
Properties
Secret.Item:flags
A set of flags describing which parts of the secret item have been initialized.
Secret.Item:locked
Whether the item is locked or not.
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.
Available since: 2.26
Gio.DBusProxy:g-connection
The GDBusConnection
the proxy is for.
Available 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.
Available since: 2.26
Gio.DBusProxy:g-flags
Flags from the GDBusProxyFlags
enumeration.
Available 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”.
Available since: 2.26
Gio.DBusProxy:g-interface-name
The D-Bus interface name the proxy is for.
Available since: 2.26
Gio.DBusProxy:g-name
The well-known or unique name that the proxy is for.
Available 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.
Available since: 2.26
Gio.DBusProxy:g-object-path
The object path the proxy is for.
Available since: 2.26
Properties inherited from SecretRetrievable (4)
Secret.Retrievable:attributes
The attributes set on this item.
Available since: 0.19.0
Secret.Retrievable:created
The date and time (in seconds since the UNIX epoch) that this item was created.
Available since: 0.19.0
Secret.Retrievable:label
The human readable label for the item.
Available since: 0.19.0
Secret.Retrievable:modified
The date and time (in seconds since the UNIX epoch) that this item was last modified.
Available since: 0.19.0
Signals
Signals inherited from GDBusProxy (2)
Gio.DBusProxy::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).
Available since: 2.26
Gio.DBusProxy::g-signal
Emitted when a signal from the remote object and interface that proxy
is for, has been received.
Available since: 2.26
Signals inherited from GObject (1)
GObject.Object::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.