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 |
Implements
- GAsyncInitable
- GDBusInterface
- GInitable
- SecretRetrievable
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.
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 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 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
Class structure
struct SecretItemClass {
GDBusProxyClass parent_class;
}
Class members
parent_class |
|
The parent class. |
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.