diff options
| author | Stef Walter <stef@memberwebs.com> | 2009-12-11 21:57:59 +0000 |
|---|---|---|
| committer | Stef Walter <stefw@collabora.co.uk> | 2010-12-04 16:11:42 +0000 |
| commit | e94829fd5ec3a23ffeda13cd56ec14d5b2eceb3d (patch) | |
| tree | 05517bdb50a41aa1e66a9dff63dbce630cc9f947 | |
| parent | 9b0a610bda7d6b99fa2f61bb77493c671eb1fb41 (diff) | |
| download | xdg-specs-e94829fd5ec3a23ffeda13cd56ec14d5b2eceb3d.tar.xz | |
Support for collection aliases.
The collection aliases are present under:
/org/freedesktop/secrets/aliases/xxxx
So the default and network collections would be usable via
the object path, in addition to their normal object paths:
/org/freedesktop/secrets/aliases/default
/org/freedesktop/secrets/aliases/network
To manage the aliases, two new methods are added to the
Service interface: ReadAlias() and SetAlias(). BTW, These
are not properties on Collection because a collection can
be have multiple aliases pointing to it.
| -rw-r--r-- | secret-service/org.freedesktop.Secrets.xml | 26 | ||||
| -rw-r--r-- | secret-service/specification.xml | 11 |
2 files changed, 24 insertions, 13 deletions
diff --git a/secret-service/org.freedesktop.Secrets.xml b/secret-service/org.freedesktop.Secrets.xml index a681d79..73c275b 100644 --- a/secret-service/org.freedesktop.Secrets.xml +++ b/secret-service/org.freedesktop.Secrets.xml @@ -83,12 +83,6 @@ <tp:docstring>The object paths of all collections (ie: keyrings)</tp:docstring> </property> - <property name="DefaultCollection" type="o" access="readwrite"> - <tp:docstring> - The object path of the default collection, or an empty string if no collections exist. - </tp:docstring> - </property> - <method name="OpenSession"> <tp:docstring>Open a unique session for the caller application.</tp:docstring> <arg name="algorithm" type="s" direction="in"> @@ -170,6 +164,26 @@ </arg> </method> + <method name="ReadAlias"> + <tp:docstring>Get the collection with the given alias.</tp:docstring> + <arg name="name" type='s' direction='in'> + <tp:docstring>An alias, such as 'default'.</tp:docstring> + </arg> + <arg name="collection" type='o' direction='out'> + <tp:docstring>The collection or the the path '/' if no such collection exists.</tp:docstring> + </arg> + </method> + + <method name="SetAlias"> + <tp:docstring>Setup a collection alias.</tp:docstring> + <arg name="name" type='s' direction='in'> + <tp:docstring>An alias, such as 'default'.</tp:docstring> + </arg> + <arg name="collection" type='o' direction='in'> + <tp:docstring>The collection.</tp:docstring> + </arg> + </method> + <signal name="CollectionCreated"> <tp:docstring>A collection was created.</tp:docstring> <arg name="collection" type="o"> diff --git a/secret-service/specification.xml b/secret-service/specification.xml index f305cbe..2902232 100644 --- a/secret-service/specification.xml +++ b/secret-service/specification.xml @@ -109,11 +109,7 @@ error should be raised.</para> <para>Client applications without special requirements should store in the default - collection. Use the - <link linkend='org.freedesktop.Secret.Service.DefaultCollection'> - <property>DefaultCollection</property></link> - property on the Service interface to determine the default collection. In addition - the default collection is always accessible through a + collection. The default collection is always accessible through a <link linkend='object-paths'>specific object path</link>.</para> <para>A new item can be created with the @@ -485,9 +481,10 @@ <para>The object path for a session, where <emphasis>ssss</emphasis> is an auto-generated session specific identifier.</para> - <programlisting>/org/freedesktop/secrets/default</programlisting> + <programlisting>/org/freedesktop/secrets/aliases/default</programlisting> <para>The default collection for client applications to store secrets is available under - this object path in addition to its real object path (above).</para> + this object path in addition to its real object path (above). Other aliases may also be + present.</para> </chapter> <xi:include href="reference.xml" xpointer="interfaces" xmlns:xi="http://www.w3.org/2001/XInclude"> |