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

Ancestors

  • GDBusProxy
  • GObject

Implements

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
GDBusProxyClass
 

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.